ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

三步接上 OpenSpec:让 Claude 和 Copilot 按规范写代码的指南

三步接上 OpenSpec:让 Claude 和 Copilot 按规范写代码的指南 三步接上 OpenSpec让 Claude 和 Copilot 按规范写代码的指南【免费下载链接】OpenSpecSpec-driven development (SDD) for AI coding assistants.项目地址: https://gitcode.com/GitHub_Trending/op/OpenSpecOpenSpec 是一个面向 AI 编程助手的规范驱动开发框架。它先把想法变成规格文档再拆成可勾选的任务让 AI 的每次编码都有据可查。这篇文章带你完成安装、初始化并接上 Claude 和 GitHub Copilot。先说问题。只用对话提示词给 AI 派活时需求只存在于聊天记录里。换个会话上下文就丢AI 容易做出偏离项目意图的东西做出来的结果也没有验收标准。OpenSpec 的做法是把需求从聊天里挪进项目specs/存当前行为changes/存每次变更两者都是能提交进仓库的 Markdown 文件。一条命令完成 OpenSpec 安装环境要求很简单Node.js 20.19.0 或更高用node --version检查。npm install -g fission-ai/openspeclatest然后进入项目目录初始化。--tools后面接你正在使用的 AI 工具多个用逗号分隔cd your-project openspec init --tools claude,cursor初始化后项目会多一个openspec/目录specs/存规格文档changes/存每个变更的提案、规格差异、设计和任务清单config.yaml存项目配置。用 pnpm、yarn 或 bun 装包也可以详见安装文档。用一个变更看懂机制规范驱动开发的核心闭环是三步规格、变更、任务。规格specs/下的文件按“需求 场景”描述系统当前行为格式是纯 Markdown不需要学新语法。变更要加功能时让 AI 建一个新变更。以“加深色模式”为例在 AI 聊天框输入/opsx:propose add-dark-mode会在changes/下生成一个文件夹包含 proposal.md为什么做、specs/新增、修改、删除了哪些需求、design.md技术上怎么做、tasks.md执行清单。任务/opsx:apply让 AI 按任务清单逐条实现并打勾。全部完成后/opsx:archive把规格差异合并进specs/变更文件夹移入 archive 目录留档。完整路径是/opsx:propose→/opsx:apply→/opsx:archive。关键收益在于写代码之前你能审的是计划方向错了改的是几行规格而不是几百行代码。默认配置里还有/opsx:explore想法不清晰时先让 AI 读代码、评估方案把模糊想法磨成具体计划。该选哪个 AI 工具OpenSpec 支持 30 多种 AI 工具。openspec init时它会把命令文件和技能文件写进每个所选工具的配置目录常用工具如下工具接入方式适用场景Claude Code命令写入.claude/commands/opsx/调用形式/opsx:propose交互式会话先规划后编码Cursor写入.cursor/commands/opsx-*.md调用形式/opsx-proposeIDE 内边写边查GitHub Copilot写入.github/prompts/opsx-*.prompt.mdIDE 扩展识别为自定义斜杠命令VS Code、JetBrains 日常开发Codex仅技能写入.agents/skills/openspec-*/调用形式$openspec-propose终端式任务执行同一个命令在各工具里拼写略有不同以openspec init输出的提示为准。完整工具清单和目录结构见支持工具文档每个工具对应一个适配器如 Claude 适配器。规格怎么写四个要点规格初稿由 AI 写你的工作是审。四个容易踩的点写行为不写代码。规格描述“系统在什么情况下做什么”怎么做留在 design.md。一条需求一个可验证行为。用 SHALL/MUST 表述每条需求配 GIVEN/WHEN/THEN 场景其中至少覆盖一个异常分支。一个变更一个意图。一句话说不清的变更就拆开小变更更容易审也更容易一次实现完。边界和目标同样重要。调/opsx:propose时写明“不动现有的主题接口”能限制 AI 的改动范围。规格的结构模板在 schema.yamlAI 按它生成初稿instruction-loader.ts 负责把这些指令解析后注入 AI 的上下文。盯住状态几条常用命令开发过程中在终端查看进度openspec view打开交互式仪表板显示规格与需求数量、进行中的变更和任务完成率openspec status openspec validatestatus显示某个变更各产物的完成情况validate检查规格格式问题校验规则在 validator.ts。下一步OpenSpec 的思路不复杂需求从聊天搬进仓库拆成规格、变更、任务AI 逐条执行并留档。装好之后跑通一个完整变更就能体会到差别。本仓库的 openspec/specs/ 目录保存了它自身的全部规格可以直接翻。【免费下载链接】OpenSpecSpec-driven development (SDD) for AI coding assistants.项目地址: https://gitcode.com/GitHub_Trending/op/OpenSpec创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表