五分钟装好 OpenSpec先写规范再让 AI 写代码【免费下载链接】OpenSpecSpec-driven development (SDD) for AI coding assistants.项目地址: https://gitcode.com/GitHub_Trending/op/OpenSpec需求散落在聊天记录里AI 改完代码却没人对得上账。OpenSpec 帮你把需求变成可归档的 Markdown 规范文件你和 AI 先就要做什么达成一致再动手写代码覆盖 Claude、Cursor、GitHub Copilot 等 30 款 AI 编程助手。 五分钟装好环境并初始化先说结论装好只需要两行命令。确认环境需要 Node.js 20.19.0 或更高用node --version查看。注意原文常写 Node 16仓库实际要求更高。全局安装 CLInpm install -g fission-ai/openspeclatest cd your-project openspec initopenspec init会问你用哪些 AI 工具选好后它把命令文件写进对应目录。初始化完成后项目里多出一个openspec/目录specs/存放系统当前行为的规范唯一事实来源changes/存放进行中的变更config.yaml是项目配置。老项目也适用——不用先给整个代码库补文档只规范你这次要改动的部分。 核心机制一句话讲透OpenSpec 的核心玩法是规范先行、增量描述。比如你输入/opsx:propose add-dark-mode它就在changes/add-dark-mode/下生成proposal.md为什么做、specs/需求增量、design.md怎么做、tasks.md任务清单。需求增量用ADDED/MODIFIED/REMOVED三种小节标记archive 时自动合并回主规范。✍️ 怎么写出 AI 能读懂的第一份规范你不用手写/opsx:propose会出初稿你的工作是把它改好。一份合格的规范长这样Requirement需求一个行为、一个SHALL/MUST且可被外部验证。上传超过 10MB 时显示错误提示合格优雅地处理大文件不合格。Scenario场景GIVEN / WHEN / THEN的具体例子要覆盖出错路径不只写正常路径。两个关键习惯需求里别混进实现细节队列、库、表结构放design.md否则代码一换规范就过期一个变更只装一个意图需要说还有……就该拆成两个变更。细则见 docs/writing-specs.md。 接入 AI 助手Claude / Cursor / Copilot 配置对比openspec init一次就能配好多个工具差异只在命令写法/opsx:propose是标准名各工具拼法不同AI 工具你在聊天框输入OpenSpec 生成的文件Claude Code/opsx:propose.claude/commands/opsx/propose.md及.claude/skills/Cursor/opsx-propose.cursor/commands/opsx-propose.mdGitHub Copilot/opsx-propose.github/prompts/opsx-propose.prompt.md另外两个特殊拼法Codex 只有技能文件输入$openspec-proposeAmazon Q 输入opsx-propose。init结束时会打印你所选工具的正确拼法照着敲即可完整清单在 docs/supported-tools.md。 一次需求变更从提案到归档完整走法是四步全在 AI 聊天框里输入/opsx:explore # 可选想法还模糊时先让 AI 读代码、权衡方案 /opsx:propose add-dark-mode /opsx:apply # AI 按 tasks.md 逐项实现 /opsx:archive # 归档delta 规范合并进主规范explore是零风险思考搭档不生成任何文件专治AI 自信地做错东西。apply期间随时可以回头改proposal.md或specs/它们是普通 Markdown没有锁定阶段。archive把变更文件夹挪到openspec/changes/archive/YYYY-MM-DD-name/留作审计记录。这个仓库自己就用 OpenSpec 开发openspec/changes/archive/里躺着 70 多个真实变更可翻。 随时查看项目状态和进度终端里跑openspec view打开仪表板规范数量、进行中变更、任务完成度一目了然比翻文件夹快。配合两个命令openspec list看活动变更openspec status --change name看单个变更卡在哪。⚠️ 避坑清单新手最常踩的 4 个问题现象在终端输入/opsx:propose没反应。原因斜杠命令属于 AI 聊天框不属于终端。解法openspec ...敲终端/opsx:...敲 AI 聊天。现象斜杠命令不显示、不自动补全。原因命令文件没生成或助手启动时还没扫描到。解法项目根目录跑openspec update然后重启 AI 助手。现象归档时报MODIFIED ... omits scenario(s)。原因MODIFIED会整体替换需求块旧场景没跟着抄进来。解法把openspec/specs/domain/spec.md里仍有效的场景补进 delta。现象升级包之后AI 用的还是旧工作流。原因指令文件由已安装的 CLI 生成包没换文件不会更新。解法先npm install -g fission-ai/openspeclatest再在每个项目里跑openspec update。 下一步终端跑openspec view看一眼当前项目的规范与任务进度。从 docs/getting-started.md 走一遍完整流程卡住时查 docs/troubleshooting.md按现象对号入座。【免费下载链接】OpenSpecSpec-driven development (SDD) for AI coding assistants.项目地址: https://gitcode.com/GitHub_Trending/op/OpenSpec创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考