菜单
Use when 输入是 EPUB2、Kindle/MOBI 回转或其他 legacy EPUB，需要迁移 package/nav、XHTML shell、弹注和基础排版到 EPUB3，同时必须保留正文和原文件时。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| 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
用于 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 安全规则时。