dev

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

$ 安裝

git clone https://github.com/MacHu-GWU/atlas_doc_parser-project /tmp/atlas_doc_parser-project && cp -r /tmp/atlas_doc_parser-project/.claude/skills/dev ~/.claude/skills/atlas_doc_parser-project

// tip: Run this command in your terminal to install the skill


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:

TopicDocumentWhen to Read
Overview01-What-is-atlas-doc-parserUnderstanding project purpose and design philosophy
Three Sources02-Cross-ReferencingLearning about JSON schema, docs, and real Confluence pages
Base Classes03-The-Base-ClassUnderstanding Base, BaseMark, BaseNode, and markdown helpers
Implementation04-Per-Mark-Node-ClassImplementing a new mark or node dataclass
Testing05-How-to-TestWriting tests for marks and nodes
Error Handling06-Graceful-Handling-of-Unimplemented-TypesHow 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"

Related Skills

  • adf-format-json-schema - Query ADF JSON schema definitions
  • adf-json-example - Fetch real ADF JSON from Confluence pages
  • implement-model - Automated implementation workflow