speckit-orchestrator

Speckit Orchestrator

概述

在整个命令生命周期中协调规范驱动开发（SDD）工作流、技能加载和进度跟踪。

持续存在视角

将 SDD 视为一个最小化、可测试的「自我建模」循环：

• 世界模型：代码库 + speckit 产物（spec.md、plan.md、tasks.md）
• Agent 模型：已加载的技能/插件 + 约束（尤其是 .specify/memory/constitution.md）+ 进度状态

这与开放式具身 Agent（例如 Voyager/MineDojo）采用的模式相似：它们通过课程体系（tasks.md）和技能库（可复用的插件技能与 superpowers 方法技能）不断积累能力。

适用场景

• 开始任何 /speckit-* 命令。
• 协调多阶段开发工作流。
• 跟踪规范、规划和实现各阶段的进度。
• 确保已加载技能依赖项。

不适用场景

• 单阶段工作（仅编写规范或仅制定计划）
• 非规范驱动项目

核心工作流

会话初始化

1. 验证代码库上下文

   • 确认工作目录属于启用了 speckit 的项目。
   • 检查 .specify/ 目录结构。
   • 验证必需脚本是否存在。

2. 加载持久状态（「存在」）

   • 阅读 .specify/memory/constitution.md 中的约束和原则。
   • 如有 spec.md、plan.md 和 tasks.md，加载其当前上下文。

3. 加载命令依赖项

   • 将当前命令与所需技能匹配。
   • 加载互补的 superpowers 技能。

4. 初始化进度跟踪

   • 为工作流阶段创建进度项。
   • 跟踪完成状态。

命令与技能对应表

命令与技能映射的快速参考：

命令	主要技能	互补技能
/speckit-specify	spec-writing	brainstorming
/speckit-clarify	spec-writing	brainstorming
/speckit-plan	task-planning	writing-plans
/speckit-tasks	task-planning	executing-plans
/speckit-implement	-	executing-plans, systematic-debugging
/speckit-converge	-	executing-plans, verification-before-completion
/speckit-analyze	-	systematic-debugging, verification-before-completion
/speckit-checklist	-	verification-before-completion

详细模式：完整映射和加载规则请参阅 modules/command-skill-matrix.md。

计划编写模式请参阅 modules/writing-plans-extensions.md。

进度跟踪项

对于每次工作流会话，跟踪：

• 已验证代码库上下文。
• 已验证前置条件。
• 已加载特定于命令的技能。
• 已创建/更新产物。
• 已完成验证。

详细模式：进度项模式和指标请参阅 modules/progress-tracking.md。

退出条件

• 当前命令已成功完成。
• 所有必需产物均存在且有效。
• 进度跟踪反映当前状态。
• 没有尚未解决的阻碍事项。

相关技能

• spec-writing：创建和完善规范。
• task-planning：生成和规划任务。
• superpowers:brainstorming：完善想法。
• superpowers:writing-plans：制定实现计划。
• superpowers:executing-plans：执行任务。