SuperSpec
规格驱动的多 Agent 协同工作流框架
SuperSpec 融合了 Superpowers 的技能执行引擎与 Spec Kit 的规格模板体系，为数字人团队打造了一套完整的项目协同工作流。
它的核心理念是：规格不是代码的附属品 —— 代码是规格的表达。
当你启动一个项目时，SuperSpec 不会让 Agent 直接跳进实现。它会先退一步，帮你搞清楚你真正要做什么，然后一步步推进到设计、拆解、实现、验收、复盘 —— 每一步都有质量门禁把关，每一步都有专门的 Agent 角色主导。
目录
快速开始
安装
# Claude Code 插件安装
claude plugin add /path/to/superspec
安装后，启动新会话会看到：
SuperSpec v1.0 已加载。使用 /orchestrate 查看项目状态，或 /discover 开始新项目。
验证安装
启动一个新会话，输入 /orchestrate。如果看到项目列表（或提示你新建项目），说明安装成功。Skills 会自动触发 —— 你不需要做任何额外配置。
30 秒上手
/discover # 有个新想法？从这里开始
/orchestrate # 不确定进度？让编排引擎告诉你
更新
claude plugin update superspec
核心概念
六阶段流水线
每个项目经过 6 个阶段，每个阶段有明确的输入、输出和质量门禁。阶段之间不能跳跃 —— 这不是建议，是强制规则。
/discover → /define → /design → /deliver → /verify → /reflect
│ │ │ │ │ │
│ [门禁审查] [门禁审查] [门禁审查] │ │
▼ ▼ ▼ ▼ ▼ ▼
业务澄清 需求规格 技术设计 任务执行 验收评审 复盘沉淀
| 阶段 | 命令 | 做什么 | 不做什么 | 产出 |
|---|
| Discover | /discover | 从模糊想法提炼出明确方向 | 不讨论技术实现 | discover.md |
| Define | /define | 将方向转化为结构化需求规格 | 不做技术选型 | spec.md |
| Design | /design | 生成技术设计方案和 Agent 分工 | 不开始写代码 | design.md |
| Deliver | /deliver | 拆解任务并执行实现 | 不超出 Spec 范围 | tasks.md + 实现产出 |
| Verify | /verify | 端到端验收 | 不修改需求 | verify-report |
| Reflect | /reflect | 项目复盘与知识沉淀 | 不跳过 | retrospective.md |
Constitution（项目宪法）
受 Spec Kit 启发，每个项目在初始化时会生成一份 constitution.md，定义不可违反的治理原则：
- 质量标准（如 "所有需求必须有可验证的验收标准"）
- 文档规范（如 "使用中文，专有名词保留英文"）
- Agent 行为底线（如 "不允许跳过门禁"）
- 审批权限规则
Constitution 是所有阶段 Skill 的顶层约束 —— 类似 Spec Kit 中的 "Nine Articles"。
门禁机制
阶段之间有自动质量门禁（HARD-GATE），必须通过才能进入下一阶段：
| 门禁 | 位置 | 检查什么 |
|---|
| review-spec | Define → Design | 需求可验证性、范围明确性、无歧义 |
| review-design | Design → Deliver | 需求覆盖度、YAGNI、Agent 分工合理性 |
| review-delivery | Deliver → Verify | 交付物齐全、任务全部完成 |
门禁结论：
| 结论 | 含义 | 后续 |
|---|
PASS | 通过 | 自动进入下一阶段 |
PASS_WITH_NOTES | 有条件通过 | 进入下一阶段，备注跟进 |
REVISE | 需修改 | 回退当前阶段，给出具体修改建议 |
BLOCKED | 阻塞 | 暂停流程，等待人工决策 |
连续 2 轮 REVISE 会触发升级机制（联合复核或人工介入）。第 3 轮强制暂停。
Skill 自动触发
和 Superpowers 一样，SuperSpec 的 Skills 自动触发 —— 你不需要手动调度 Agent 或记住内部流程。执行 /discover 时，框架自动派发产品策略 Agent 主导、方案架构 Agent 辅助、文档治理 Agent 校验。
优先级规则（与 Superpowers 一致）：
- 你的显式指令（CLAUDE.md、直接要求）— 最高优先级
- SuperSpec Skills — 覆盖默认行为
- 系统默认行为 — 最低优先级
完整教程：从想法到交付
以 "数字员工管理平台" 为例，演示完整的 6 阶段流程。
Step 1: Discover — 业务澄清
/discover
Agent 会逐个提问（每次只问一个问题，优先使用选择题）：
产品策略 Agent: 这个数字员工管理平台主要解决什么问题？
A) 内部团队的 AI Agent 协同管理
B) 面向客户的数字员工服务平台
C) Agent 的全生命周期管理（创建、配置、监控、下线）
D) 其他
你: A
产品策略 Agent: 目标用户是谁？
A) 研发团队（技术人员）
B) 业务运营团队（非技术人员）
C) 两者都有，但以研发为主
D) 两者都有，但以运营为主
你: C
... (更多澄清问题)
产品策略 Agent: 根据以上讨论，我建议以下 3 个方向：
方案 A（推荐）: 以 Agent 协同编排为核心...
方案 B: 以知识库管理为核心...
方案 C: 以监控看板为核心...
你: 方案 A
产出：docs/specs/001-digital-employee-platform/discover.md
文档末尾有确认签字区，你确认方向后 user_confirmed 置为 true。
Step 2: Define — 需求规格化
/define
HARD-GATE: 此阶段不允许讨论技术选型。保持技术无关。
Agent 读取 Discover 文档，将需求转化为结构化规格：
## 用户故事
### US-001: 创建数字员工
**优先级**: P1
**描述**: 作为研发团队成员，我希望通过配置界面创建新的数字员工，以便快速组建 Agent 团队
**验收场景**:
- Given 用户已登录管理平台
- When 填写员工名称、角色、技能配置并提交
- Then 系统创建数字员工实例并显示在员工列表中
## Agent 协同设计
| 环节 | 责任 Agent | 自动化程度 | 人工确认点 |
|------|-----------|-----------|-----------|
| 员工创建 | 配置 Agent | 全自动 | 否 |
| 权限分配 | 安全 Agent | 半自动 | 是 |
产出：docs/specs/001-digital-employee-platform/spec.md
完成后自动触发 review-spec 门禁：
质量评审 Agent: Spec Review R1 结论: PASS_WITH_NOTES
检查清单:
✅ 目标可追溯性 — 所有目标来自 Discover 文档
✅ 需求可验证性 — 每个用户故事有 Given/When/Then
⚠️ 人机协同边界 — "权限分配"的人工确认触发条件未明确
允许进入 Design，建议在 Design 阶段补充权限确认的触发规则。
Step 3: Design — 技术方案设计
/design
方案架构 Agent 读取 Spec，生成技术设计：
## Agent 分工设计
### 配置 Agent
- 输入: 用户的创建请求
- 输出: 数字员工实例
- 决策权限: 可自动选择默认配置模板
- 与安全 Agent 的交互: 创建后触发权限分配请求
产出：docs/specs/001-digital-employee-platform/design.md
完成后自动触发 review-design 门禁。
Step 4: Deliver — 任务拆解与执行
/deliver
分两个阶段自动进行：
阶段 1 — 项目规划 Agent 拆解任务：
| ID | 任务 | 责任Agent | 前置依赖 | 并行标记 | 输出 | 验收条件 |
|---|---|---|---|---|---|---|
| T-001 | 创建项目脚手架 | executor | - | | 项目目录结构 | 目录存在且可运行 |
| T-002 | 实现数据模型 | executor | T-001 | | 数据模型文件 | 模型定义完整 |
| T-003 | 实现员工创建 API | executor | T-002 | [P] | API 端点 | 通过单元测试 |
| T-004 | 实现员工列表 API | executor | T-002 | [P] | API 端点 | 通过单元测试 |
阶段 2 — 实施执行 Agent 逐任务执行：
Crysple
moshehbenavraham
jasonkneen
xrf9268-hue
JuliusBrussee
wshobson