如何为 GitHub Copilot 云端 coding agent 配置 OpenSpec（--copilot-cloud）？

如何为 GitHub Copilot 云端 coding agent 配置 OpenSpec--copilot-cloud【免费下载链接】OpenSpecSpec-driven development (SDD) for AI coding assistants.项目地址: https://gitcode.com/GitHub_Trending/op/OpenSpecGitHub 的 Copilot coding agent 运行在 GitHub 上的 GitHub Actions 环境里和你编辑器里的 Copilot 是两套东西。如果你的项目用 OpenSpec 管理 changes 和 specs而团队又习惯把任务直接派给 GitHub 云端的 coding agent就需要让 agent 在它自己的临时环境里能调用 OpenSpec CLI。OpenSpec 通过openspec init --copilot-cloud完成这件事它往你的仓库写入两个文件让云端 agent 自动安装并使用 OpenSpec。因为其中一个文件是 GitHub Actions workflow会实际改变仓库的 CI 行为所以该功能明确是 opt-in 的不选择就不会生成。先分清你要集成的是哪个 Copilot按 Supported Tools 的说明仓库里的 Copilot 相关产物分三层别混在一起目标OpenSpec 生成的产物说明IDE 扩展VS Code、JetBrains、Visual Studio.github/skills/、.github/prompts/opsx-id.prompt.mdprompt 文件在 IDE 扩展里作为自定义 slash command 识别Copilot CLI不直接消费.github/prompts/*.prompt.md文档明确说明当前不直接支持GitHub 云端 coding agent.github/workflows/copilot-setup-steps.yml、.github/agents/openspec.agent.md本文的任务通过--copilot-cloud开启也就是说就算你已经在init时勾选了github-copilot工具生成 skills 和 prompt 文件云端 agent 的文件也不会自动生成——必须额外显式选择。准备条件在终端安装 CLI版本以 Getting Started 给出的命令为准npm install -g fission-ai/openspeclatest然后进入你的项目目录。--copilot-cloud只对选中的工具生效如果这次init没有选择github-copilot工具该参数会被忽略OpenSpec 会提示 flag 未生效所以两条路径都要确保github-copilot在工具列表里。执行配置主路径非交互式脚本、CI 或想一步到位时用openspec init --tools github-copilot --copilot-cloud--tools github-copilot把 Copilot 设为唯一配置目标--copilot-cloud表示不弹确认直接生成云端 agent 文件。--tools支持all、none或逗号分隔的工具列表其他工具的用法见 CLI Reference。替代路径交互式openspec init在工具选择里选github-copilotOpenSpec 会询问“是否设置 GitHub Copilot cloud coding-agent 文件”默认是No确认要配置时选 Yes。两种方式的最终结果一致。反向操作关闭openspec init --tools github-copilot --no-copilot-cloud跳过生成并且移除之前由 OpenSpec 生成的云端文件。生成的两个文件各做什么文件作用.github/workflows/copilot-setup-steps.yml一个名为 “Copilot Setup Steps” 的 workflow在云端 agent 的临时 GitHub Actions 环境里执行npm install -g fission-ai/openspec安装 CLI并用openspec --version验证安装结果.github/agents/openspec.agent.md云端 agent 的配置告诉 agent 如何驱动 OpenSpec用openspec list --json、openspec status --change name --json、openspec instructions、openspec validate等命令查看和推进 changes第一个文件生成的核心步骤摘自生成内容src/core/github-copilot/cloud-agent.ts 中的模板steps: - name: Checkout code uses: actions/checkoutv4 - name: Install OpenSpec CLI run: npm install -g fission-ai/openspec - name: Verify OpenSpec CLI run: openspec --version生成的 workflow 支持手动触发workflow_dispatch并在 push/PR 改动到copilot-setup-steps.yml本身时自动运行用来验证安装步骤没有坏掉。选择会被持久化到哪里你在init时的决定会写进openspec/config.yaml见 Customization 中的示例结构githubCopilot: cloudAgent: true这个值之后由openspec update遵守且update从不弹确认cloudAgent: true或项目里已存在这两个文件→ 刷新文件内容明确选不cloudAgent: false→ 移除 OpenSpec 管理的云端文件。所以脚本和 agent 在 CI 里跑非交互的openspec update时行为和你当初的选择一致。验证配置是否生效按顺序检查三项init 的输出。命令结束时 OpenSpec 会列出实际写到磁盘的云端文件即上面两个路径。如果这两个路径下已存在你自己定制过的文件输出会明确告诉你文件被保留、未被覆盖而不是静默跳过。文件存在性。确认仓库里同时存在.github/workflows/copilot-setup-steps.yml和.github/agents/openspec.agent.md。配置持久化。打开openspec/config.yaml确认githubCopilot.cloudAgent为true。之后在 GitHub 侧可以手动触发 “Copilot Setup Steps” workflow 观察安装与openspec --version验证步骤是否通过通过后云端 coding agent 的临时环境就能执行openspec命令并读取仓库里的openspec/目录了。限制与边界默认不生成。交互式init的提问默认 No未选择github-copilot工具时--copilot-cloud不生效。只动自己生成的内容。OpenSpec 只会写入或移除内容为它生成的文件。你定制过的copilot-setup-steps.yml或openspec.agent.md或你已有自己的同名文件永远不会被覆盖或删除选出不时也如此只有 OpenSpec 管理的文件会被移除。改配置后记得 update。CLI 升级后用npm install -g fission-ai/openspeclatest再跑openspec update已选入的项目会同步刷新这两个文件见 CLI Reference 中update一节。相关文档Supported Tools、CLI Reference、Customization。【免费下载链接】OpenSpecSpec-driven development (SDD) for AI coding assistants.项目地址: https://gitcode.com/GitHub_Trending/op/OpenSpec创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考