解决的问题： 原始文章通常按阅读顺序写，演示稿却要按屏幕节奏组织。一个段落该变成结论页、对比页、流程页还是案例页，不能等生图时临时决定。

调用示例：

请使用 codex-ppt skill，把这篇技术文章做成 10 页左右的分享 PPT。先读取全文，给出逐页大纲、每页标题、要点、版式角色和需要保留的原图，等我确认后再继续。

输入： 文章、报告、论文、课程笔记或大纲，以及目标听众、页数和必须保留的内容。输出： 经确认的outline.md，里面写清每页标题、要点、版式角色和必需图片。不会自动发生： Skill 不会在大纲确认前自动创建最终的deck_spec.json、生图任务、页面图片或.pptx。

解决的问题： “科技感”“简洁”“像某份参考 PPT”都太宽泛。真正影响成品的是配色、字体、信息密度、版式节奏，以及当前环境到底能调用哪一种生图方式。

调用示例：

大纲确认了。请给出 3 个具体视觉方向，说明各自适合的场景；我选定后，再告诉我将使用的生图后端，并只生成第 3 页作为样张，等我批准。

输入： 已批准的大纲、品牌或参考图、希望的视觉方向，以及当前 Agent 能使用的图片工具。输出： 风格选择、后端选择和一张代表性样张。项目文档要求在首次生图前说明后端，确认后保持不变。不会自动发生： Skill 不会因为选定了一个风格就直接批量生成整套页面；样张获批后，才会进入批量生成。

解决的问题： 一套 PPT 往往有多页，每页的标题、重点和视觉关系不同。项目要求每一页最终图片都由已确认的生图后端生成；样张获批后，再把剩余页面拆成单页任务。

调用示例：

样张通过了。请按已确认的后端生成剩余页面，每页一个任务，保留同一套视觉风格，并记录每页的派发和生成结果。

输入： 已批准的大纲、风格、后端、样张和逐页提示词。输出：origin_image/slide_XX.png，以及记录任务状态的slide_jobs.json和slide_run_state.json。如果运行环境支持子 Agent，剩余页面会按一页一个子 Agent 的方式派发。不会自动发生： 生图后端确认后，Skill 不会自动改用另一种后端；遇到子 Agent、后端或其他必要条件不可用时，它会停在派发环节并报告阻塞。

解决的问题： 参考图不只是用来模仿风格的灵感图。论文曲线、实验柱状图、产品截图和 Logo 往往承担证据或识别功能，必须保留原始信息。

调用示例：

这两张图是论文结果图，必须原样出现在第 6 页和第 7 页。请在大纲中标明用途，生成时保留数据、坐标轴、标签和图例，不要重新绘制。

输入： 用户提供的图表、截图、Logo，以及可复用的风格参考。输出： 一份标明页码与资产对应关系的大纲；如果保存过个人风格，风格文件位于CODEX_PPT_HOME或~/.codex-ppt-skill/references/，与 Skill 安装目录分开，更新或重装 Skill 时不会丢失。不会自动发生： Skill 不会把这些必需资产当成只供参考的灵感素材，也不会自行决定它们的页码和用途；这些信息需要在大纲中明确。

解决的问题： 视觉页面只是演示的一部分。演讲者还需要一份按页编写的讲稿，最终文件也要按页码顺序组装。

调用示例：

请根据最终大纲为每页写中文演讲稿，使用 Slide N 标题；确认所有页面都已记录后，再把 origin_image 组装成 16:9 PPTX，并把演讲稿写入备注区。

输入： 已通过 QA 的origin_image/slide_XX.png、最终大纲和speech.md。输出：.pptx文件；assemble_ppt.py会把整页图片铺满空白幻灯片，并可把speech.md的内容写入对应的备注区。不会自动发生： Skill 组装出的 PPTX 不会把整页图片拆成可编辑的文本框、图表和形状。

解决的问题： 生成的页面容易出现文字模糊、标题被截断、信息溢出、风格漂移或元素重叠。项目把这些检查安排在组装前，并要求用脚本记录结果。

调用示例：

请逐页检查文字清晰度、内容是否对应大纲、是否有截断、溢出、重叠、意外页码和风格不一致；需要修复的页面重新生成，确认所有状态为 recorded 后再组装。

输入： 全部页面图片、已确认的大纲、样张和任务状态。输出： QA 结果、必要的修复页面，以及可追踪的派发和结果记录。不会自动发生： Skill 不会把组装脚本运行成功当作视觉质量合格；只要还有页面处于pending、dispatched或blocked状态，就不会标记整套 PPT 已完成。