AI 编程时代的规范驱动开发:OpenSpec 实践指南
每天免费领 1亿 Token,白嫖DeepSeek、GLM、MiniMax、Kimi等大模型!
当 AI 都能提笔写代码了,咱们真正缺的是啥?其实不是生成代码的速度,而是人机之间那份靠谱的共识。
引言:大家肯定都遇过这种坑
每天免费领 1亿 Token,白嫖DeepSeek、GLM、MiniMax、Kimi等大模型!
你正开着 AI 助手写新功能,嘴上说两句,代码就出来了,瞅着还挺顺眼。但问题紧接着就来:
- 睡个觉回来继续写,刚才聊的那些上下文全丢了。
- 需求全塞在聊天记录里,换个时间问 AI,它给出的解释可能完全变了样。
- 同事凑过来一看,完全不知道这功能当初为啥这么写,背景是啥。
- 代码是跑通了,但背后那个“为什么”却没人说得清。
每天免费领 1亿 Token,白嫖DeepSeek、GLM、MiniMax、Kimi等大模型!
说到底,这不是 AI 不行,是咱们跟 AI 合作的姿势不对。
今天我想安利一个开源小工具 —— OpenSpec。它没什么玄乎的理论,就是想让“先定规范再写代码”这套逻辑,在 AI 时代真正能落地、好上手。
啥是规范驱动开发?
每天免费领 1亿 Token,白嫖DeepSeek、GLM、MiniMax、Kimi等大模型!
规范驱动开发(Spec-Driven Development)逻辑挺直白的:动手撸码前,先把系统要干啥写得明明白白。
这玩意儿不是新鲜货,像以前说的 BDD 或 ATDD 都是这套路。但在 AI 编程火了之后,这事儿有了新变数:
代码语言:javascript
AI代码解释
老办法:写文档 → 人去理解 → 写代码
AI 时代:说需求 → AI 去猜 → 出代码 → 然后就乱套了
毛病出在 AI 的“记性”上,它每次对话都是重新开始。如果需求只在聊天框里飘着,代码质量肯定忽高忽低。
OpenSpec 的作用,就是在你和 AI 之间钉死一个持久的共识层。
OpenSpec 是怎么设计的?
增量规范(Delta Specs)
每天免费领 1亿 Token,白嫖DeepSeek、GLM、MiniMax、Kimi等大模型!
以前写规范最头疼的是,改一点东西得翻整本书。
OpenSpec 搞了个“增量规范”的法子:
代码语言:javascript
AI代码解释
# 登录模块变更单
## 新加的需求
### 需求点:双重验证 (2FA)
用户登录时,系统必须得要第二个验证码。
#### 场景:需要输入 OTP
- 当:用户开了 2FA
- 且:账号密码都对
- 那么:弹个框让填 OTP
## 修改的需求
### 需求点:登录态过期
现在改成 30 分钟不动就踢掉。
(以前是 60 分钟)
## 删掉的需求
### 需求点:记住我
(为了安全,有了 2FA 就不搞这个了)
这么搞有几个好处:
- 一目了然:到底改了哪儿,一眼定乾坤。
- 好收拾:干完活能自动合并到大文档里。
- 有据可查:所有的黑历史都存在归档里,随时翻旧账。
靠“物件”说话的工作流
每天免费领 1亿 Token,白嫖DeepSeek、GLM、MiniMax、Kimi等大模型!
每一次功能变动都是个文件夹,里面装着四个宝贝:
代码语言:javascript
AI代码解释
openspec/changes/搞个深色模式/
├── proposal.md # 动机:为啥做,做多少
├── specs/ # 规范:具体的活儿(增量格式)
├── design.md # 方案:技术上怎么实现
└── tasks.md # 清单:一步步怎么干
这几个物件的关系是这样的:
代码语言:javascript
AI代码解释
提案 ───► 规范 ───► 设计 ───► 任务 ───► 开搞
│ │ │ │
为啥 干啥 咋干 步骤
│ │ │ │
└──────────┴──────────┴────────────────┘
中间发现不对随时回头改
重点在这:这些东西不是写完就死的文档,而是活的进度条。你可以随时跳回前面去修正,因为干活的时候发现设计有问题太正常了。
怎么爽怎么来的工作流
OpenSpec 不想把人教条死,它主打一个顺手:
代码语言:javascript
AI代码解释
想快点搞定:
/opsx:propose ──► /opsx:apply ──► /opsx:archive
还没想清楚:
/opsx:explore ──► /opsx:new ──► /opsx:continue ──► ...
没有那种不走完第一步不给走第二步的死板限制:
- 用
/opsx:propose连招直接出全套。 - 用
/opsx:explore先跟 AI 瞎聊摸摸底。 - 用
/opsx:continue慢慢磨细节。 - 用
/opsx:verify临走前对对账,看代码跟规范对不对得上。
练手:给项目加个深色模式
每天免费领 1亿 Token,白嫖DeepSeek、GLM、MiniMax、Kimi等大模型!
咱们来实战一把。
1. 发起提案
代码语言:javascript
AI代码解释
你: /opsx:propose add-dark-mode
AI: 文件夹建好了 openspec/changes/add-dark-mode/
✓ proposal.md — 动机和范围
✓ specs/ — 需求细则
✓ design.md — 方案设计
✓ tasks.md — 活儿都列好了
老板,随时开工!
2. 瞅瞅有没有毛病
看看 AI 给出的 proposal.md:
代码语言:javascript
AI代码解释
# 提案:增加深色模式
## 目的
用户抱怨晚上看太晃眼,得搞个黑色的。
## 范围
要做:
- 开关切换
- 跟随系统设置
- 换了浏览器也能记住
不做:
- 还没想好怎么搞自定义颜色
- 暂不支持某些老旧页面
要是觉得哪儿不对,直接改文件,AI 下次就按你的新意思来。
3. 开工
每天免费领 1亿 Token,白嫖DeepSeek、GLM、MiniMax、Kimi等大模型!
代码语言:javascript
AI代码解释
你: /opsx:apply
AI: 撸起袖子干活中...
✓ 1.1 把 ThemeContext 弄出来
✓ 1.2 写好 CSS 变量
✓ 1.3 存进本地缓存
✓ 2.1 组件写好了
✓ 2.2 挂到设置页了
搞定收工!
4. 完活归档
代码语言:javascript
AI代码解释
你: /opsx:archive
AI: 正在封存 add-dark-mode...
✓ 增量规范已经并进主文档了
✓ 过程记录移到了 archive 文件夹
打完收工,等下一个活。
归档一做,规矩就立住了。以后谁问“当初深色模式咋想的”,让他去翻 archive 文件夹就行。
凭啥选 OpenSpec?
货比三家
比 GitHub Spec Kit:
Spec Kit 挺牛的,但太重了。得配环境、走严格流程,适合大厂正规军,咱们小步快跑的嫌它麻烦。
比 AWS Kiro:
Kiro 也不错,但它把你绑死在自家的工具里。OpenSpec 不挑食,你用啥编辑器都行。
比光着膀子硬干:
啥都不用的话,全靠跟 AI 对话。今天心情好它写得行,明天它可能就给你整出一段完全不搭的代码。
核心优势
- 共识第一:代码还没写,人和 AI 的想法先对齐。
- 不乱套:一个坑里只埋一个活,上下文稳稳的。
- 够灵活:流程是死的,人是活的,中间随时能变。
- 不挑工具:不管是 Cursor、Claude 还是 Copilot,都能跑。
技术上的那点亮点
架构
每天免费领 1亿 Token,白嫖DeepSeek、GLM、MiniMax、Kimi等大模型!
OpenSpec 分三层:
代码语言:javascript
AI代码解释
┌─────────────────────────────────────────────────────────┐
│ 指令层(打字的地方) │
│ openspec init | update | list | show | validate | view │
└─────────────────────────────────────────────────────────┘
│
┌─────────────────────────────────────────────────────────┐
│ 内核层(管逻辑的) │
│ 物件关系图 | 规范校验 | 格式处理 │
└─────────────────────────────────────────────────────────┘
│
┌─────────────────────────────────────────────────────────┐
│ 适配层(对插件的) │
│ Claude Code | Cursor | Windsurf | Copilot | ... │
└─────────────────────────────────────────────────────────┘
东西怎么关联
它是按一套 Schema 逻辑串起来的:
代码语言:javascript
AI代码解释
物件关系:
- 提案:谁都不靠,第一个建
- 规范:得看着提案写
- 设计:也可以看着提案写,跟规范可以一起搞
- 任务:得等规范和设计都定死再写
这个依赖关系不是锁链,是向导。它告诉 AI 什么时候该写啥,省得瞎搞。
动态指令
OpenSpec 最聪明的地方在于它不只会复读提示词:
代码语言:javascript
AI代码解释
以前:AI 每次都听那一套死话
OpenSpec:指令是现凑的
├── 项目背景(你用啥框架,习惯咋写)
├── 规矩(比如“没想好不许写代码”)
└── 模板(最后文件长啥样)
AI 会自己搜当前的状态,看活儿干到哪了,该出啥主意。
团队怎么合作?
自己一个人干
每天免费领 1亿 Token,白嫖DeepSeek、GLM、MiniMax、Kimi等大模型!
个人开发者用它也没毛病:
- 过了两周再开电脑,看一眼
proposal.md就知道这活儿干到哪了。 - 任务清单在那摆着,不会写着写着就跑偏。
- 归档就是你的成长日志。
团队一起干
人多的时候:
- 先看方案再写码:大家先对提案吐个槽,总比代码写完再改强。
- 各忙各的:几个功能并行做,文件各存各的,不打架。
- 新人好上手:新来的看一遍 archive,以前的坑基本都能避开。
公司里用
它还支持:
- 自己定规范模板。
- 整个项目的统一配置。
- 纯本地运行,不用担心代码被传到哪儿去。
几条避坑指南
别把活儿搞太大
每天免费领 1亿 Token,白嫖DeepSeek、GLM、MiniMax、Kimi等大模型!
一个变更只干一件事。别想着“加功能 A 的时候顺便重构一下 B”。
为啥?
- 别人好 review。
- 归档记录干净。
- 万一要撤销,不至于连累别的功能。
起名别瞎起
代码语言:javascript
AI代码解释
好名字: 别这么叫:
add-dark-mode feature-1
fix-login-redirect update
optimize-query changes
名字起好了,搜起来才方便。
灵活对待
别把自己弄成文档奴隶。根据活的难易程度来:
简单模式:
- 随便写写需求。
- 划清界限别做多了。
- 定几个关键验收点。
严肃模式(涉及核心业务): - 涉及跨部门协作。
- 改了 API。
- 关乎安全隐私。
归档前核对一下
代码语言:javascript
AI代码解释
你: /opsx:verify
AI: 帮你看了一下...
全不全
✓ 12 个任务都打勾了
✓ 规范里的点代码里都写了
⚠ “超时自动登出”好像没写测试
对不对
✓ 跟我当初想的一样
✓ 边缘情况考虑到了
总结
─────────────────────
大毛病:0
小提醒:1
能归档不:行,但建议补个测试
这步不是为了拦着你,是帮你最后把把关。
怎么上手?
每天免费领 1亿 Token,白嫖DeepSeek、GLM、MiniMax、Kimi等大模型!
安装
Node.js 版本别太低,得 20.19.0 往上。
代码语言:javascript
AI代码解释
npm install -g @fission-ai/openspec@latest
初始化
代码语言:javascript
AI代码解释
cd 你的项目
openspec init
这步它会:
- 自动看你用了啥 AI 助手。
- 让你挑一个。
- 弄好
openspec/文件夹。 - 给 AI 装好那些斜杠命令。
怎么玩
直接对 AI 说:/opsx:propose <你想做的牛逼功能>
这就开搞了!
常用口令
| 命令 | 干啥的 | 啥时候用 |
|---|---|---|
| /opsx:propose | 一键规划全套 | 默认就选这个 |
| /opsx:explore | 瞎聊、找灵感 | 还没想清楚时 |
| /opsx:new | 只建个架子 | 想自己慢慢填 |
| /opsx:continue | 接着写下一个文档 | 一步步磨 |
| /opsx:ff | 快速补全所有规划 | 需求很明确时 |
| /opsx:apply | 开工写代码 | 文档定好了 |
| /opsx:verify | 自查实施情况 | 封存前 |
| /opsx:archive | 把活儿并进去 | 全干完了 |
| CLI 常用命令: | ||
| 代码语言:javascript | ||
| AI代码解释 |
openspec list # 看看手头有哪些活
openspec show <name> # 瞅瞅细节
openspec validate # 查查格式对不对
openspec view # 打开可视化面板
说在最后:AI 编程到底在搞什么?
每天免费领 1亿 Token,白嫖DeepSeek、GLM、MiniMax、Kimi等大模型!
AI 助手确实越来越神,但咱们跟它打交道的方式还是太原始了 —— 全靠嘴说,说过就忘。
OpenSpec 给了个新思路:别光想着让 AI 猜你在想啥,得学着把你的想法定格下来。
这可不是让你回去写那堆没人看的臭长文档。OpenSpec 追求的是“够用就行”—— 要顺滑、要能改、要简单。
如果你也想让 AI 编程变得不再像开盲盒,而是稳稳当当、有迹可循,那就试试 OpenSpec 吧。毕竟在代码漫天飞的今天,能把大家的想法统一起来,才是最牛的本事。
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。
更多推荐


所有评论(0)