OpenSpec 规范驱动开发一套规范文件管住 20 个 AI 工具不互相打架【免费下载链接】OpenSpecSpec-driven development (SDD) for AI coding assistants.项目地址: https://gitcode.com/GitHub_Trending/op/OpenSpec先说个真实翻车场景A 同事上周用 Claude Code 给登录接口加了限流B 这周用 Cursor 在同一目录改代码AI 顺手把限流逻辑优化掉了——没有报错没有冲突提示合完码才发现功能没了。OpenSpec 这个项目干的就是防这一件事把规范驱动开发先写清楚要做什么、做到什么程度算完再让 AI 照单执行落成openspec/目录下的一堆纯 Markdown 文件让团队里所有 AI 编程助手都从同一份源头读需求。三条命令跑通多人协作环境这一步解决的是每个人工具不同、入口不同最后各写各的问题。装 CLI、初始化、刷新三步npm install -g fission-ai/openspeclatest openspec init openspec updateopenspec init会列出它支持的工具清单——目前覆盖 20 多个主流 AI 编程助手从 Claude Code、Cursor、GitHub Copilot 到 Codex、Windsurf。你在清单里勾上团队实际在用的它就把工作流命令写到各工具自己的目录里不支持斜杠命令的工具则走代理指令文件。入口写法五花八门底下的规范文件只有一份。openspec update用于换工具或升级后重新生成这些指令文件避免老命令还挂在旧版工作流上。动手前先写变更提案把验收标准钉死这一步解决 AI 自由发挥、做完了才发现方向跑偏的问题。用/opsx:propose 变更名各工具命令名略有差异生成openspec/changes/变更名/文件夹里面是三样东西proposal.md说清为什么改、改什么范围specs/下的增量规范用需求 场景的白话写验收标准tasks.md列出可勾选的实施任务。仓库里的 openspec/changes/ 目录就是现成样例随便挑一个文件夹看结构。没有规范时引入 OpenSpec 后需求靠 IM 和口头对齐AI 只能猜验收标准落在 Markdown 里AI 和人读同一份做错了返工代价是几百行代码方向错了在提案阶段推翻代价是一个文件夹变更散落在各人本地会话里每个变更一个文件夹进 git全程留痕评审提案而不是评审代码两分钟就能对完评审环节解决等 AI 写完三百行再提 PR方向错了没法谈的问题。评审顺序固定先读proposal.md判断问题找得对不对再读specs/下的增量确认完成的定义是否准确最后才看代码 diff 是否严格交付了这些需求。对方案有异议在提案上提成本极低规范没对齐就开工的扯皮基本消失。团队惯例文档在 docs/team-workflow.md可以直接抄。任务实施与合并让变更和代码走同一条分支实施阶段解决进度黑盒和并行冲突。用/opsx:apply让 AI 按 tasks 逐条做规范增量和代码改动落在同一个分支、同一个 PR 里评审一次看全。并行协作的边界很清晰不同变更在不同文件夹互不干扰同一个变更指定一个人负责别两人同时改一个文件夹。长期变更想早点让主规范可用可以手动跑/opsx:sync把增量合进 openspec/specs/短变更不用管归档时会顺手做。盯进度用这几条openspec view openspec list openspec show 变更名openspec view打开终端仪表盘总览、活跃变更进度、规范清单一屏看全仓库自己的示例变更里任务完成率跑到 73% 左右就是靠这个页面盯着推的。归档进主规范库动笔前先过一道校验归档解决做完的代码和规范对不上、事后说不清为什么这么写的问题。/opsx:archive会先检查任务是否全部勾选再执行内容指纹校验对比变更暂存区和目标规范的实际内容发现不一致就拦下不做静默覆盖任务没做完会提示先 sync防止半成品混进主规范。万一两个变更都改了同一条需求第二个归档时会在specs/里留下 git 冲突标记——这不算缺陷相当于 git 在提醒两个变更对系统行为理解不一致按合并冲突的正常方式解决即可。开工前对着勾一遍的清单每位成员都跑过openspec init勾选的工具和实际在用的对得上整个openspec/文件夹提交进 git规范和代码同版本团队定了归档时机PR 合并后归档推荐或 PR 内一并归档二选一换工具或升级 CLI 后补跑openspec update新需求先走变更提案存量功能的改动逐步纳入每天/每次开干前openspec view过一遍全局状态什么人该用什么人不该3 人以上、混用 2 种以上 AI 工具、需求反复迭代的团队值得花十分钟把 init 跑一遍——它的价值在规范冲突被拦在归档前而不是代码冲突被拦在上线前。单人项目或一次性脚本直接用 AI 裸跑更快这套流程的收益覆盖不了维护成本。【免费下载链接】OpenSpecSpec-driven development (SDD) for AI coding assistants.项目地址: https://gitcode.com/GitHub_Trending/op/OpenSpec创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
