规格驱动开发工作流执行Skill speckit-run

这个技能用于自动化执行GitHub Spec Kit的5阶段规格驱动开发流程,从项目宪法定义到实现验证,确保软件开发规范化和高质量交付。关键词:规格驱动开发、GitHub Spec Kit、工作流自动化、软件开发流程、规范验证、5阶段工作流。

架构设计 0 次安装 0 次浏览 更新于 3/11/2026

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: 实现                                              │
│   执行任务并持续验证                                        │
│        ↓ [所有验收条件通过]                                 │
│                                                             │
│   ✓ 完成                                                    │
│                                                             │
└─────────────────────────────────────────────────────────────┘

工作流

  1. 初始化

    • 生成 speckit-runner 代理 (Opus)
    • 检查现有宪法
    • 确定起始阶段
  2. 阶段 0: 宪法

    • 检查 .constitution.md
    • 如果缺失,创建项目原则
    • 验证宪法结构
  3. 阶段 1: 规格化

    • 调用 spec-processor generate 代理
    • 生成规范规格
    • 使用 spec-reviewer validate 验证
    • 门控: INVEST得分 ≥ 7
  4. 阶段 2: 计划

    • 分析代码库
    • 生成实现设计
    • 映射设计到需求
    • 门控: 所有需求覆盖
  5. 阶段 3: 任务

    • 分解为垂直切片
    • 生成任务分解
    • 映射任务到需求
    • 门控: 所有需求有任务
  6. 阶段 4: 实现

    • 按顺序执行任务
    • 验证验收条件
    • 运行测试
    • 门控: 所有验收条件通过
  7. 完成

    • 生成完成报告
    • 更新规格状态
    • 归档工作流工件

参数

  • $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