OpenSpec实战：5分钟让AI按规格写代码

OpenSpec实战5分钟让AI按规格写代码【免费下载链接】OpenSpecSpec-driven development (SDD) for AI coding assistants.项目地址: https://gitcode.com/GitHub_Trending/op/OpenSpecOpenSpecspec-driven development规格驱动开发解决的是一个很具体的问题AI 编程助手很强但它读到的需求往往只存在于聊天记录里。换一次会话、换一个工程师上下文就断了AI 开始自信地做错东西。OpenSpec 在代码和 AI 之间加了一层轻量规格先让 AI 把要做什么写成文档你审完再动手。它对终端工程师和个人开发者友好也支持跨仓库的团队协作beta。问题先说清楚需求只活在聊天记录里AI 为什么会跑偏不写规格时你的约束——别加新依赖默认跟随系统主题——散落在对话里随时可能被压缩掉。AI 没有稳定的事实来源只能凭最近几句对话猜。OpenSpec 的做法是把需求落成纯 Markdown 文件每条需求带具体场景WHEN/THEN 形式存在openspec/specs/目录里AI 和人读的是同一份东西。它比什么都不用多了什么每个变更独立建一个文件夹proposal.md为什么做、specs/需求增量、design.md技术方案、tasks.md勾选清单任何一份文件都可以随时回改没有僵硬的阶段门禁OpenSpec 仓库自己就在用这套流程openspec/specs/下有 36 个规格目录openspec/changes/里挂着 20 个进行中的变更可以直接当样例看5分钟上手2条命令 4个斜杠命令装好并初始化要求 Node.js 20.19.0 以上node --version查版本然后npm install -g fission-ai/openspeclatest cd your-project openspec initopenspec init会创建openspec/目录并询问你用了哪些 AI 工具为每个工具写好对应的指令文件。之后日常操作就回到 AI 聊天框里。核心循环4 个斜杠命令日常主线只有四个命令都在默认的 core profile 里/opsx:explore— 想法还不成熟时先聊AI 读你的代码库、列方案不产出任何文件/opsx:propose add-dark-mode— AI 生成完整的变更文件夹proposal/specs/design/tasks你审完计划它才开始写代码/opsx:apply— AI 按tasks.md逐条实现并打勾/opsx:archive— 归档变更把增量规格合并回主规格不确定做什么就先用 explore明确要做什么就直接 propose。完整演示见 docs/getting-started.md。想要更多步骤换 profile默认 profile 之外还有/opsx:new、/opsx:continue、/opsx:ff、/opsx:verify、/opsx:bulk-archive、/opsx:onboard等扩展命令。用openspec config profile选择再跑openspec update生效。换个 AI 工具命令要改着写同一个命令30 工具各有写法src/core/command-generation/adapters/目录里有约 30 个工具适配器Claude Code、Cursor、GitHub Copilot、Codex、Windsurf、Antigravity、Cline、Devin、Amazon Q 等。同一个动作在不同工具里拼法不同规范写法Cursor / GitHub CopilotAmazon QCodex/opsx:propose/opsx-proposeopsx-propose$openspec-proposeopenspec init结束时会自动打印你选的工具对应的正确写法不用背。完整清单在 docs/supported-tools.md。看进度openspec view终端里跑openspec view打开交互式仪表板规格统计、进行中的变更、任务完成度一目了然就是上面那张图的界面。团队协作场景还可以用 beta 版的 Stores把openspec/放进独立仓库git push后所有人和所有编码代理共享同一份计划适合一个功能横跨多个代码仓库的情况。高频疑问我的工具不在列表里 / 命令找不到先跑openspec update——它负责重新生成各工具的指令文件。还不行就看 docs/troubleshooting.md。怎么升级会不会影响我的自定义文件npm install -g fission-ai/openspeclatest升级包再进每个项目跑openspec update刷新指令。OpenSpec 管理的文件和你的自定义文件是分开的后者会被保留。要不要开遥测默认开启匿名统计只收集命令名和版本CI 下自动关闭。介意可以openspec config set telemetry.enabled false或设OPENSPEC_TELEMETRY0。下一步建议拿一个真实小需求比如加个配置项走一遍 explore → propose → apply → archive感受计划先行的节奏浏览openspec/changes/里已归档的真实变更看看 proposal 和 tasks 长什么样老项目brownfield想接入从 docs/existing-projects.md 的存量项目指南开始【免费下载链接】OpenSpecSpec-driven development (SDD) for AI coding assistants.项目地址: https://gitcode.com/GitHub_Trending/op/OpenSpec创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考