메뉴
格式化 EPUB 文学结构，包括章首、卷首、题记、题献、版权页、对话、诗、信件块、文白对照条目和场景分隔。用于小说、散文或古籍 EPUB 需要语义 XHTML 与阅读器安全 CSS 润色，但不改写正文时。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | epub-literary-structure-formatter |
| description | 格式化 EPUB 文学结构，包括章首、卷首、题记、题献、版权页、对话、诗、信件块、文白对照条目和场景分隔。用于小说、散文或古籍 EPUB 需要语义 XHTML 与阅读器安全 CSS 润色，但不改写正文时。 |
这个 skill 处理 prose presentation 和书籍组成部分结构。它不负责弹注、图片环绕或 A-lite 海报骨架。
使用语义 XHTML 加 literary.css 类：
section / header 和少量章首类。figure.chapter-head-art 小章标或 figure.chapter-head-banner 满栏横幅 + 真实 h1，规则见 docs/how-to/chapter-head-image.md。epub:type。section，每组直接放原文段落和白话段落；默认上下，短组只在宽屏 min-width 增强中用双侧 float。默认文白使用 38/58；原译接近可加 .parallel-ratio-balanced 使用 48/48；原文较长可加 .parallel-ratio-source-wide 使用 58/38；单书自定义比例两栏总和建议不超过 96%。长组和 Kindle 窄屏用 .parallel-stack-pair 保持上下。不用 table、flex、grid 或固定版式，规则见 docs/how-to/classical-modern-layout.md。epub-english-typography-optimizer；本 skill 只处理章首、题记、诗、信件等结构。(•) 回目录点按 docs/how-to/anthology-navigation.md，并由 epub-package-nav-auditor 同步 nav/NCX。章首：
<section class="chapter-head" epub:type="chapter">
<header>
<p class="chapter-kicker">第一章</p>
<h1>标题</h1>
<p class="chapter-subtitle">副标题</p>
</header>
<blockquote class="epigraph">
<p>题记文字。</p>
</blockquote>
</section>
前置页：
<section class="frontmatter copyright-page" epub:type="frontmatter copyright-page">
<h1>版权信息</h1>
<p>版权文字。</p>
</section>
诗：
<div class="poetry" epub:type="z3998:poem">
<p>第一行<br/>第二行</p>
</div>
literary.css。chapter-head、chapter-head-art、chapter-head-banner、chapter-kicker、chapter-subtitle、epigraphdialog、poetry、letter、scene-breakclassical-modern、parallel-entry、parallel-pair、parallel-float-pair、parallel-ratio-balanced、parallel-ratio-source-wide、parallel-stack-pair、parallel-clear、classical-text、modern-textcopyright-page、dedication、epigraph-pageliterary.css。base.css。Text/15-frontmatter.xhtmlText/18-english-fiction.xhtmlText/20-chapter-head-image.xhtmlText/21-classical-modern.xhtml运行：
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。
用于 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 安全规则时。