realfamousfrog-pixel/ppt-image-workflow 使用教程：状态文件和阶段门禁

realfamousfrog-pixel/ppt-image-workflow 用状态文件和阶段门禁管理纯图片 PPT 项目。 这是一个 Codex skill，用来管理纯图片学术 PPT 的多阶段工作流：初始化项目、同步材料、结构文档、视觉方案、初版图、逐页精修和风格沉淀。

它解决的核心麻烦，是长周期图片 PPT 项目很容易在多轮对话里丢掉风格、阶段和页面状态。仓库用 ppt-workflow/ 目录、workflow-current.md、style-pack 和人工审阅停顿，把“现在做到哪一步、下一步能不能进入、当前页有没有完成”变成可检查的文件状态。

workflow-current 是项目状态入口

每次显式调用这个 skill，都要先在当前项目根目录查找 ppt-workflow/。如果不存在，而且表达的是初始化，就从 assets/project-skeleton/ppt-workflow/ 复制骨架；如果不存在却想继续项目，就应该提示尚未建立 workflow。

初始化后的核心目录包括 materials/、structure/、style-pack/、initial-pages/、accepted-pages/、prompts/ 和 workflow-current.md。项目私有素材、参考页、背景图源和页面产物都应放在目标项目自己的 ppt-workflow/，不要写回 skill 仓库。

使用 $ppt-image-workflow 初始化当前项目
使用 $ppt-image-workflow 同步材料
使用 $ppt-image-workflow 继续当前项目

workflow-current.md 至少记录当前阶段、输入状态、各阶段状态、当前风格包路径、第 5 步当前页、当前页状态、允许进入的阶段和下一步建议。跳步时以它为准，而不是凭记忆继续。

审阅停顿是固定流程

这个 workflow 固定了阶段顺序。第 1 步结构文档生成后要停，人工审阅通过才能进入第 2 步视觉方案；第 2 步视觉方案生成后也要停，审阅通过后才能由第 3 步并入风格包。

第 4 步初版图生成还有额外约束：即使前置条件满足，当前消息也必须显式写出“使用 sub-agent 并行生成”。缺少这层授权时，skill 应拦截，而不是自动降级成顺序执行。

使用 $ppt-image-workflow 进入第2步视觉方案
使用 $ppt-image-workflow 进入第4步，并使用 sub-agent 并行生成

这些停顿会让周期变长，但能避免纯图片 PPT 常见的失控：结构没审完就出图，视觉方案没定就批量生成，或者长对话里越做越偏。

第 5 步有更严格的完成标准

逐页精修不是“修完图就结束”。第 5 步要按页推进：先接手当前页，等待具体修改意见；图面确认后，请求沉淀 prompt；沉淀执行并确认后，才能把当前页标为完成。

页面闭环要同时满足三件事：采纳图进入 accepted-pages/，同图进入 style-pack/settled-pages/，页级结论写入 style-pack/style-guide.md。少任何一项，都不要把当前页状态写成 completed。

这个设计的意义在于，后续页面还能继续借用已经采纳的风格经验。纯图片 PPT 的后期改动成本很高，如果不把每页经验沉淀回 style-pack，下一页很容易重复踩同一个版式或质感问题。

什么时候适合用它

ppt-image-workflow 更适合学术型、建筑型或视觉要求高的纯图片 PPT 项目：有参考页、有背景图源、有项目文字和图表素材，需要一批整图页面，并且制作周期可能跨多个对话。

它不追求快。README 也把代价讲得很清楚：文字清晰度弱于可编辑排版，制作时间更长，后期修改常要回到图面层处理。把它当作 workflow 管理器会很有用；把它当作一次性自动出图器，就会在阶段门禁和人工审阅处反复撞墙。

安装入口和输出检查

安装时把仓库放入本机 Codex skills 目录，例如：

git clone https://github.com/realfamousfrog-pixel/ppt-image-workflow.git ~/.codex/skills/ppt-image-workflow

项目跑起来后，检查的不是单个 PPT 文件，而是整套 ppt-workflow/ 状态：材料是否同步，结构文档是否生成并审阅，视觉方案是否正式并入，初版图是否在 initial-pages/，采纳页是否完成双归档，style-guide.md 是否有页级沉淀。

这套工作流的价值不在于少点几步，而在于让每一步都有文件证据。只要状态文件、审阅停顿和双归档都守住，跨对话继续纯图片 PPT 项目时就不容易丢方向。