dev

MacHu-GWU 的头像作者 MacHu-GWU

atlas_doc_parser 开发的维护者指南。在实现 ADF 标记/节点、了解代码库架构或编写测试时使用。

📖 中文导读:atlas_doc_parser 开发的维护者指南。在实现 ADF 标记/节点、了解代码库架构或编写测试时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: dev description: Maintainer guide for atlas_doc_parser development. Use when implementing ADF marks/nodes, understanding codebase architecture, or writing tests.

atlas_doc_parser Maintainer Guide

This skill provides guidance for developing and maintaining the atlas_doc_parser library.

Available Topics

Read the specific document when you need detailed information:

Topic Document When to Read
Overview 01-What-is-atlas-doc-parser Understanding project purpose and design philosophy
Three Sources 02-Cross-Referencing Learning about JSON schema, docs, and real Confluence pages
Base Classes 03-The-Base-Class Understanding Base, BaseMark, BaseNode, and markdown helpers
Implementation 04-Per-Mark-Node-Class Implementing a new mark or node dataclass
Testing 05-How-to-Test Writing tests for marks and nodes
Error Handling 06-Graceful-Handling-of-Unimplemented-Types How unimplemented types are handled gracefully

Quick Reference

  • Implement new mark/node: Read "Implementation" then "Testing"
  • Understand architecture: Read "Overview" then "Base Classes"
  • Debug parsing issues: Read "Three Sources" and "Error Handling"
  • adf-format-json-schema - Query ADF JSON schema definitions
  • adf-json-example - Fetch real ADF JSON from Confluence pages
  • implement-model - Automated implementation workflow