القائمة
优化 EPUB 图片版式、figure 环绕、图注、栅格格式、封面声明与阅读器兼容性。用于图片过小、裁切、Kindle 空白、图文环绕差、缺图注，或封面/海报图片处理需要 EPUB 安全规则时。
التثبيت باستخدام 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 的 Kindle/KDP 兼容风险，包括图片格式、封面 metadata、nav + NCX、MathML properties、CSS fallback、文字裁切、表格/代码溢出和转换日志 warning。用于 Kindle 交付前或 Kindle Previewer/App 与其他阅读器表现不一致时。
| name | epub-image-layout-optimizer |
| description | 优化 EPUB 图片版式、figure 环绕、图注、栅格格式、封面声明与阅读器兼容性。用于图片过小、裁切、Kindle 空白、图文环绕差、缺图注，或封面/海报图片处理需要 EPUB 安全规则时。 |
这个 skill 用于可重排 EPUB 正文中的图片。封面式全页海报布局使用 epub-alite-converter。
生产图片版式应使用：
figure 包裹浮动图片和图注。figure 上，不直接 float img。img { width: 100%; height: auto; }。左/右环绕：
<figure class="img-left">
<img src="../Images/example.png" alt="图示说明"/>
<figcaption>图注文字。</figcaption>
</figure>
.img-left {
float: left;
width: 30%;
margin: 0.2em 1em 0.6em 0;
}
.img-left img,
.img-right img {
display: block;
width: 100%;
height: auto;
}
机器判断入口是 scripts/epub_image_layout_advisor.py：它只读扫描 EPUB，列出逐图候选和可追溯风险，不直接修改文件。
media.css、base.css、OPF manifest 和图片资源；祖先为 .noteref-icon 或 a[epub:type~=noteref] 的图片是注释交互控件，必须排除，不生成 figure / 浮动 / 图注 / alt 候选。img 转成 figure.img-left 或 figure.img-right。
对尚未人工确认图文关系的插图，只规范为居中的 figure.illustration，不自动分配左/右浮动类；把候选写入决策记录，留待逐图 review。30% 起步；正式默认保持在 25% 到 35%，除非阅读器测试证明需要调整。media.css；通用 figure/img 默认写进 base.css。包封面应满足：
properties="cover-image"。<meta name="cover" content="..."/>，兼容 Kindle。图片压缩、色彩空间转换和有损质量参数不在本仓实现。本 skill 只负责：
如果用户要求压缩图片，先说明需要外部工具完成压缩，再把压缩后的资源带回本 skill 做 EPUB 结构与版式校验。
aspect-ratio 作为 EPUB 图片环绕主路径。em 宽度控制 figure float。Text/01-body.xhtml：基础 figure。Text/03c-poster-contain.xhtml：单图卷封 contain + fallback。Text/09-kindle-risk.xhtml：Kindle 图片风险页。Text/17-image-layout.xhtml：figure 环绕和大字号回归。运行：
sh templates/epub-style-demo/build.sh
scripts/validate-epub-style-demo.sh --epub templates/epub-style-demo/dist/<artifact>.epub
本 skill 默认 dry-run。直接调用只输出预期改动 JSON；加 --commit 才真正改。
代理协议示例（注释说明代理动作，不是独立 shell 命令）：
# 代理调用当前 skill，并将 dry-run JSON 写入 work/dry-run.json
# 人工审查
cat work/dry-run.json | jq
# 用户确认后，由映射 provider 写出新的 EPUB 产物
dry-run 输出格式见 docs/pipeline/cleanup-flow.md。