superspec:workflow-orchestrate

Orchestrate — 项目生命周期编排

概述

Orchestrate 是 SuperSpec 框架的「大脑」。它管理项目的状态机，决定阶段流转，处理升级和回退。所有阶段间的流转必须经过 orchestrate。

触发场景

1. 用户执行 /orchestrate 命令 → 查看当前状态并自动推进
2. 阶段 Skill 完成后通知 → 决定下一步
3. 门禁 Skill 产出 review 结论 → 处理流转

状态机

Draft → In Discover → Discover Reviewed
  → In Define → Spec Reviewed
    → In Design → Design Reviewed
      → In Delivery → Delivery Reviewed
        → In Verification → Verified
          → In Retrospective → Done

特殊状态: Rejected, On Hold（任意阶段可进入）

流转规则

Rule 1: 入口判断

当用户发起新项目或 /orchestrate 无活跃项目时:

输入类型	判断标准	入口阶段	确认要求
模糊想法	无结构化文档	Discover	无
结构化需求	已有类似 Spec 的文档	Define	orchestrator 确认
已有设计方案	已有类似 Design 的文档	Design	用户 + orchestrator 双重确认

Rule 2: 前进条件

流转	条件
Discover → Define	discover.md 已生成 + user_confirmed = true
Define → Design	review-spec 结论 PASS 或 PASS_WITH_NOTES
Design → Deliver	review-design 结论 PASS 或 PASS_WITH_NOTES
Deliver → Verify	review-delivery 结论 PASS 或 PASS_WITH_NOTES
Verify → Reflect	验收结论 PASS
Reflect → Done	retrospective.md 已生成

Rule 3: 回退条件

结论	处理
REVISE（第 1 轮）	回退到对应阶段，记录轮次
REVISE（连续第 2 轮）	升级: 拉回上一阶段 / 联合复核 / 人工介入
REVISE（第 3 轮）	强制人工介入，暂停流程
BLOCKED	暂停流程，通知用户

Rule 4: 强制规则

• <HARD-GATE> 门禁不可跳过 </HARD-GATE>
• 项目结束必须进入 Reflect（可配置为可选）
• 每次阶段完成必须通知 orchestrator

执行流程

当用户执行 /orchestrate 时:

1. 扫描 docs/specs/ 查找所有项目
2. 如果无活跃项目 → 列出所有项目及状态，提示用户选择或新建
3. 如果有活跃项目 → 读取 .status.md:
   • 如果有未完成的阶段 → 提示继续
   • 如果当前阶段已完成但未 review → 触发对应门禁
   • 如果 review 通过 → 推进到下一阶段（调用对应的 phase skill）
   • 如果 review 未通过 → 显示问题，提示修改

当阶段 Skill 通知完成时:

1. 读取 .status.md
2. 检查前进条件
3. 如果需要门禁 → 触发门禁 skill
4. 如果门禁通过 → 更新状态，触发下一阶段 skill
5. 如果门禁未通过 → 回退处理

状态更新

每次流转后更新 .status.md:

• current_phase: 新阶段
• last_updated: 当前日期
• Phase History: 新增记录
• Open Issues: 如有新问题

项目列表视图

当存在多个项目时，展示:

## SuperSpec 项目列表

| # | 项目 | 当前阶段 | 最后更新 | 状态 |
|---|------|---------|---------|------|
| 001 | {name} | In Design | 2026-03-24 | 活跃 |
| 002 | {name} | Done | 2026-03-20 | 完成 |

错误处理

场景	处理方式
.status.md 不存在或损坏	提示用户，尝试从已有文档重建状态
子代理运行时错误	记录到 Open Issues，通知用户决策
多项目并行	按 project-id 隔离，每个项目独立状态