用 Claude Code、Codex 这类编码助手写代码，最烦的一种情况是它写得很溜，方向却理解偏了。你脑子里想的是 A，它理解成 B，等你回过神，已经改了一大片。OpenSpec 就是冲着这个来的：让 AI 在动手之前，先把「要做什么」写成一份可读的规范，然后照规范来。
是什么
OpenSpec 是 Fission-AI 开源的规范驱动开发（Spec-Driven Development）框架，MIT 协议、TypeScript 写的。目前 7 万多个 Star，最新版本 v1.13.2 发布于 2026 年 9 月，提交一直很密。它本身不写代码，干的是给智能体「套规矩」的那一层：你把想法讲给它，它帮你产出 proposal（为什么做、改什么）、specs（需求与场景）、design（技术方案）、tasks（任务清单），你审完再让它动手。
它接的是目前主流的编码助手，Claude Code、Codex、Cursor 这些都能用。工作流是几条斜杠命令：/opsx:explore 探路、/opsx:propose 出方案、/opsx:apply 落地、/opsx:archive 归档。有点意思的是，OpenSpec 自己就是用 OpenSpec 开发的，仓库里那份 specs 目录就是活的样板，不是纸上谈兵。
OpenSpec 仓库首页。TypeScript 主仓、MIT 协议，README 里直接放了完整工作流示例
它到底好用在哪儿
首先是「提案即计划」。你敲一句 /opsx:propose add-dark-mode，它就在 openspec/changes/ 下建一个目录，里面把 proposal、specs、design、tasks 一次性铺开。以前是你和 AI 一边聊一边写，聊到哪算哪；现在是先有一份白纸黑字的方案，你点头了才进入编码。错在方案阶段，比错在代码阶段便宜太多。
其次是规格本身就是契约。它写的是纯 Markdown，需求用 WHEN/THEN 的场景来描述，比如「当用户点主题开关时，应用切到深色并把选择持久化」。这种写法看着朴素，好处是 AI 写完代码后能逐条对照场景验收——需求有没有被漏掉，一眼能看出来，不用你去翻 diff 猜。
第三是跨仓库的 Stores。一个功能经常横跨 API 服务、前端应用、共享库三个仓库，规划却只能在一处做。Stores 把这套 openspec/ 结构放到一个独立仓库里，用 git push 共享，平台团队维护规范，业务团队只读引用，写代码的智能体也能直接读到。这比散落各处的 Wiki 靠谱得多。
第四是归档不漂移。功能做完跑 /opsx:archive，这次变更会被归档，对应的规范同步更新。这样一来，spec 始终描述的是「现在系统该是什么样」，不会越积越旧，成了没人看的死文档。
Releases 页面。v1.13.2 之后小版本走得很勤，修复和流程改进都写得很细
怎么用
最省事的就是一行命令：npm install -g @fission-ai/openspec，然后在项目根目录跑 openspec init，它会问你想接哪几个编码助手，顺手把斜杠命令装好。之后在对话里 /opsx:propose "你的想法" 起个头就行。Node 环境是硬要求，版本别太旧。
它走的是「先探路再提案」的路子，所以你也可以先 /opsx:explore 让 AI 看看你的代码结构，聊清楚了再让它正式出提案。整个过程里 AI 只负责产出草案，拍板的是你。
不足也得说清楚
第一，新工作流是最近重建的。作者把整套东西换成了 artifact-guided 的 opsx 流程，网上不少老教程还在讲旧命令，照着走容易懵。上手前最好先看官方 docs 目录，别拿第三方博客当准。
第二，它高度依赖自觉。如果你提案出来看都不看就直接 apply，那 OpenSpec 对你就是个「生成一堆没人读的 Markdown」的工具，反而多了一道工序。它治的是「先想清楚再动手」这个习惯，习惯不在这儿，工具帮不上忙。
第三，团队推广有成本。规范一旦存在，就得有人维护、有人 review，否则很快就和代码脱节。小项目一两个人无所谓，大团队要真用起来，得先约定好谁负责哪块规范。另外它只解决「规划」这一段，代码质量、测试这些还得靠别的。
跟同类怎么比
最像的是 Claude Code 自带的 plan 模式。两者都让你在编码前先看计划，区别在于 plan 模式是一次性对话里的临时计划，聊完就散了；OpenSpec 把计划落成仓库里的文件，能进版本控制、能被复用、能跨仓库共享。要长期维护的项目，文件比对话靠谱。
再对比 GitHub 的 Spec Kit 这类方案，思路接近，差别更多在生态和手感上。OpenSpec 更强调「流动而非僵化、迭代而非瀑布」，也照顾了存量项目（brownfield），不是只给全新项目用。如果你本来就在用 Claude Code 或 Codex，又想给团队一套能沉淀下来的规范流程，OpenSpec 值得装来试试——7 万 Star、版本到 v1.13.2、天天有提交，方向是认真的。
GitHub：https://github.com/Fission-AI/OpenSpec
官方网站：https://openspec.dev
标签：#OpenSpec #AI编程 #规范驱动开发 #编码助手 #TypeScript #开源工具 #团队协作
你更愿意让 AI 边聊边写，还是先出一份规范让你审完再动手？