Taffyreclaimed45/ppt-agent skill 使用教程：安装入口、首次小稿和输出目录

第一次装 Taffyreclaimed45/ppt-agent，最容易踩的坑不是少敲一个命令，而是一上来就让它做“某品牌发布会 15 页”。这个项目走的是多智能体 PPT 工作流：调研、素材收集、大纲审批、SVG 草稿、Gemini 审查、最终交付，中间还有多个 Hard Stop；小题没跑通，正式题只会把排查范围放大。

更稳的路径是把它当成一个 PPT workflow skill 来试：先装插件，再用一个 3 到 5 页的小需求跑入口，最后检查 openspec/changes// 下面有没有大纲、草稿、审查和交付文件。只要这条线清楚，后面再调 --style、--brand-colors 和 --pages 才有意义。

安装入口和仓库入口的区别

仓库名是 Taffyreclaimed45/ppt-agent，但 README 给出的安装方式走 Claude plugin marketplace。第一次安装可以按下面两步走，先把 marketplace 注册进来，再安装 ppt-agent 这个插件名。

claude plugin marketplace add zengwenliang416/ppt-agent
claude plugin install ppt-agent

装完后确认命令能触发，再考虑是否需要改仓库文件。这个项目的使用入口是 /ppt-agent:ppt，后面接主题或需求描述。命令能被识别，才说明插件入口已经接上；如果命令没有响应，可以检查 plugin 是否安装成功，以及宿主是否支持当前插件方式。

第一次运行建议用小题目

README 里展示过“收集新一代小米 SU7 发布会资料然后做一套 PPT”这种完整需求，效果也会按不同模型和宿主对比。但新手第一次不建议直接照着做大题，因为这个工作流会经历需求调研、素材收集、大纲规划、设计稿和审查循环，任何一段卡住都不好定位。

更合适的小题是这种：

/ppt-agent:ppt 做一套 3 页内部分享稿，主题是“团队周会如何同步项目风险”，风格用 business，运行默认流程。

这个输入足够小，仍然能触发大纲、草稿、设计稿和交付流程。跑到需要确认的地方就停下来读提示，不要为了省时间一路确认到底。ppt-agent 的价值正在这些停顿里：它不是只吐一堆幻灯片，而是让调研、大纲和审查都留下可回看文件。

输出目录和结果检查

跑完后不要只打开最终页面看好不好看。ppt-agent 的输出目录默认在 openspec/changes//，里面的 input.md、requirements.md、outline.json、drafts/、slides/ 和 output/index.html 能把一次运行拆开检查。下面这张图把第一次排查最该看的文件放到一起，方便按顺序扫一遍。

如果 outline.json 已经成形，但 slides/ 质量一般，问题多半在设计生成或审查阶段；如果 requirements.md 就很空，说明前面的需求输入太含糊。Gemini 不可用时，审查阶段会降级成技术校验，继续检查 XML、viewBox、字号、安全边距、对比度和样式 token，这时没有审美优化建议并不等于整次运行失败。

Taffyreclaimed45/ppt-agent 更适合先小范围跑通，再放大到正式题。入口能触发、Hard Stop 能读懂、openspec/changes// 里产物齐全，这三个信号比第一次就生成十几页更重要。等这条线稳定后，再去调品牌色、页数范围和风格预设，成稿会更可控。