菜单
优化 EPUB 竖排、Ruby 注音、中西文混排方向和非海报竖排正文页。用于竖排文字横倒、裁切、Ruby 间距异常、或页面需要阅读器安全 vertical-rl CSS 但不能变成固定版式时。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | epub-vertical-ruby-optimizer |
| description | 优化 EPUB 竖排、Ruby 注音、中西文混排方向和非海报竖排正文页。用于竖排文字横倒、裁切、Ruby 间距异常、或页面需要阅读器安全 vertical-rl CSS 但不能变成固定版式时。 |
这个 skill 用于竖排正文页和 Ruby 行为。全页海报/A-lite 叠加文本使用 epub-alite-converter。
竖排正文页保持可重排：
body.page-vrl 标记页面。.vrl-section 承载竖排 writing context。writing-mode: vertical-rl 带 EPUB/WebKit 前缀 fallback。text-orientation 明确处理混排文字方向。ruby、rt、rp。body.page-vrl {
writing-mode: vertical-rl;
-webkit-writing-mode: vertical-rl;
-epub-writing-mode: vertical-rl;
}
.vrl-section {
writing-mode: vertical-rl;
-webkit-writing-mode: vertical-rl;
-epub-writing-mode: vertical-rl;
text-orientation: mixed;
-webkit-text-orientation: mixed;
-epub-text-orientation: mixed;
}
Ruby 保持语义：
<ruby>漢<rt>かん</rt><rp>（</rp><rt>かん</rt><rp>）</rp></ruby>
源文件已经有有效 rt 时，保留注音文本，不额外复制 fallback 可见文字。
.has-ruby 行距兜底放 base.css。body.page-vrl 和 vertical.css 中的 .vrl-section。text-combine-upright 只用于短数字或标记，并在确认阅读器支持后使用。body.page-vrl。rt 文本复制成额外可见正文。Text/02-ruby-note.xhtml：inline Ruby + notes。Text/10-text-effects.xhtml：Ruby + 文字效果。Text/14-vertical-body.xhtml：非海报竖排正文。Text/03-vertical-alite.xhtml：A-lite 对照；这个页面用 A-lite skill。运行：
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 安全规则时。