OpenSpec 规范驱动开发指南：3 步跑起来 + 4 个必看的坑

OpenSpec 规范驱动开发指南3 步跑起来 4 个必看的坑【免费下载链接】OpenSpecSpec-driven development (SDD) for AI coding assistants.项目地址: https://gitcode.com/GitHub_Trending/op/OpenSpecOpenSpec 是一个面向 AI 编码助手的规范驱动开发SDD工具你先和 AI 把要做什么、怎么做谈拢写成可检查的规范文档它再动手改代码完成后把结果归档回主规范。AI 改代码前先对齐需求用过 AI 编码助手的人大概都遇到过这种情况你一句话提了个想法它直接开写方向偏了推倒重来。问题不在模型能力在于需求从没落成可检查的东西。OpenSpec 把流程反过来AI 先产出改动计划你看完点头它才执行结束后还会把这次到底改了什么行为合并回主规范。整个闭环只有四个斜杠命令/opsx:propose 改动名—— AI 生成 proposal.md为什么做、范围、增量规范、design.md怎么做、tasks.md任务清单/opsx:apply—— 按任务清单逐项实现/opsx:archive—— 把增量规范合并回主规范改动文件夹归档如果还没想清楚做什么先用/opsx:explore让 AI 读代码、帮你把模糊想法收敛成具体方案再进入 propose。最短上手路径10 分钟内跑通第一个改动这一节给你从零到归档的最短路径存量项目直接适用不用提前准备任何东西。终端里两步npm install -g fission-ai/openspeclatest cd your-project openspec init要求 Node.js 20.19 以上。init会生成openspec/目录并为你选的 AI 助手写好命令入口。之后全程在 AI 聊天框里/opsx:explore可选——让它先摸清你要动的那块代码/opsx:propose add-dark-mode——生成计划你审查/opsx:apply—— 开始实现/opsx:archive—— 合并规范、归档改动默认画像只含 explore / propose / apply / update / sync / archive 六个命令够用想解锁verify、bulk-archive、onboard等扩展命令用openspec config profile选画像再跑openspec update。核心机制增量差异而不是全量文档看完这节你就明白为什么它不要求你先给整个系统写文档。openspec/specs/—— 系统当前行为的记录按领域分目录如auth/、ui/openspec/changes/改动名/—— 每次改动一个独立文件夹互不干扰天然支持并行每个改动文件夹里的四类工件互相依赖工件管什么proposal.md为什么做、做什么、大致思路specs/相对现状的增量差异design.md技术方案tasks.md可勾选的实现清单增量规范长什么样它不描述整个系统只描述和现在比变了什么用 ADDED / MODIFIED / REMOVED 三段标注每条需求配具体场景ADDED用户登录时系统必须要求二次验证。 场景前提2FA 已开启→ 动作提交正确账号密码→ 结果弹出验证码。归档时自动合并新增的追加、修改的替换、删除的移除改动文件夹移入changes/archive/留作审计。规范就是这样一次改动、一层一层长起来的。跑openspec view可以看全局视图跨 AI 工具命令写法差异与存量项目落地四个高频坑全是新手真实会踩的。命令写法因工具而异。同一个/opsx:propose在 Cursor、GitHub Copilot 里写成/opsx-proposeAmazon Q 是opsx-proposeCodex 是$openspec-propose。init结束会在终端打印你所用工具的正确写法照着敲即可详见 supported-tools 文档。两个地方别混。openspec开头的命令在终端执行/opsx:开头的在 AI 聊天框执行。新手卡住大多因为找错了地方。存量项目不用补全量规范。8 万行老代码不必先写文档。挑一个本周本来就要做的小改动走一遍完整流程归档后你就有了这块的第一份规范其余等以后碰到再补。团队约束写进配置。在openspec/config.yaml里放一段 context技术栈、测试方式、约定和 rules比如提案必须附回滚方案之后每次生成工件时自动注入给 AI不用口头反复交代。适用边界什么时候值得上什么时候别硬套帮你判断该不该上这套流程。适合项目里有 AI 编码助手参与想给 AI 加先计划后动手的约束存量代码想慢慢补上可追溯的行为记录多人协作但需求文档总是漂移。不适合没有 AI 编码助手参与的传统流程多一层工具只有成本已经跑得很成熟的形式化需求流程硬套会多出一堆没人维护的文档。快速参考场景做法安装初始化终端npm install -g fission-ai/openspeclatestopenspec init还没想清楚做什么AI 聊天框/opsx:explore开始一个改动/opsx:propose 改动名审查后再/opsx:apply改动收尾/opsx:archive增量自动合并进主规范检查与查看终端openspec list/openspec validate 名/openspec view新手第一天建议装好 → 挑一个本周真实要做的小需求 → 完整走一遍四个命令。规范驱动开发这套流程的价值会在第二个改动上明显显现出来。【免费下载链接】OpenSpecSpec-driven development (SDD) for AI coding assistants.项目地址: https://gitcode.com/GitHub_Trending/op/OpenSpec创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考