
3条命令、4个节点多AI编程助手的规范驱动开发协作【免费下载链接】OpenSpecSpec-driven development (SDD) for AI coding assistants.项目地址: https://gitcode.com/GitHub_Trending/op/OpenSpecOpenSpec 是一个面向多个 AI 编程助手的规范驱动开发工具它把团队认可的规范沉淀成纯 Markdown 文件让 Claude Code、Cursor、Copilot 里不同的 AI 基于同一份文件干活变更有迹可循进度一眼可见。下面用一个真实需求——给搜索结果页加一个过滤器——把它走一遍。 节点一提出。/opsx:propose 让AI先交计划书再碰代码让AI直接写代码的风险是它自信地朝你想的反方向跑——而你在聊天框里只能事后发现。OpenSpec 的做法是把要做什么提前落成文件评审通过前一行代码都不写。上手只需要两条命令全局安装后在项目里初始化它会自动识别你在用哪些 AI 工具并生成对应的斜杠命令与代理指令如 AGENTS.md各家的 AI 从此读同一套规则。npm install -g fission-ai/openspeclatest openspec init然后你在 AI 聊天框里输入/opsx:propose add-search-filter。AI 不会打开编辑器而是建好 openspec/changes/add-search-filter/ 这个文件夹里面四样东西proposal.md 讲为什么做、范围到哪specs/ 里是delta 规范用 ADDED/MODIFIED 标记相对现状改了什么行为design.md 讲技术方案tasks.md 是带勾选框的实现清单。你翻完这堆文件、确认无误才算点头。 节点二评审。delta 规范和代码一起进PR先看意图再看实现评审最容易翻车的时刻是开了四十分钟才有人问这功能到底要干什么。OpenSpec 把这个问题提前到看任何一行 diff 之前——因为一个变更就是一个普通文件夹OpenSpec 本身不碰 git你完全按现有流程走分支和 PR。具体做法变更文件夹和代码放在同一个分支PR 里既有 spec delta 又有代码。评审顺序建议是——读 proposal.md问题选对了吗范围对吗读 specs/ 下的 delta完成的定义对吗最后读代码 diff实现恰好交付了这些需求吗。对方案有异议的同事可以直接对着 proposal 提不用在三百行代码里翻烧饼。半年后回头看归档的规范还能解释代码为什么长这样。️ 节点三实现。/opsx:apply 照任务清单干活tasks.md 就是进度条做完了吗在没有共享清单时永远是薛定谔问题。tasks.md 里的勾选框就是这个问题的答案/opsx:apply时 AI 逐条执行并回填勾选状态谁在哪个工具里干活进度都写在同一个文件里。它省掉的麻烦是不用在群里问进度也不用担心 AI 做到一半跑偏——CLI 负责确定性的脚手架和状态AI 只负责执行。而且流程是流动的不是锁死的阶段门实现中发现当初的假设错了随时回头改 plan 里的任何一份文件再回来继续。️ 节点四归档。/opsx:archive 把批准的更新合回主规范两个人各自归档同一个需求谁的版本会留下来这是多人协作里最疼的漏洞OpenSpec 分两层堵。第一层是隔离不同的变更是不同的文件夹、不同的分支互不打架约定一个变更只留一个负责人。第二层是校验变更在验证阶段会记录它基于的主规范内容指纹归档时重新比对——如果别人已经改过同一条需求规范出现分歧归档会被拦下来而不是静默覆盖两个变更真的改了同一条需求时第二个归档会在 openspec/specs/ 里产生像 git 冲突一样的合并冲突留着能反映真实行为的那条。specs/ 目录是全团队唯一的事实来源/opsx:archive会先确认任务做完、必要时先 sync再把 delta 合进去把变更文件夹移进 openspec/changes/archive/ 并带上日期——历史全部留档可追溯。 进度在哪看openspec view 打开终端仪表盘周五站会要报进度你不想翻聊天记录——openspec view直接给你一个交互式仪表盘项目里有多少条规范、哪些变更正在进行、各自完成了几成任务、归档过的变更有哪些全部来自上面那些文件不需要任何人手动维护。不想开仪表盘时openspec list列活跃变更openspec show add-search-filter看单个变更详情。下周一站会前找一位用 Cursor 的同事在他机器上跑一次openspec view看进度条和你是不是同一根——是的话这套协作就算立住了。【免费下载链接】OpenSpecSpec-driven development (SDD) for AI coding assistants.项目地址: https://gitcode.com/GitHub_Trending/op/OpenSpec创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考