菜单
Generates a valid DITA 1.3 bookmap template. Use this skill when you need a correctly structured starting point for a DITA bookmap with booktitle, bookmeta, frontmatter, chapter placeholders, appendix, and backmatter scaffolding. Output includes the correct DOCTYPE declaration.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Guides correct setup of pydita's DitaContext for a DITA processing pipeline. Use this skill when you need to wire together resolveMap(), KeyspaceManager, DitavalFilter, and DitaContext, or when a pipeline is failing because of incorrect initialisation order, missing DITA-OT configuration, or a mismatched errors dictionary.
Analyzes a DITA topic or map file for quality and maintainability issues beyond basic DTD validity. Use this skill after validate-dita-topic or validate-ditamap when you want to check shortdesc length, topic size, step count, nesting depth, conref chain problems, keyref-vs-href balance, duplicate content, and empty elements. Returns structured JSON with categorized findings.
Assists with DITAVAL conditional processing files for filtering and flagging DITA content at build time. Use this skill to validate an existing DITAVAL file, generate a new DITAVAL template from a list of conditions, or understand action priority and style-conflict resolution rules. Returns structured JSON for validation or XML output for generation.
Reference skill for pydita's error recording and reporting model. Use this skill when you need to understand how errors are accumulated in the shared errors dict, work with ErrorRecord and SEVERITY, filter errors by severity level, or produce a formatted error report using reportErrors(). Covers DitaContext.recordError() and Logger/ConsoleLogger helpers.
Generates a valid DITA 1.3 XML topic template for a given topic type. Use this skill when you need a correctly structured starting point for concept, task, reference, troubleshooting, glossentry, or base topic authoring. Output includes the correct DOCTYPE declaration, required elements, and commonly used optional elements pre-scaffolded.
Generates a valid DITA 1.3 map template. Use this skill when you need a correctly structured starting point for a DITA map with topicref placeholders, key definitions, and an optional relationship table. Output includes the correct DOCTYPE declaration.
| name | generate-bookmap |
| description | Generates a valid DITA 1.3 bookmap template. Use this skill when you need a correctly structured starting point for a DITA bookmap with booktitle, bookmeta, frontmatter, chapter placeholders, appendix, and backmatter scaffolding. Output includes the correct DOCTYPE declaration. |
| compatibility | Python 3.9+. No third-party dependencies. |
Generates a DITA 1.3 <bookmap> template from a title, ID, and optional chapter list.
python scripts/generate_bookmap.py "My Book Title" my-book-id
# Pre-fill chapters
python scripts/generate_bookmap.py "My Book Title" my-book-id \
--chapters chapter1.dita chapter2.dita chapter3.dita \
--appendix appendixA.dita
Well-formed XML to stdout including:
<?xml?> + <!DOCTYPE bookmap PUBLIC "-//OASIS//DTD DITA 1.3 BookMap//EN"><booktitle> with <mainbooktitle> and <booktitlealt> placeholder<bookmeta> with <publisherinformation> and <bookid> scaffolding<frontmatter> with <toc/>, <figurelist/>, <tablelist/><chapter> per --chapters argument (or two placeholders)<appendix> per --appendix argument (or one placeholder)<backmatter> with <indexlist/><part> grouping is not generated by default; add manually if needed<booktitlealt> is for subtitles; remove if not needed