关于 build-presentation
Presentation Skill Suite 的编排器,会读取项目状态并将工作导向下一个未完成阶段。它负责阶段排序和状态检查,各阶段任务由可独立调用的 Skill 执行。
主要功能
- 01路由至下一个未完成阶段
- 02检查项目状态和退出条件
- 03支持 Git 检查点协议
- 04为状态不明确或损坏提供恢复指引
适用场景
- 01确定演示文稿项目的下一步
- 02根据现有项目文件继续工作
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ ken-guru/ skills --skill build-presentation安装后在 Claude Code 中输入/build-presentation确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
EXIT_CRITERIA.mdGIT_CHECKPOINTS.mdROUTING.mdevals/build-presentation.json详细介绍
构建演示文稿(编排器)
通过根据 Project Folder 的状态路由到下一个有效操作,协调 Presentation Skill Suite。此编排器不包含各阶段的能力;每个 Phase Skill 仍可独立调用。
输出语气
对路由说明、决策摘要和完成报告进行轻量的自然表达润色。优先说明具体状态和后续操作,保留用户要求的语气,并确保 Project Folder 路径、命令和状态名称保持原样。所有演示文稿文案阶段都必须经过其规定的独立 unslop 润色。润色时必须采用 DISCOVERY.json 中记录的所有编辑偏好。
安装边界
安装此编排器时,必须同时安装完整的 Presentation Skill Suite。该套件的分发约定要求,安装后每个成员都能独立使用。
启动
- 确认 Project Folder 可读。
- 如果 Project Folder 存在,则要求其中包含
PROJECT.json,且projectType: "presentation"。 - 直接读取 Project Folder 的状态和指定的构件。
- 如果状态含糊或已损坏,报告问题并暂停变更操作。引导用户检查或修复 Project Folder。
如果 Project Folder 由 Git 管理,则在调用 Phase Skill 前,加载有条件适用的 Git 检查点协议。
路由接口
按以下顺序检测第一个未完成状态:
| 状态 | 条件 | 下一步操作 |
|---|---|---|
| 尚未开始 | 缺少 PROJECT.json | 提供 discover-presentation |
| Discovery 待处理 | Discovery 尚未完成 | 完成或重做 discover-presentation |
| Structure 待处理 | Discovery 已完成,Structure 尚未完成 | 提供 structure-agenda |
| Generation 待处理 | Structure 已完成,必需的演示文稿输出尚未完成 | 提供 generate-slides |
| Media 待处理 | 存在 Media Spec,且其所属的媒体阶段尚未完成或跳过 | 提供匹配的 Media Renderer |
| Proofread 待处理 | 演示文稿和必需媒体均已完成,Proofread 待处理 | 作为第四阶段运行 proofread-presentation |
| 已完成 | Proofread 已完成或跳过 | 报告完成情况,并提供明确的重新运行路径 |
仅针对检测到的分支,使用路由指南中详细的状态专属对话和恢复选项。
从 Discovery 进入 Structure,或从 Structure 进入 Generation 前,验证适用的退出标准。只有在所有条件均满足,且需要审批时用户已选择下一步操作后,才能继续。
按顺序调用
用户选择下一步操作后,将 Project Folder 路径传递给所选的 Skill。每个 Skill 都会读取 DISCOVERY.json 和 PROJECT.json,并负责自己的预检、Restart Guard、写入和完成规则。
Phase Skill 成功调用后,如果已启用,则应用 Git 检查点协议,然后重新读取状态,再提供下一步操作。保留所有无关的阶段记录。
支持的顺序为:
discover-presentation → structure-agenda → generate-slides →
generate-images/diagrams → proofread-presentation
如果存在 Media Spec,可跳过媒体阶段,也可独立运行。