Spec Workflow Guide

📋 中大型变更的规范开发流程

结构化开发工作流,通过需求→设计→任务→执行四阶段,确保中大型变更在编码前有明确的验收标准和可追溯的计划。

收藏
5.4k
安装
1.9k
版本
1.18.3
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心功能

Spec Workflow 是一套针对中大型软件变更的规范化开发流程,通过四个递进阶段将模糊的产品诉求转化为可执行的开发任务。

Phase 1: 需求 (requirements.md)

  • 重述问题边界,编写用户故事
  • 采用 EARS 模式撰写可测试的验收标准
  • 明确业务规则、约束条件及非目标范围

Phase 2: 设计 (design.md)

  • 定义架构边界与模块职责
  • 说明技术选型与权衡考量
  • 涵盖数据模型、API 设计、安全及测试策略

Phase 3: 任务 (tasks.md)

  • 将设计拆分为具体可执行的子任务
  • 每个任务关联回原始需求编号
  • 实时更新执行状态,保持变更可追溯

Phase 4: 执行

  • 仅在用户确认任务计划后启动编码
  • 按有意义单元逐步交付
  • 维护代码变更→任务→需求的完整链路

显著优势

  • 降低返工风险:通过前置确认避免需求理解偏差
  • 提升协作透明度:EARS 标准使验收条件无二义性
  • 强制阶段闸口:每个阶段需用户确认后才推进,防止过度设计或过早实现
  • 跨模块协调:特别适用于涉及多文件、数据库、UI 的复杂变更

潜在局限

  • 不适用小型变更:明确排除单文件修复、配置调整等可直接执行的请求
  • 引入流程开销:简单任务强制走四阶段可能造成过度工程
  • 依赖用户响应:阶段间确认机制在异步场景下可能拉长周期
  • 文档维护成本:需同步更新三份 Markdown 文件及任务状态

适合人群

  • 负责跨模块功能开发的中高级开发者
  • 需要与产品经理对齐验收标准的敏捷团队
  • 涉及数据库重构、页面设计、系统集成的架构型任务

风险提示

  • 忽略"Do NOT use"条件可能导致简单任务流程臃肿
  • 跳过阶段确认将丧失本 Skill 的核心价值
  • 任务描述若过于技术化而非用户可见结果,将削弱可追溯性
  • ui-designdata-model-creation 等 Skill 需配合使用,单独使用可能遗漏关键设计维度

Spec Workflow Guide 内容

手动下载zip · 3.8 kB
skill-card.mdtext/markdown
请选择文件