Spec-Kit是一个具体实现规范驱动开发的工具集或框架。虽然"Spec-Kit"不是一个通用商标术语,但这个概念指的是专门为规范驱动开发设计的一整套集成工具。 Spec-Kit的典型架构一个完整的Spec-Kit通常包含以下核心组件: 展开 代码生成引擎 Spec-Kit的核心是强大的代码生成能力: 示例:Spec-Kit代码生成配置spec-kit-config: specs /api/*.yaml - spec-kit lint --rules api-standardsgenerate-code: stage: generate script: - spec-kit test --contract```## Spec-Kit的实际产品示例虽然"Spec-Kit"是通用概念,但市场上有许多实现这一理念的工具:1.
最近在研究opencode,整理整个流程,发现在ai编程时,SDD部分不是很严谨,效率不高,发现了Spec-kit,它作为SDD,大大的提升了AI编程的效率。 如果你也遇到以下问题,那么Spec-kit非常适合你。 一版一样第一版写的代码结构清晰,第二版写的却是一坨屎山你也不知道为什么,就是感觉AI今天"心情不太好"四:版本根本没眼看git版本不一,提交乱七八糟如果你有一项符合,那么你最好完整的看完这篇文章GitHub官方推出的Spec-Kit 最核心的5步,集成到opencode中:3分钟上手使用spec-kit第一步:安装spec-kit展开代码语言:TXTAI代码解释打开终端#安装specify命令行工具uvtoolinstallspecify-cli 强烈推荐使用SDD:正规项目开发(需要长期维护)团队协作项目功能复杂的业务系统对代码质量有要求的项目需求可能变更的项目❌可以不用SDD:快速原型验证简单的脚本工具学习新技术做实验一锤子买卖的代码快使用Spec-kit
三者的背景与定位 Spec-Kit:规范可执行化 GitHub 官方出品,由 Den Delimarsky 和 John Lam 等核心开发者维护。 │ └─────────────────────────────────────────────┘ Spec-Kit 基于 Python,使用 uv 作为包管理器。 Spec-Kit 支持 11+,Superpowers 专注少数平台(主要为 Claude Code 优化)。 Spec-Kit 的哲学是:结构胜过混乱。 需要规范生成代码的场景 推荐:Spec-Kit 理由: 规范可执行化是核心定位 模板引擎支持代码生成 扩展系统支持自定义生成逻辑 适合:希望通过规范自动生成代码的场景。 7.
2、技术规划与“项目宪法”生成需求文档确认后,我会进入技术规划阶段,此时依然会借助AI的力量梳理技术体系,生成“项目宪法”(这是引用spec-kit中constitution的说法,我非常喜欢spec-kit 4、明确开发职责,指定agent进入spec-kit流程模块拆分完成后,就进入了具体的开发执行阶段(我非常依赖spec-kit),首先需要明确开发职责,指定对应的agent负责具体模块的开发。 5、spec-kit 命令执行与人工审核agent明确模块开发职责后,我会逐步执行spec-kit命令,启动具体的开发流程,我也会全程参与人工审核,把控每个阶段的开发质量。 spec-kit命令执行后,会依次生成spec(规格文档)、plan(开发计划)、task(任务清单)三个核心文件,这三个文件是后续开发的核心指导。 项目中剩余的其他模块,只需换一个agent执行第五步流程,执行spec-kit命令,完成spec、plan、task各阶段的文件生成与人工审核,审核通过后,再继续分步执行speckit.implement
从实践来看,目前最具代表性的两种工程范式,可以分别用 Spec-Kit 和 OpenSpec 来抽象说明。 7.2 重规范范式:以 Spec-Kit 为代表 7.2.1 Spec-Kit 的核心定位 Spec-Kit 并不是一个"写 Spec 的工具",而是一个强约束的 AI 编程工作流体系。 因此,Spec-Kit 的设计目标非常明确: 把 AI 的"自由度"压缩到最低 把 工程决策前移到规范阶段 把 不可控风险,提前暴露 7.2.2 Spec-Kit 的完整规范链路(为什么它"重") Spec-Kit 7.2.4 Spec-Kit 规范示例 为了更好地理解“重规范”的具体形态,我们来看一个简化的 Spec-Kit 规范示例。 大功能:Spec-Kit 小需求:OpenSpec 同一个项目中动态切换 7.5 总结:AI 时代,规范是"可调节的工程杠杆" 在 AI 编程时代: 规范太重 → 效率低 规范太轻 → 系统失控 Spec-Kit
主流工具包括GitHub的Spec-Kit、AWS的Kiro和TesslFramework等。 以Spec-Kit为例,其工作流包含"specify/requirement→plan/design→task→implement"四个阶段。 有人说,用spec-kit开发中等规模功能,会生成大量重复的Markdown文档,增加审查负担。我们还要思考,现有SDD工具预设的流程,是否可以优雅适配从修复小bug、到开发大业务等不同规模的任务。 对SDD而言,还处在敏捷运动早期的“方法论战争”初期,很多SDD方法还在横空出世的路上,而当前已有SDD工具则各有各的方法(如Spec-Kit、Kiro等各有侧重)。 SDD需借鉴这一经验,在规范结构化(如Spec-Kit的条目化需求)与工具易用性间找到平衡,避免因过度复杂化重蹈MDD覆辙。
提出系统化解决方案:团队探索并沉淀出了一套 Spec-Kit 流程,将AI协作纳入了标准化的开发规范。 从“个人提效”到“工程化流程”:从依赖开发者个人的提示词技巧,到建立团队级的标准化协作规范(如Spec-Kit)。
SDD工具的启发 关于SDD在vibe coding上的应用,已经有一些SDD工具:openSpec,Spec-Kit和Kiro,OpenSpec和Spec-Kit是可嵌入现有AI编码工具的框架/CLI openSpec[1]的设计理念是从1->n,基于大多数项目编码是基于现有代码库的,而Spec-kit[2]更偏向于项目启动,从0到1构建新项目。 维度 Spec-Kit OpenSpec Kiro 产品类型 CLI工具包 轻量级框架 完整IDE 开源 ✅ 是 (MIT) ✅ 是 ❌ 否(专有) 使用方式 嵌入现有AI编码工具 嵌入现有AI编码工具 参考文献: [1] https://github.com/Fission-AI/OpenSpec [2] https://github.com/github/spec-kit [3] https: img-TjleQzd8-1767059841320)] 参考文献: [1] https://github.com/Fission-AI/OpenSpec [2] https://github.com/github/spec-kit
SDD工具的启发 关于SDD在vibe coding上的应用,已经有一些SDD工具:openSpec,Spec-Kit和Kiro,OpenSpec和Spec-Kit是可嵌入现有AI编码工具的框架/CLI openSpec[1]的设计理念是从1->n,基于大多数项目编码是基于现有代码库的,而Spec-kit[2]更偏向于项目启动,从0到1构建新项目。 维度 Spec-Kit OpenSpec Kiro 产品类型 CLI工具包 轻量级框架 完整IDE 开源 ✅ 是 (MIT) ✅ 是 ❌ 否(专有) 使用方式 嵌入现有AI编码工具 嵌入现有AI编码工具 参考文献: [1] https://github.com/Fission-AI/OpenSpec [2] https://github.com/github/spec-kit [3] https://martinfowler.com
整个过程由AI主导,在关键节点进行人工确认,最终输出完整的Spec-Kit文档体系。效果对比传统开发模式下,同等规模的新需求模块页面搭建通常需要3天的纯编码和技术方案时间。
3,工具选型 有多个开源项目都是SDD 的优秀实践,其中最具代表性的三款是OpenSpec、Spec-kit和Superpowers。要结合自身项目特点和需求进行适当的选择。 OpenSpec的双区域设计(specs/ + changes/)对存量项目尤为友好 • 低上手成本:希望快速试用SDD方法论,/opsx:propose一条命令即可启动规范化流程,门槛最低 3.2,Spec-kit
整个过程由AI主导,在关键节点进行人工确认,最终输出完整的Spec-Kit文档体系。效果对比传统开发模式下,同等规模的新需求模块页面搭建通常需要3天的纯编码和技术方案时间。
这种方法被称为规范驱动开发(SDD),有多种工具包可供入门使用,包括: GitHub 的 Spec-Kit 亚马逊云科技的 Kiro Tessl 的 Tessl BMad Code 的 BMad Method (BMM) 若需了解这些工具的差别,Birgitta Böckeler 写过一篇精彩的文章“理解规范驱动开发:Kiro、spec-kit 与 Tessl”。
温昱,腾讯云架构师同盟名人堂成员,腾讯云架构师同盟上海理事会理事圆桌讨论就SDD展开,MartinFowler在12月份中的《理解规范驱动开发:Kiro、spec-kit与Tessl》。
SPEC 相关工具 spec-kit: https://github.com/github/spec-kit OpenSpec: https://github.com/Fission-AI/OpenSpec
Spec Kit, a toolkit to help you get started with Spec-Driven Development - https://github.com/github/spec-kit
了解更多 详见:https://github.com/github/spec-kit 故障排除 Linux 上的 Git 凭据管理器 如果你在 Linux 上遇到 Git 身份验证问题,可以安装 Git
以下资料值得一读:《Anthropic 的 AI Agent 上下文工程指南》Spec Coding 实践(如 GitHub 的 spec-kit 项目)何时极简,何时写 Spec? https://github.com/github/spec-kit我此前的做法与 Spec Coding 不谋而合,但还比较粗糙。接下来我会系统采用 Spec Coding 去做复杂项目。
目前社区中主要存在三类 SDD 工具:OpenSpec、Kiro、Spec-Kit。 AI 规范驱动开发“三剑客”深度对比:Spec-Kit、Kiro 与 OpenSpec 实战指南 - 技术栈: https://jishuzhan.net/article/1988226029513670657
GitHub 开源的 Spec Kit (https://github.com/github/spec-kit)提供了一套比较成熟的工作流。