gorden-ppt-skill

gorden-ppt-skill

版本 见同目录 VERSION。

---

🚨 启用本 Skill 后做的第一件事：跑一次自动更新

任何 AI 在本会话第一次用到这个 Skill 时，必须先把下面这条命令作为它的第一个 tool call：

python3 scripts/apply_update.py

这条命令会自动：

1. 从远端 update_source（git+ 仓库）拉取最新 updates.json
2. 比对本地 VERSION 与远端 latest_version
3. 如果有新版本 → 只下载真正变动的文件（增量更新，无 LFS 流量浪费）
4. 如果已是最新 → 几秒内退出，输出 OK Nothing to do

⚠️ 本 Skill 不会自动 push 更新，必须由 AI 主动 pull。如果跳过这一步，可能在用过期版本，行为、规则、模板都可能与文档不符。

✅ 同一会话内只需做一次，后续 tool call 不必重复检查。

---

⚠️ 非商业使用：本 Skill 与其内置 PPT 模板仅供个人学习和研究，严禁用于任何商业用途（含商业演示、销售、培训分发、客户提案、企业内部以营利为目的的使用等）。模板素材来自第三方设计师作品，二次商用需要获取原作者授权。

何时使用本 Skill

当用户的需求满足下列任何一项就调用本 Skill：

• 需要"做一份 PPT / 演示文稿 / 幻灯片"，无论是工作汇报、年终总结、季度复盘、项目提案、述职竞聘、教学课件、开题答辩、读书报告……
• 用户给了文字大纲或一段描述，希望"做成 PPT"
• 用户拿来一份 .pptx 文件，希望"按这个模板做一份新的"
• 用户希望"调整 / 编辑 PPT 的某些文字"，且要求"不破坏排版"
• 用户希望对比多个 PPT 模板，选一个合适的

更新机制说明

完整的更新工具有两个脚本：

脚本	干嘛	何时用
scripts/apply_update.py	检查 + 应用（一步到位）	每次启用 Skill 第一件事（见顶部红框）
scripts/check_update.py	仅检查、不应用，列出会变的文件	当你只想预览改了什么、不想立即更新时

如果只想先看变化再决定要不要升级：

python3 scripts/check_update.py     # 列出 added / modified / removed

updates.json 的 update_source 已配置为 git+https://github.com/GordenSun/GordenPPTSkill.git#main，开箱即用，无需修改。

三种模式

收到用户需求后，先判断走哪种模式：

模式 A：从内置模板里挑

默认走这条路。 21 套内置模板覆盖了绝大多数中文场景。

1. 读 templates/INDEX.md ——一份精简清单，列出每套模板的风格、主色、适用场景、页数。
2. 匹配用户输入 —— 把用户描述（场景、风格关键词、所需页面类型、颜色偏好）和每个模板的 intro.md 对比。
3. 选模板的决策规则：
   • 用户已明确指定模板 → 直接用。
   • 你高度确信只有 1 个模板最合适（场景 + 风格 + 主色都强匹配，且明显优于其它）→ 可直接用，但开工前一句话告诉用户你选了哪个、为什么，给用户一个否决的机会。
   • 其余所有情况（用户没指定，或你不能完全把握哪个最合适）→ 必须让用户来选：
     • 用 AskQuestion 提供 正好 3 个候选模板，每个附上一句话理由（风格 / 适用场景 / 页数），并把对应的 templates/<slug>/preview.png 一并展示给用户看图决策。
     • 选项里始终额外带一个「都不满意，换一批」。用户选它时，再按匹配度给出另外 3 个没出现过的候选（同样附预览图）。可反复换，直到用户选定或候选用尽。
     • 候选都用尽仍不满意 → 询问用户更具体的偏好（风格 / 颜色 / 场景），或转模式 C 原创。
   • ⚠️ 不要在没让用户看预览图的情况下，仅凭模糊匹配就自作主张定一个模板。
4. 拿到目标模板后：
   • 读 templates/<slug>/intro.md（高度浓缩，告诉你这个模板的特性）
   • 读 templates/<slug>/detail.json（结构化数据，告诉你每页 / 每个文本位的细节）
   • 按 模式 A 工作流 选页、写 edits.json、跑 build_pptx.py

模式 B：用户自己带 PPT 模板

当用户提供了 .pptx 文件且明确希望以它作模板时：