AI编程:SDD 工具全景图与选型指南(002)
引言:工具是思想的载体
在上一篇文章中,我们探讨了规格驱动开发(SDD)的核心理念——通过结构化的规格(Spec)作为人机协作的“单一事实来源”,从而终结“氛围编程”的混乱。然而,再精妙的理念也需要强大的工具来承载和落地。
正如 ThoughtWorks 杰出工程师 Birgitta Böckeler 所总结的,SDD 的实践可以分为三个演进层级:
- 规格优先 (Spec-first):为当前任务编写规格,用完即弃。
- 规格锚定 (Spec-anchored):规格作为长期资产被保留、维护,并随功能演进而同步更新。
- 规格即源 (Spec-as-source):规格成为系统的主要产物,代码被视为由规格生成的派生品。
目前,业界涌现出了多种 SDD 工具,它们分别代表了不同的哲学和实现路径。本文将为你绘制一幅清晰的 SDD 工程化工具全景图,深入剖析三大主流框架——OpenSpec、Kiro 和 GitHub Spec-Kit 的核心特性、适用场景与内在差异,助你为团队选择最合适的武器。

图1:SDD 工具全景图。三大主流框架分别代表了轻量级、集成式与企业级三种不同的工程化路径。
一、轻量级先锋:OpenSpec —— 无侵入的本地化方案
定位:开源 | 轻量 | 无侵入 | 跨AI工具
如果你正在寻找一个能快速融入现有工作流、对项目零侵入的 SDD 解决方案,那么 OpenSpec 是你的不二之选。
核心理念
OpenSpec 奉行极简主义。它认为,SDD 的核心在于 规范本身,而非复杂的工具链。因此,它完全基于 纯文件驱动,无需任何 API 密钥、服务器或数据库。你只需要在项目根目录下创建 specs/ 和 changes/ 两个文件夹,即可开始 SDD 实践。
specs/目录:存放已实现能力的规范文档,是项目的“知识库”。changes/目录:存放待处理的变更提案,每个新功能或修复都始于这里的一个.md文件。
工作流
OpenSpec 的工作流极其简单,通常只需四步:
- Proposal (提案):
openspec proposal new-feature,创建一个变更提案。 - Review & Refine (评审与精炼):与团队或 AI 共同完善提案内容。
- Apply (应用):
openspec apply new-feature,将提案转化为正式规范,并触发 AI 生成代码。 - Archive (归档):
openspec archive new-feature,将已完成的提案移至specs/目录,形成永久知识资产。
优势与适用场景
- 优势:学习成本极低,可无缝集成到 Cursor、Claude、CodeBuddy 等任何 AI 编程助手;完美适配棕地(Brownfield)项目,支持增量式引入。
- 适用场景:中小型团队、个人开发者、希望以最小成本验证 SDD 价值的先行者。
一句话总结:OpenSpec 是 SDD 的“瑞士军刀”——小巧、灵活、可靠。
二、集成式体验:Kiro —— AWS 打造的 Agentic IDE
定位:集成IDE | Agentic | 云原生 | 快速原型
如果说 OpenSpec 是一把精准的手术刀,那么 Kiro 就是一间装备齐全的现代化手术室。由 AWS 推出的 Kiro,是一款深度集成了 SDD 理念的 智能体(Agentic)集成开发环境(IDE)。
核心理念
Kiro 的目标是提供端到端的开发体验。它内置了 Claude 系列大模型,并将 SDD 流程深度嵌入到 IDE 的每一个环节。在 Kiro 中,“写代码”只是整个流程的最后一步。
工作流
Kiro 的 SDD 流程被称为 三阶段模式:
- Spec (规格):在聊天界面中选择 “Spec” 模式,用自然语言描述你的需求。Kiro 会自动生成结构化的
requirements.md、design.md和tasks.md。 - Plan (计划):AI 基于规格文件,自动拆解出详细的、可执行的任务列表。
- Execute (执行):AI Agent 自动执行任务列表中的每一项,生成、测试并提交代码。
整个过程在 Kiro 的 UI 中可视化呈现,开发者可以随时介入、审查和调整。
优势与适用场景
- 优势:开箱即用,体验流畅;特别擅长快速构建云原生应用和 PoC(概念验证)项目;与 AWS 生态深度集成。
- 适用场景:需要快速迭代的初创团队、云原生开发者、偏好一体化工具的个人。
一句话总结:Kiro 是 SDD 的“自动驾驶汽车”——你只需设定目的地(Spec),它会带你安全抵达。
三、企业级框架:GitHub Spec-Kit —— “宪法优先”的治理之道
定位:企业级 | 强治理 | 高结构化 | 社区驱动
对于追求极致工程纪律和长期可维护性的大型团队而言,GitHub Spec-Kit 提供了一套更为严谨和全面的 SDD 框架。
核心理念
Spec-Kit 的核心思想是 “宪法优先”(Constitution First)。它认为,软件系统的规范应该像国家的宪法一样,具有最高的权威性和稳定性。代码只是宪法精神的具体体现。
因此,Spec-Kit 强制要求一个 四阶段闭环工作流:
- Spec (规范):定义“做什么”和“为什么”。
- Plan (计划):定义“如何做”的高层次技术方案。
- Tasks (任务):将计划分解为原子化的、可分配的开发任务。
- Implementation (实现):最终的代码产出。
这四个阶段环环相扣,任何一个阶段的变更都必须经过严格的审查流程。
优势与适用场景
- 优势:提供了最强的工程治理能力,确保复杂系统的长期一致性;拥有活跃的开源社区和丰富的最佳实践。
- 适用场景:大型企业、对代码质量和合规性有极高要求的金融或医疗行业、维护超大规模遗留系统的团队。
一句话总结:Spec-Kit 是 SDD 的“法治社会”——一切行为都有章可循,一切产出皆有据可查。
四、横向对比与选型决策树
为了帮助你做出明智的选择,我们将三大工具的核心维度进行横向对比:
| 维度 | OpenSpec | Kiro | GitHub Spec-Kit |
|---|---|---|---|
| 部署方式 | CLI 工具,纯文件 | 独立 IDE 应用 | CLI + Git 工作流 |
| 学习曲线 | ⭐☆☆☆☆ (极低) | ⭐⭐☆☆☆ (低) | ⭐⭐⭐⭐☆ (陡峭) |
| 侵入性 | 无侵入 | 高(需切换 IDE) | 中(需遵循严格流程) |
| AI 集成 | 通用,适配所有主流助手 | 内置 Claude,深度优化 | 通用,但需配置 |
| 核心优势 | 轻量、灵活、快速上手 | 一体化体验、快速原型 | 强治理、高可追溯性 |
| 理想用户 | 个人/小团队,棕地项目 | 初创公司,云原生开发者 | 大型企业,复杂系统 |

图2:SDD 工具选型决策树。根据团队规模、项目复杂度和工程成熟度,选择最适合的路径。
五、结语:没有银弹,只有合适的工具
SDD 工具的选择并非一场“谁是最好的”竞赛,而是一次“谁是最适合的”匹配。OpenSpec、Kiro 和 GitHub Spec-Kit 分别代表了 SDD 范式在不同场景下的最优解。
- 如果你追求 敏捷与自由,从 OpenSpec 开始。
- 如果你渴望 一体化与速度,拥抱 Kiro。
- 如果你需要 治理与秩序,投入 GitHub Spec-Kit 的怀抱。
无论选择哪条路,你都已经迈出了告别“氛围编程”,走向工程化人机协作的关键一步。
预告:在下一篇《SDD 工具 OpenSpec 理论说明》中,我们将聚焦于 OpenSpec,深入其设计哲学、目录结构和核心命令,为你揭示这个轻量级工具背后的强大工程思想。敬请期待!
更多推荐



所有评论(0)