name: speckit-run description: “执行完整的GitHub Spec Kit 5阶段工作流,从宪法到实现。” argument-hint: “<功能请求或 --resume>” allowed-tools: Read, Glob, Grep, Write, Edit, Bash, Skill, Task
运行Spec Kit工作流
执行完整的GitHub Spec Kit 5阶段规格驱动开发工作流。
5个阶段
┌─────────────────────────────────────────────────────────────┐
│ SPEC KIT WORKFLOW │
├─────────────────────────────────────────────────────────────┤
│ │
│ 阶段 0: 宪法 │
│ 定义项目原则和约束 │
│ ↓ [宪法存在且有效] │
│ │
│ 阶段 1: 规格化 │
│ 从功能请求生成规范规格 │
│ ↓ [规格验证通过,INVEST得分 ≥ 7] │
│ │
│ 阶段 2: 计划 │
│ 创建实现设计和方案 │
│ ↓ [设计覆盖所有需求] │
│ │
│ 阶段 3: 任务 │
│ 分解为可执行的任务列表 │
│ ↓ [任务映射到需求] │
│ │
│ 阶段 4: 实现 │
│ 执行任务并持续验证 │
│ ↓ [所有验收条件通过] │
│ │
│ ✓ 完成 │
│ │
└─────────────────────────────────────────────────────────────┘
工作流
-
初始化
- 生成
speckit-runner代理 (Opus) - 检查现有宪法
- 确定起始阶段
- 生成
-
阶段 0: 宪法
- 检查
.constitution.md - 如果缺失,创建项目原则
- 验证宪法结构
- 检查
-
阶段 1: 规格化
- 调用
spec-processor generate代理 - 生成规范规格
- 使用
spec-reviewer validate验证 - 门控: INVEST得分 ≥ 7
- 调用
-
阶段 2: 计划
- 分析代码库
- 生成实现设计
- 映射设计到需求
- 门控: 所有需求覆盖
-
阶段 3: 任务
- 分解为垂直切片
- 生成任务分解
- 映射任务到需求
- 门控: 所有需求有任务
-
阶段 4: 实现
- 按顺序执行任务
- 验证验收条件
- 运行测试
- 门控: 所有验收条件通过
-
完成
- 生成完成报告
- 更新规格状态
- 归档工作流工件
参数
$ARGUMENTS- 功能请求描述--resume- 从最后检查点恢复--phase- 从特定阶段开始 (0-4)--skip-constitution- 如果宪法存在,跳过阶段 0
示例
# 从功能请求的完整工作流
/spec-driven-development:speckit-run "用户认证,包括邮箱和OAuth"
# 恢复中断的工作流
/spec-driven-development:speckit-run --resume
# 从阶段 2 开始(现有规格)
/spec-driven-development:speckit-run --phase 2 .specs/auth/spec.md
# 跳过宪法检查
/spec-driven-development:speckit-run "新功能" --skip-constitution
进度跟踪
运行器维护检查点:
## Spec Kit 工作流: user-auth
**开始时间:** 2024-01-15T09:00:00Z
**状态:** 阶段 2 - 计划
### 进度
| 阶段 | 状态 | 开始时间 | 完成时间 |
| --- | --- | --- | --- |
| 0. 宪法 | ✓ 完成 | 09:00 | 09:02 |
| 1. 规格化 | ✓ 完成 | 09:02 | 09:15 |
| 2. 计划 | 🔄 进行中 | 09:15 | - |
| 3. 任务 | ⏳ 待定 | - | - |
| 4. 实现 | ⏳ 待定 | - | - |
### 工件
- 宪法: .constitution.md ✓
- 规格: .specs/user-auth/spec.md ✓
- 设计: .specs/user-auth/design.md (进行中)
- 任务: 待定
验证门控
每个阶段有质量门控:
| 阶段 | 门控标准 |
|---|---|
| 宪法 | 文件存在,必需部分存在 |
| 规格化 | 架构有效,EARS格式,INVEST ≥ 7 |
| 计划 | 所有需求解决,组件定义 |
| 任务 | 所有需求有任务,每个 < 1 天 |
| 实现 | 所有验收条件通过,测试通过 |
回滚支持
如果阶段失败:
## 需要回滚
**阶段:** 2 (计划)
**原因:** 设计未覆盖 FR-3
### 选项
1. [重试] 使用更新上下文重新运行阶段 2
2. [回滚] 返回到阶段 1 并更新规格
3. [跳过] 标记 FR-3 为范围外并继续
完成报告
# Spec Kit 工作流完成
**功能:** 用户认证
**持续时间:** 09:00 - 11:30 (2小时 30分钟)
**状态:** ✓ 成功
## 阶段总结
| 阶段 | 持续时间 | 工件 | 问题 |
| --- | --- | --- | --- |
| 宪法 | 2分钟 | .constitution.md | 0 |
| 规格化 | 13分钟 | spec.md | 0 |
| 计划 | 18分钟 | design.md | 1 (已解决) |
| 任务 | 12分钟 | tasks.md | 0 |
| 实现 | 85分钟 | 12个文件 | 2 (已解决) |
## 交付的需求
| ID | 标题 | 状态 | 验收条件 |
| --- | --- | --- | --- |
| FR-1 | 邮箱登录 | ✓ | 4/4 |
| FR-2 | OAuth登录 | ✓ | 3/3 |
| FR-3 | 会话管理 | ✓ | 5/5 |
相关命令
/spec-driven-development:specify- 仅阶段 1/spec-driven-development:plan- 仅阶段 2/spec-driven-development:tasks- 仅阶段 3/spec-driven-development:implement- 仅阶段 4/spec-driven-development:constitution- 仅阶段 0