
OpenSpec 实战4 步走通规范驱动开发的完整变更流程【免费下载链接】OpenSpecSpec-driven development (SDD) for AI coding assistants.项目地址: https://gitcode.com/GitHub_Trending/op/OpenSpec需求只写在聊天记录里AI 改到第三版时没人说得清产品到底要什么。OpenSpec 是面向 AI 编程助手的规范驱动开发SDD框架先把需求写成规范文件让人审审完再让 AI 照规范实现和验收。把需求当图纸核心机制类比施工队进场前先看图纸没有图纸施工队只会凭经验自由发挥拆错墙再返工。OpenSpec 把图纸放在项目的openspec/目录里specs/记录系统当前行为是图纸正本changes/下每个变更占一个文件夹里面放「增量规范delta spec」用 ADDED、MODIFIED、REMOVED 三种标记描述这次相对正本改了什么。变更完成归档时增量合回正本旧版本留档可查。全程只有 Markdown 文件OpenSpec 不碰 git提交、分支、合并照旧走你们现有的流程。初始化规范驱动开发怎么装进现有项目npm install -g fission-ai/openspeclatest cd your-project openspec init第一条全局安装 CLI第二条在项目里初始化生成openspec/目录并给选中的 AI 工具Claude、Cursor 等写入技能文件之后/opsx:系列命令就能在对应工具里用了。装完项目多了什么openspec/specs/按领域划分的行为规范如auth/、payments/openspec/changes/进行中的变更每个一个文件夹openspec/config.yaml项目级上下文会注入到每次 AI 请求里提出变更先让 AI 交图纸在 AI 对话里发起 /opsx:propose在 AI 助手的聊天框输入/opsx:propose add-dark-mode它会创建changes/下的同名文件夹一次生成四份「工件artifact」工件回答的问题proposal.md为什么做、范围多大specs/增量规范新增、修改、删除了哪些需求design.md技术上怎么做tasks.md实现清单带勾选框人在这一步只干一件事通读这四份文件。方案不对改proposal.md让 AI 重写确认通过才进下一步。怎么查看变更状态openspec status --change add-dark-mode这条命令按依赖顺序列出四份工件[x]已完成、[ ]待做、[-]被依赖阻塞一眼看出该先补哪份。实现与验收按清单干活按规范验收放行后输入/opsx:applyAI 按tasks.md的清单逐条实现并勾选。实现中发现设计不对直接改design.md再继续不强制回到起点。验收用两条命令openspec validate add-dark-mode openspec viewvalidate按结构规则查增量规范缺场景、坏标记都会报出来view打开交互式仪表板总览所有变更的进度适合团队同步时用归档变更规范驱动开发里怎么收尾实现完毕、任务清单全勾后/opsx:archive做三件事增量规范按 ADDED/MODIFIED/REMOVED 合入specs/正本变更文件夹挪到changes/archive/日期-名称/留档下次变更从最新正本继续。多人协作谁负责什么冲突在哪角色职责交互方式变更负责人人写需求、审图纸、放行实现、确认归档在 AI 对话里下/opsx命令评审者队友先读 proposal 和增量规范再看代码 diff在 PR 里评审计划和代码同分支提交AI 助手生成四份工件、按清单实现代码读config.yaml上下文和tasks.mdOpenSpec读写openspec/下的 Markdown不碰 git提交合并仍由人执行冲突规则很简单不同变更在不同文件夹互不干扰一个变更只认一个负责人两人改同一变更文件夹等同于改同一个文件真正的合并冲突只出现在主规范——两个变更改了同一条需求时后归档的那个会在specs/里撞出 git 冲突手动保留符合现状的版本即可这恰好提醒两个变更对系统行为有不同预期。卡住时先查这三个报错在终端输入 /opsx:propose 没有反应现象斜杠命令不存在或毫无反应。原因/opsx:命令在 AI 助手的聊天框执行openspec ...才是终端命令且技能文件是 IDE 启动时扫描的换项目后要重新生成。一句话解法命令挪到 AI 对话里执行再跑一次openspec update并重启 IDE。status 里 tasks 一直显示 blocked现象openspec status中 tasks 显示[-] tasks (blocked by: design)/opsx:apply报 No artifacts ready。原因工件有依赖顺序——proposal 解锁 specs 和 designtasks 需要 specs 和 design 都完成。一句话解法看 status 里第一个[ ]是谁补上那份依赖再继续。归档时报 User force closed the prompt with 0 null现象在 CI 或 AI 代理里跑openspec archive直接崩。原因归档会弹最多三次确认非交互环境没有 stdin 可回答。一句话解法显式传--yes如openspec archive add-dark-mode --yes。更多症状对照见 docs/troubleshooting.md校验逻辑在 src/core/validation/。最小启动清单Node.js 20.19 装好全局安装fission-ai/openspec在项目目录跑openspec initAI 对话里/opsx:propose change-name通读四份工件再放行/opsx:apply实现openspec validate校验/opsx:archive归档openspec/目录整体提交进 git让队友能评审规范单人项目照这份清单直接可用规划要跨多个仓库时再考虑 beta 的 Stores独立规划仓库。【免费下载链接】OpenSpecSpec-driven development (SDD) for AI coding assistants.项目地址: https://gitcode.com/GitHub_Trending/op/OpenSpec创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考