Menu
用于分析 EPUB、XHTML、HTML、Markdown 或纯文本中的结构角色，尤其是中文正文、标题、对话、诗歌、引文、书信、文白对照、注释等边界不清，需要给出字体角色与可重排排版建议时。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | epub-content-analyzer |
| description | 用于分析 EPUB、XHTML、HTML、Markdown 或纯文本中的结构角色，尤其是中文正文、标题、对话、诗歌、引文、书信、文白对照、注释等边界不清，需要给出字体角色与可重排排版建议时。 |
先用确定性报告建立证据，再结合上下文判断中文语义。分析阶段只读；低置信结论不得直接改写 XHTML。
已有 EPUB 先完成 preflight；加密、损坏或 OPF/container 异常时停止。
运行：
python3 scripts/epub_content_analyzer.py <input> --format json
仅在本地 work/<book>/reports/ 需要人工核对时加 --include-snippets；不把正文片段写入 records/。
按 evidence 和 confidence 复核候选角色：
epub:type、稳定 class 优先。review_required=true 或 primary_role=unknown 时读取前后段落和章节上下文；无法确定就保留原结构。
字体建议只使用角色：inherit、st、kt、fs、ht、en、mono、tszt-*。不要从角色建议推断某个字体文件一定覆盖字符。
人工确认后再分派写入能力：
epub-typography-optimizerepub-literary-structure-formatterepub-popup-footnote-converterepub-font-coverage-analyzer| 情况 | 行为 |
|---|---|
<h1>、figcaption、blockquote、footnote 语义明确 | 可采用高置信角色 |
| 短中文段落、无标点古文、仅含引号的段落 | 保留多个候选并人工复核 |
| 诗句和副标题外观相似 | 查章节位置、相邻段及现有 class，不按字数强判 |
| 文言与译文成对出现 | 先确认块级配对，再建议 st / kt 角色 |
| 普通正文 | 默认 inherit，不自动开启全书字体锁定 |
报告把 春风又绿江南岸 标为 unknown，候选含 body、verse、subtitle。应查看它是否位于诗歌容器、标题之后或正文叙述中；在缺少结构证据时不添加 class。
font_role=st 理解为必须嵌入某个宋体。python3 scripts/test_epub_content_analyzer.py
python3 scripts/validate_skills_basic.py
python3 scripts/validate_contracts.py
python3 scripts/validate_python_entrypoint_inventory.py
git diff --check
用于 EPUB 出现生僻字、方块字、跨阅读器字形不一致、Kindle 字体回退失败，或需要验证嵌入字体、子集字体和候选大字库是否覆盖全书字符时。
优化中文/CJK EPUB 排版，包括正文节奏、font-family 链、嵌入字体、生僻字 fallback、标题字体、中西文混排和阅读器安全段落间距。用于文字拥挤、裁切、跨阅读器字体不一致或字体规则需要清理时。
将 EPUB 封面式页面、卷首、章首或海报页转换为项目的 A-lite 可重排全页方案，同时保留原有图文叠加构图、文字、图片和资源。
重构和维护 EPUB CSS 分层。用于 CSS 规则重复、放错文件、层级边界不清，或新增正文、弹注、文字效果、文学结构、图片混排、竖排、A-lite 海报等样式时。
优化英文 EPUB 书籍排版，包括书籍类型判断、英语语言标记、serif 字体链、段落缩进、标题层级、插图、断字、引用/诗歌/信件、Kindle/Readest/Apple Books 大字号回归。用于英文小说、散文、非虚构或英文为主的 EPUB 需要形成可重排、可验证的排版方案时。
优化 EPUB 图片版式、figure 环绕、图注、栅格格式、封面声明与阅读器兼容性。用于图片过小、裁切、Kindle 空白、图文环绕差、缺图注，或封面/海报图片处理需要 EPUB 安全规则时。