AI 写完代码没人看得懂？让 PR 先讲清楚为什么再说怎么做

AI 写代码最让人崩溃的瞬间，不是它写错了，而是 PR 里 600 行 diff，reviewer 看完只问一句：「所以你到底为啥这么改？」需求躺在聊天记录里，方案埋在 Claude 的 context 里，代码上线了——但”为什么”没人记得。

Fission-AI 的 OpenSpec 就是来解决这件事的：它在你的代码库里塞一个轻量级的”规范层”，所有需求、方案、任务清单都以结构化 Markdown 的形式跟代码一起 commit。

它到底解决了啥

GitHub Spec Kit、Kiro、Task Master 那一波”规范驱动开发”工具已经证明方向是对的——但太重了。OpenSpec 的定位很清晰：比 Spec Kit 轻、比 Kiro 开放、比裸 prompt 靠谱。

核心思想：人 + AI 先对齐”做什么”，再动代码。

每次改动生成一个文件夹 openspec/changes/<feature>/，里面四件套：

• proposal.md —— 为什么要做、改什么
• specs/ —— 需求 + Scenario（EARS 风格的 SHALL/WHEN/THEN）
• design.md —— 技术方案
• tasks.md —— 实施 checklist

实施完跑 /opsx:apply，每条 task 勾完 AI 自动验证一致性，最后 /opsx:archive 把改动归档到 openspec/specs/<feature>/。

它有多”开放”

支持 30+ AI 编程工具：Claude Code、Cursor、Codex、GitHub Copilot、Gemini CLI、Windsurf、OpenCode、Qwen Code、RooCode、Amazon Q…… 一行 openspec init 就把对应工具的 slash commands 写好。

不需要 API key，不依赖 MCP，纯本地 CLI。specs 就是 Markdown，git 管，code review 时跟代码一起看 diff。

30 秒上手

npm install -g @fission-ai/openspec@latest   # Node >=20.19
cd your-project
openspec init                                  # 选你的 AI 工具

然后在 Claude Code 里说：

/opsx:propose add-user-export

AI 自动生成 proposal/specs/design/tasks 四件套给你 review，确认后才动代码。

为什么推荐它

跟 superpowers 比——superpowers 管”怎么写代码（TDD、subagent、debug）”；OpenSpec 管”为什么这么写代码”。两者互补，但 OpenSpec 这个赛道在 2026 年 stars 从 23k 飙到 66k+，说明团队真在用它治”AI 改完没人看得懂”的病。

它不锁你工具、不绑你模型、不藏你需求。spec 就是仓库里的 Markdown，git 推哪儿它跟到哪儿。

📦 GitHub：Fission-AI/OpenSpec

如果你团队已经在被”AI 改的代码没人 review”折磨，今天就 npm i -g 跑一下 openspec init——很可能这就是你们缺的那块。

GitHub: https://github.com/Fission-AI/OpenSpec