القائمة
维护 epub-style-demo 兼容 fixture、reader matrix、最终规则和验证循环。用于 EPUB 阅读器行为变化、需要新增 demo 覆盖、或需要把实测发现沉淀为最终生产规则时。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
用于 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 安全规则时。
| name | epub-style-demo-maintainer |
| description | 维护 epub-style-demo 兼容 fixture、reader matrix、最终规则和验证循环。用于 EPUB 阅读器行为变化、需要新增 demo 覆盖、或需要把实测发现沉淀为最终生产规则时。 |
当修改 templates/epub-style-demo/、新增阅读器兼容场景，或把阅读器发现转成最终 EPUB 生产规则时使用这个 skill。
templates/epub-style-demo/ 开始。新增或更新能暴露阅读器行为的最小 fixture。sh templates/epub-style-demo/build.sh
scripts/validate-epub-style-demo.sh --epub templates/epub-style-demo/dist/<artifact>.epub
scripts/validate-popup-notes.sh --epub templates/epub-style-demo/dist/<artifact>.epub
docs/final/reader-matrix.yaml。需要人工复测或版本待确认时使用 warn，不要虚构 pass/fail。docs/final/SPEC-实现约束.md，然后更新最终手册和速查表。skills/*/SKILL.md，但不要改变 frontmatter 字段名。权威弹注结构源是 docs/final/SPEC-实现约束.md §1；以下兼容规则不得单方面新增或改名同族 class。
figure.img-left / figure.img-right。float 和百分比 width 挂在 figure 上，先从 25% 到 35% 调整，再结合目标阅读器、视口和字号实测。aspect-ratio 作为主路径。真实图片通过 height:auto 保持宽高比，figure 也需要自然高度以承载图注。img float 不是主路径，因为部分阅读器会把图片渲染得过小。text-decoration: underline;，再写 text-decoration-style: wavy;。Kindle App fallback 为普通 underline。properties="mathml"。ol.footnote-list.duokan-footnote-content；单个 li.footnote-item 只加 duokan-footnote-item。.english-fiction，非虚构后续单独 fixture；英文正文必须声明 lang，使用短 serif 链，首段无缩进、后续段缩进，未验证断字时不强制 justify。figure，不把图文环绕作为 fiction 主路径；首字优先用 ::first-letter 保持正文单词完整，旧式 span 首字和 float drop cap 只作增强并需大字号复测。literary.css；头图只做装饰，标题必须是真实 h1。小章标保守宽度，满栏横幅用 width:100% 铺满正文内容栏并由源图比例控制高度。transform: rotate() 旋转便签块；Kindle Previewer 3.104（2026-05-23 实测）会触发 KFX 增强排版内部错误。需要斜角感时用不对称边框、圆角和投影模拟。提交前至少运行：
sh templates/epub-style-demo/build.sh
scripts/validate-epub-style-demo.sh --epub templates/epub-style-demo/dist/<artifact>.epub
scripts/validate-popup-notes.sh --epub templates/epub-style-demo/dist/<artifact>.epub
xmllint --noout templates/epub-style-demo/OEBPS/package.opf templates/epub-style-demo/OEBPS/nav.xhtml templates/epub-style-demo/OEBPS/toc.ncx
git diff --check
如果本机没有 xmllint，Python 验证脚本仍会用标准库解析 XML，并捕获 manifest/link/MathML 错误。