Spec-kit

Spec-kit 是 GitHub 开源的 Spec-Driven Development 工具包，用来把需求、规格、计划、任务和实现串成 AI 辅助开发流程。

1. 定位

Spec-kit 不是普通代码生成器，而是围绕 SDD 的工作流工具。

它强调先产出规格和计划，再进入实现，避免把模糊需求直接交给 AI 写代码。

2. 解决什么问题

Vibe Coding 容易出现的问题：

• prompt 里混入太多隐含需求
• AI 直接写代码，但需求还没定义清楚
• 实现完成后不知道如何验收
• 文档、计划、任务和代码脱节

Spec-kit 的方向是让 AI 编码前先有结构化产物。

3. 典型产物

常见产物包括：

• Spec：功能目标、用户场景、需求、验收标准
• Plan：技术方案、架构影响、依赖和约束
• Tasks：可执行任务拆分
• Implementation：基于任务逐步实现
• Verification：根据规格检查实现是否达标

4. 基本流程

需求描述
  -> 生成 spec
  -> 澄清不确定点
  -> 生成 plan
  -> 拆分 tasks
  -> AI / 工程师实现
  -> 根据 spec 验证

关键点是：规格不是实现后的说明文档，而是实现前的约束来源。

5. 适合场景

适合：

• 新功能开发
• 需求边界较多的业务逻辑
• 多人协作
• 长期维护项目
• AI 编码助手参与较深的项目

不适合：

• 一次性小脚本
• 需求非常简单的小修改
• 只需要探索性原型且不追求维护性的任务

6. 与 Vibe Coding 的关系

Vibe Coding 更自由，适合探索和快速迭代。

Spec-kit 更结构化，适合把探索沉淀成可执行规格。

推荐路径：

Vibe Coding 探索需求
  -> SDD 固化规格
  -> Spec-kit 管理规格、计划和任务
  -> Harness / 测试验证实现

7. 实践建议

• 不要跳过澄清环节
• 把验收标准写成可检查条件
• 让 plan 明确技术取舍和不做什么
• tasks 要能独立执行和验收
• 实现后回到 spec 做对照，而不是只看代码能否运行

8. 一句话总结

Spec-kit 的价值在于把“AI 帮我写代码”升级成“规格驱动的 AI 辅助交付流程”。

9. 参考

• GitHub 仓库：https://github.com/github/spec-kit
• Spec Kit 官网：https://speckit.org/