Menu
Use when 输入是 EPUB2、Kindle/MOBI 回转或其他 legacy EPUB，需要迁移 package/nav、XHTML shell、弹注和基础排版到 EPUB3，同时必须保留正文和原文件时。
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.
用于 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 安全规则时。
Based on SOC occupation classification
| name | epub3-migrator |
| description | Use when 输入是 EPUB2、Kindle/MOBI 回转或其他 legacy EPUB，需要迁移 package/nav、XHTML shell、弹注和基础排版到 EPUB3，同时必须保留正文和原文件时。 |
执行“预检 → 计划 → 写出 → 红线 → 产物验证”。迁移只建立 EPUB3 基线，不替代后续文学结构、字体覆盖或阅读器实测。
保留 before 文件并运行：
python3 scripts/epub_preflight_harness.py book.epub --format json
DRM、未知加密、损坏 container/OPF 时停止。
生成只读迁移计划：
python3 scripts/epub3_migration_harness.py book.epub --format json
确认计划后写出新文件：
python3 scripts/epub3_migration_apply_harness.py book.epub \
--output book-epub3.epub --format json
harness 输出 before/after SHA-256 和底层 conversion report，并拒绝覆盖已有输出。
执行正文与包验证：
python3 scripts/validate_text_invariance.py book.epub book-epub3.epub --check all
scripts/validate-popup-notes.sh --epub book-epub3.epub
python3 scripts/epub_lint.py book-epub3.epub
人工检查 OPF/nav/NCX、封面、spine 和弹注 diff。需要字体、图片或结构精排时，再分派对应专项 skill。
dcterms:modified、manifest media/properties；nav.xhtml；--no-popup-notes 与 --no-typography 只在用户明确要求时使用。python3 scripts/test_epub3_migration_apply_harness.py
python3 scripts/test_epub3_oneclick_converter.py
python3 scripts/validate_skills_basic.py
git diff --check