总结一下,之前我提过自己通过一个 AGENTS.md 文档实现 SDD(规范驱动开发),在经过了几个项目的开发,以及比较系统的迭代之后,我将这套方法论提炼为 SPEC-AGENTS.md。并发布到 Github 上,作为开源项目,希望能够帮助有需要的人。
---如下是该项目的简短说明---
本项目受 Spec-kit、OpenSpec、Stack Workflow 启发而来,兼具「规范驱动开发」和「阶段性开发」的优势,通过简单的配置,让普通小白在氛围编程(Vibe Coding)时,提升 AI 执行任务的准确性,减少与 AI 重复输(chao)入(jia)的次数,享受成熟的软件开发流程的稳定、便利。
# 特点
- 零配置
- 自然语言沟通
- 体积小,节省 TOKEN
- 成熟的软件项目开发流程
- 支持多个编程工具
- 项目记忆
使用 SPEC-AGENTS 还相当于你的开发项目拥有了「记忆」,而不必担心切换开发工具之后,就很难再进行当前的开发进度。只要让 AI 通过阅读文档,就能够清楚地知道当前的项目状况,以及开发进度。
# 原理
与 OpenSpec 类似,SPEC-AGENTS.md 将开发分为不同的阶段,并约定「文档驱动开发」的工作流:先在 .phrase/phases/ 中用自然语言写好 spec_* / plan_* / task_* 等文档,再由代理按任务执行实现与验证,最后回写 task_* / change_* / spec_* / issue_* / adr_*,形成可追溯的闭环。
当你在项目中放置 AGENTS.md 后,支持该协议的 AI 工具会在会话开始时读取其中规则,把它视为“开发助理使用说明”:
- 所有需求与接口信息只以文档为准,而不是零散对话;
- 每次对话只处理一个 taskNNN 原子任务;
- 每个任务完成后,都在变更文档中登记验证方式和影响范围。
通过这一套约束,SPEC-AGENTS.md 把传统团队里的 spec / task / change / issue 流程,压缩成一个轻量的文本协议,让个人或小团队也能在「氛围编程」状态下享受成熟的软件工程体验。
---
查看评论区获得项目网址。