Carl-Marks/consulting-diagnosis-ppt-skill 本地安装使用教程(新手)

先纠正一个容易误会的点：Carl-Marks/consulting-diagnosis-ppt-skill 不是把几句需求立刻变成精修 PPTX 的工具。它更像一套咨询现状诊断章节的工作流，帮你把一个业务域从访谈素材、业务问题、流程 KPI、系统支撑和协同问题，一步步推到 PPT 章节大纲。

真正适合它的场景是：你已经有采购、物流、生产等单域材料，想让 Claude Code 按阶段拆出分析素材和可交给 PPT 制作者的大纲。仓库公开的结构包括 SKILL.md、methodology/、templates/、checklists/ 和 examples/项目-物流域/；如果只是想找一套现成封面模板，它会显得太重。

最终交付的是诊断章节素材

跑完整个流程后，最值得检查的不是有没有漂亮动画，而是有没有形成三类东西：6 份阶段分析稿、1 份 PPT 章节大纲、1 组可送到跨域汇总的协同议题卡。这个边界很重要，因为它把“咨询诊断怎么分析”放在前面，把“PPT 怎么排版”放在后面。

每个阶段都有方法说明、模板、自检清单和物流域示例。新手第一次看仓库时，不要从 templates/ 随手挑一个表格就填，最好先从 methodology/stage-1-input.md 读起，再对照 examples/项目-物流域/ 看一遍成稿长什么样。这样做能避免把它误用成普通 PPT 模板库。

本地安装要确认 Claude Code 能读到它

如果使用 Claude Code，就把整个仓库放到项目的 .claude/skills/ 目录下。当前仓库地址是 https://github.com/Carl-Marks/consulting-diagnosis-ppt-skill，安装时建议按浏览器地址栏里的 owner/repo 克隆，避免 README 里旧命令和仓库名不一致时装到别的目录。

mkdir -p .claude/skills
cd .claude/skills
git clone https://github.com/Carl-Marks/consulting-diagnosis-ppt-skill.git consulting-diagnosis-ppt-skill

这个仓库本身没有把 API Key 当成主要配置项，重点是让 Claude Code 能读取 SKILL.md 和配套方法文件。装好后，先回到你的业务项目，再开一个很小的测试，不要直接把真实客户的全部访谈纪要丢进去。

第一次试跑，用一个业务域就够了

第一次触发时，最好把任务压到一个具体业务域。例如不要说“帮我做现状诊断报告”，而是说：

用 consulting-diagnosis-ppt 工作流做物流域的诊断章节。
先只跑 Stage 1 输入梳理，材料不足的地方标为待补充。

这个说法有两个好处：第一，仓库的 skill 规则本来就要求用户指明业务域；第二，每个 Stage 完成后应该停下来确认，不适合一口气跑完六段。你看到第一阶段输出后，先检查访谈材料、流程说明、系统清单是否被拆到合适的位置，再让它进入业务分析。

输出目录里的关键结果

如果流程跑顺，阶段稿里应该能看到具体业务问题、流程节点、KPI 口径、系统支撑情况和协同议题，而不是只有“效率低、流程乱、系统弱”这种空话。到第 6 阶段时，PPT 大纲应该按页给出结论、证据、视觉表达建议和数据出处，这才方便后面的人继续做成正式页面。

缺数据时也不用停工。这个 skill 的设计原则里保留了“待补充”的位置，先把能确定的判断写出来，后续拿到数据再回填。对咨询项目来说，这比为了完整性硬编数字更稳；对新手来说，也更容易看出自己到底缺访谈、缺流程图，还是缺系统字段。

什么时候不该把它当主工具

如果你的目标是做路演封面、销售型产品介绍、课堂课件排版，Carl-Marks/consulting-diagnosis-ppt-skill 不是最快路径。它最强的是“从单域现状材料到诊断章节逻辑”的整理能力，最后仍需要人把大纲转成公司模板里的正式 PPT 页面。

更稳的用法是：先用它跑一个小业务域，确认阶段稿、协同议题卡和 PPT 大纲都能对上你的项目材料，再扩大到采购、生产、财务等更多业务域。这样装一次 skill，不只是多了一个仓库，而是多了一条可反复复用的咨询诊断章节生产线。