mcpField
B
build-presentation

build-presentation

github.com/ken-guru文档处理185 次安装1 周前更新
代码仓库

关于 build-presentation

Presentation Skill Suite 的编排器,会读取项目状态并将工作导向下一个未完成阶段。它负责阶段排序和状态检查,各阶段任务由可独立调用的 Skill 执行。

主要功能

  1. 01路由至下一个未完成阶段
  2. 02检查项目状态和退出条件
  3. 03支持 Git 检查点协议
  4. 04为状态不明确或损坏提供恢复指引

适用场景

  1. 01确定演示文稿项目的下一步
  2. 02根据现有项目文件继续工作

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/ken-guru/skills --skill build-presentation

安装后在 Claude Code 中输入/build-presentation确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

EXIT_CRITERIA.md
GIT_CHECKPOINTS.md
ROUTING.md
evals/
build-presentation.json

详细介绍

构建演示文稿(编排器)

通过根据 Project Folder 的状态路由到下一个有效操作,协调 Presentation Skill Suite。此编排器不包含各阶段的能力;每个 Phase Skill 仍可独立调用。

输出语气

对路由说明、决策摘要和完成报告进行轻量的自然表达润色。优先说明具体状态和后续操作,保留用户要求的语气,并确保 Project Folder 路径、命令和状态名称保持原样。所有演示文稿文案阶段都必须经过其规定的独立 unslop 润色。润色时必须采用 DISCOVERY.json 中记录的所有编辑偏好。

安装边界

安装此编排器时,必须同时安装完整的 Presentation Skill Suite。该套件的分发约定要求,安装后每个成员都能独立使用。

启动

  1. 确认 Project Folder 可读。
  2. 如果 Project Folder 存在,则要求其中包含 PROJECT.json,且 projectType: "presentation"。
  3. 直接读取 Project Folder 的状态和指定的构件。
  4. 如果状态含糊或已损坏,报告问题并暂停变更操作。引导用户检查或修复 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,可跳过媒体阶段,也可独立运行。

评论

支持 Markdown