القائمة
幻灯片设计与制作的方案。当需要做汇报、设计演示文稿、或将论文转成 slides 时使用。适用于"做个汇报""做 slides""做幻灯片""写个 deck""设计演示文稿""把论文做成 slides"。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Claude Code 专用：将 arXiv/DOI/PDF 学术论文整理为论文翻译飞书文档，正文以原文逐段中文翻译为主体。
单文件 HTML 幻灯片（Han Xiao 式固定舞台 deck）的制作方案。当需要做网页版 slides、HTML 幻灯片、会议演讲 deck、或希望用浏览器直接放映且导出 PDF 的演示文稿时使用。触发词："HTML slides""网页幻灯片""单文件 deck""hanxiao 风格 slides""做个网页版演讲稿"。
Codex 专用：将 arXiv/DOI/PDF 学术论文整理为论文翻译飞书文档，正文以原文逐段中文翻译为主体。
飞书/Lark 全功能操作方案。当需要发消息、管理日程/会议室、操作云文档/多维表格/电子表格/知识库、处理任务/邮件/OKR/考勤/审批，或进行视频会议时使用。
将学术论文、论文 PDF、arXiv/DOI、或 lark-paper-reader-codex 生成的飞书论文读书文档整理成一份有用的飞书 Slides/PPT。用于把一篇或几篇论文变成可讲述、可复习、可分享的演示文稿，重点是提炼主线、选择论文原图、讲清方法、实验结果、insight 和局限；触发语境包括：把论文做成 PPT、做一份 paper slides、把这些 reader 文档整理成演示文稿、做文献汇报 slides、把同主题论文用 PPT 呈现。
统一处理所有 skills 操作的总控 skill，包括搜索、导入、创建、重构、编辑、优化、上游跟踪、分发、归档与发布。当涉及到 SKILL 的编辑修改新建时，请用 skill-manager 来管理！
| name | rhetoric-of-decks |
| description | 幻灯片设计与制作的方案。当需要做汇报、设计演示文稿、或将论文转成 slides 时使用。适用于"做个汇报""做 slides""做幻灯片""写个 deck""设计演示文稿""把论文做成 slides"。 |
幻灯片设计与生成的实操指南。核心来源：Scott Cunningham 的 Rhetoric of Decks 哲学。
读完所有标题的人应该能理解你的整个论点。
| ❌ 弱标题 | ✅ 强标题 |
|---|---|
| "结果" | "处理组平均增加 61 英里" |
| "文献综述" | "已有工作忽略了供给侧边际" |
| "方法" | "我们利用县级诊所关闭的变异进行识别" |
| "数据分析" | "用户留存在第 7 天出现断崖式下跌" |
最优 deck 使每张 slide 的「边际收益/边际成本」相等：
审查方法：逐张问"再加一个元素，收益能覆盖认知成本吗？再删一个，损失大于清晰度提升吗？"
空白不是浪费。满屏内容暗示恐惧——怕漏掉什么。留白暗示你知道什么重要。
列表往往意味着你没找到信息之间的结构。问自己：
例外：真正平行的条目（公理列表、定理条件）适合用 bullet。
| 幕 | 作用 | 做什么 |
|---|---|---|
| 第一幕：问题 | 制造张力 | 建立现状 → 引入挑战/问题 → 让观众感受痛点 |
| 第二幕：探索 | 推进论证 | 你做了什么 → 发现了什么 → 构建逻辑链 |
| 第三幕：解答 | 释放张力 | 核心洞察 → 意义/影响 → 行动呼吁 |
先说结论，再给证据。观众不是悬疑小说读者。
✅ 正确顺序：结论 → 支撑证据 → 为什么重要 ❌ 错误顺序：背景 → 更多背景 → 分析 → 终于到了结论
教学例外：当教学目标是让学生理解推理过程（而非结论），可以逐步推导再揭示结果。
开场（第一张内容 slide 最重要，60 秒内决定观众是否注意）：
结尾（最后一张 slide 决定他们记住什么）：
在 Q&A 之前主动展示最强反驳：
"有人会质疑：[最强反对意见]" "这个质疑合理，因为 [为什么合理]" "我们这样回应：[你的应对]"
效果：建立可信度（ethos）+ 预防性回答 + 展示严谨思考。
开始制作前先确认受众类型，再选择对应风格：
\pause（Beamer）或 fragment（RevealJS）如需配色方案，参见 references/palettes.md。
适合：数学密集、需要精确排版控制、传统学术场景。
详见 references/beamer-template.md。
适合：HTML 交互、嵌入代码输出、在线分享。
详见 references/revealjs-template.md。
每次编辑 .tex 或 .qmd 后，必须执行以下验证。不通过则不算完成。
# Beamer（推荐 XeLaTeX 用于中文）
xelatex -interaction=nonstopmode deck.tex
# 或通过 Overleaf
bash ol.sh compile "项目名" --compiler xelatex
grep "^!" deck.log
有任何输出 → 修复后重新编译。
grep -cE "Overfull|Underfull" deck.log
必须返回 0。对每个警告：
| 警告 | 修复方法 |
|---|---|
| Overfull hbox | 缩短文字、用 \adjustbox、表格加 @{} |
| Underfull hbox | 调整段落换行 |
| Overfull vbox | 拆分 slide、减少 \vspace、压缩内容 |
| Underfull vbox | 加 \vfill 或调整间距 |
即使只溢出 0.5pt 也必须修复。
grep -i "font" deck.log | grep -i "warning"
TikZ 错误不会触发编译警告，必须手动检查。详见 references/tikz-rules.md。
按顺序执行四轮 Pass：
above/below/left/right无 TikZ 内容时跳过。
此步骤默认跳过，仅在用户明确要求时启用（如「帮我看看视觉效果」「用视觉检查」「开启视觉审查」）。
启用后，先将 PDF 转为图片，再为每一页 slide 调用 pi-subagent 的 figure-qa agent。
# Convert PDF to slide images
pdftoppm -jpeg -jpegopt quality=85 -r 150 deck.pdf /tmp/deck-review/slide
为什么是 150 DPI JPEG：figure-qa 会在内部压缩图片，150 DPI JPEG 已足够清晰且体积较小。
调用方式详见 pi-subagent/agents/figure-qa.md，每页使用以下参数：
Scene: slides
Intent: <slide title or content description>
Extra: This is slide N of a presentation deck. Topic: <deck topic>.
Check for: text overflow, readability at distance, layout balance, color contrast.
figure-qa 会自动检查以下问题：
| 检查项 | 具体内容 |
|---|---|
| 文字溢出 | 文字是否被截断、超出 slide 边界 |
| TikZ 碰撞 | 节点/箭头/label 是否重叠 |
| 布局均衡 | 内容是否居中、留白是否合理 |
| 字号一致性 | 同级元素字号是否统一 |
| 颜色一致性 | 跨 slide 相同角色颜色是否一致 |
| 可读性 | 后排观众能否读清 |
| MB/MC 均衡 | 是否有 slide 明显过载或过空 |
汇总所有 slide 的检查结果：只要任意一页返回 ❌ REGENERATE，就必须回到 .tex 源文件修复问题，并从 Step 1 重新开始完整验证。只有全部 slide 通过后，才可继续交付用户。
编译 → 查错 → 查警告 → 查字体 → 查 TikZ → [可选] Agent 看图自审 → 交付用户
↑ |
└───────── 有问题则修复后重新开始 ←──────────────────────────────┘
全部通过后才可交付。
| 失败 | 修复 |
|---|---|
| 文字墙 | 提取关键短语，其余是讲稿 |
| 重点埋到第 15 张 | 第 2 张就说结论 |
| 图表垃圾（3D 柱状图等） | 删到不能再删为止 |
| 大纲 8-12 项 | 最多三节，或直接删掉大纲 |
| "Questions?" 结尾 | 用一句话要点结尾 |
| 无证据断言 | 每个主张配来源 |
| 装饰性图片 | 删掉，留白更好 |
| 焦虑性塞满 | 精简的 slide 迫使你掌握内容 |