🤖 OpenSpec：47k Stars 的 Spec-Driven Development 框架，先写方案再编码，AI 编程不再翻车

🤖 OpenSpec：47k Stars 的 Spec-Driven Development 框架，先写方案再编码，AI 编程不再翻车

项目地址：github.com/Fission-AI/OpenSpec | ⭐ 47,588 Stars | TypeScript | 作者：Fission AI

老实说，跟 AI 结对编程最大的痛点是什么？不是模型不够强，是你刚说完需求，AI 已经开始写了一坨你不想要的东西。没有对齐预期，每次都在改方案和重来之间反复横跳。

OpenSpec 就是解决这个问题的——一个轻量级的 Spec-Driven Development（SDD） 框架，让你和 AI 在写代码之前先对齐方案。47k Stars 不是白来的。

先对齐，再写代码

OpenSpec 的精髓就一句话：Agree before you build。它不会约束你用什么样的流程，也不会逼你走瀑布模型，而是在项目里创建一个 openspec/ 目录，每次改需求都生成一套方案文档。

安装只需要一行：

npm install -g @fission-ai/openspec@latest

然后进项目目录初始化：

cd your-project
openspec init

搞定之后，跟 AI 说一句 /opsx:propose 加个暗黑模式，OpenSpec 就会自动创建方案文件夹，包含 proposal、specs、design、tasks 四件套。

You: /opsx:propose add-dark-mode
AI:  Created openspec/changes/add-dark-mode/
     ✓ proposal.md — 为什么做，改什么
     ✓ specs/       — 需求和场景
     ✓ design.md    — 技术方案
     ✓ tasks.md     — 实施清单
     Ready for implementation!

确认方案没问题，一句 /opsx:apply 就开始干活了。干完拿 /opsx:archive 归档，干净利落。

跟其他方案的区别

GitHub 出过一个 Spec Kit（97k Stars），功能是全面，但太重了——严格的阶段门控，固定流程，Markdown 仪式感拉满。OpenSpec 的设计哲学更灵活：

而且 OpenSpec 兼容 20+ 个 AI 工具，Claude Code、Codex、Cursor、Gemini CLI 都支持，不绑定平台。

一些有用的命令

查看所有变更：

openspec list

查看某个变更的详情：

openspec view add-dark-mode

验证方案有没有问题：

openspec validate

升级 OpenSpec 本身：

npm install -g @fission-ai/openspec@latest
openspec update

适合谁用？

总结

别整那些花里胡哨的流程了，OpenSpec 就是最轻量的方式让你和 AI 在写代码之前先吵完架。