跳转至

GitHub Copilot CLI 集成

面向 issue #147 的实验性适配器。工作流执行和审查者隔离尚未验证。本指南不确立对 VS Code 或云代理中 Copilot 的支持。

接口与安装

离线参考版本为 GitHub Copilot CLI 1.0.82。使用现有的 Agent Plugins 1.0 根 plugin.json。Copilot 专用配置文件位于 com.github.copilot/agents/。Issue #375 跟踪 VS Code 中 GitHub Copilot 的实验性工作区发现功能。.vscode/settings.json 使用两个已弃用的兼容性设置。chat.agentSkillsLocations 映射 skills。chat.agentFilesLocations 映射 com.github.copilot/agents。共享的技能、角色和标准仍保留在 skills/、agents/ 和 resources/ 中。

在固定的候选提交上使用完整检出。在会话运行期间保持该检出。不要只复制 skills/,也不要单独安装配置文件目录。根清单优先于 Claude 兼容性清单。不需要 Copilot 钩子、MCP 服务器或替代清单。

将 EGM_ROOT 设置为候选检出的绝对路径:

EGM_ROOT=/absolute/path/to/elephant-goldfish-model
git -C "$EGM_ROOT" rev-parse HEAD
copilot --version
COPILOT_OFFLINE=true copilot --plugin-dir "$EGM_ROOT" plugin list

最后一条命令必须在外部插件下列出 egm。它检查的是注册情况,而非审查者的执行情况。如需单独的配置文件,请将 COPILOT_HOME 设置为新目录。这不会禁用所有用户级技能或项目指令。在任何实测之前,请检查宿主清单。

在明确授权使用模型后,从目标项目启动 Copilot:

copilot --plugin-dir "$EGM_ROOT" --add-dir "$EGM_ROOT" --agent egm:egm

在第一条消息中,提供绝对包根路径和所请求的技能:

EGM package root: /absolute/path/to/elephant-goldfish-model
Read that package's docs/copilot.md and run egm-brainstorm.
EGM artifact directory: .dev/docs

在后续请求中使用 egm-draft 或 egm-review。提供要审查的目标文档。使用 egm:egm 入口代理,以便在技能之前加载宿主映射。将审查者选为主会话并不会建立全新的 Goldfish 上下文。使用前请检查 /agent 是否存在名称冲突;个人配置文件可能覆盖包配置文件。

已验证的离线路径使用 --plugin-dir。通过 copilot plugin install 进行的持久安装仍未验证。1.0.82 版的帮助信息没有说明本地路径安装,尽管当前的 GitHub 文档有说明。不要推断更新的命令接口在此版本上可用。

资源路径

从挂载的检出或原生插件清单解析包根路径。对于发现的 skills/<skill>/SKILL.md,向上移动三个父目录。在委派之前,从该根路径阅读指南和标准技能。

  • 根据包根路径解析 agents/、resources/ 和 docs/。
  • 根据技能所在目录解析该技能的 references/。
  • 根据项目工作目录解析用户文档。
  • 向审查者传递绝对路径,包括包根路径、目标和标准。
  • 保留路径中的空格和 Unicode 字符。不要按空白字符拆分路径。
  • 如果任何所需资源不可用,请停止。切勿用项目文件代替。

配置文件中的 <EGM_ROOT> 是任务提供的路径,而不是环境变量展开。此适配器不假设 Copilot 会在 Markdown 正文中展开变量。

原生委派

使用 Copilot 的原生自定义代理委派工具。检查其暴露的 schema。通过其命名空间 ID 选择已注册的配置文件;不要凭空编造工具参数。将每个标准角色名称映射到 egm:<name> 以进行原生委派。入口配置文件允许将 agent 用于委派,将 edit 用于产物。每个审查者仅允许 read 和 search。审查者不能委派或撰写报告。

配置文件 标准角色
egm:egm-design agents/design_critic.md
egm:egm-codebase-details agents/codebase_details.md
egm:egm-comprehension agents/comprehension.md
egm:egm-implementation-readiness agents/implementation_readiness.md
egm:egm-structural agents/structural.md
egm:egm-style agents/style.md
egm:egm-zoom-out agents/zoom_out.md
egm:egm-inventive-catalyst agents/inventive_catalyst.md

每次调用审查者(包括重复审查)时,都要启动一个新的原生子代理。任务中只包含所请求的模式、目标、行范围、角色、标准和明确的阅读列表。不要转发对话、内部理由、记忆或应由目标解释的答案。不要检索父级历史记录或记忆。仅当阅读列表中明确提供且标准工作流阶段要求时,才阅读先前的审查者报告。不要检索其他先前的发现。例如,第 8 步(中间 Zoom Out)要求调用方在阅读列表中包含 zoom_out_report.md 的绝对路径。不要转发其他先前的发现。

对共享技能的综合器步骤使用直接分派。阅读标准的 agents/synthesizer.md 以了解审查者选择和报告格式。主会话收集结果并写入产物。不要尝试嵌套委派或注册不受限制的综合器。引导工作进程不在本适配器的已验证范围内。

对审查者保持 include-custom-instructions: false。当前的 GitHub 文档将此设置描述为用于委派的子代理,而非选为主会话的代理。本地版本是否强制执行尚未验证。仅凭单独的上下文窗口并不能证明指令、记忆或共享文件已被隔离。

在综合之前,等待每个原生子进程完成。在宿主记录可用时检查必需的资源读取。缺失的子进程、读取失败、超时或被拒绝的工具都会使该阶段不完整。停止并报告该限制。绝不模拟子进程,也不应将缺失的发现视为通过结果。

人工门控与产物

遵循规范技能的审批步骤和阶段顺序。在结构化提问工具不可用时,使用一个纯文本问题并等待。工具缺失并不授予审批权。不要启用 autopilot 来绕过这些门控。

将产物写入工作目录,除非用户提供了 EGM artifact directory: <path>。相对于该工作目录解析相对产物路径。保留技能的文件名并报告其最终路径。将产物写入保留在主会话中;评审者仅返回发现。

验证与剩余限制

离线运行 pytest tests/unit/test_copilot_adapter.py 和 pytest tests/unit。宿主特定测试检查迁移后包中的配置文件、路径解析和规范资源保留。它们不会调用模型。

在安装了 CLI 1.0.82 的情况下,包含其离线原生发现检查:

EGM_COPILOT_OFFLINE=1 pytest tests/unit

在 2026-10-24,CLI 1.0.82 从挂载的包中加载了全部八个配置文件和七个技能。该测试使用一次性的 COPILOT_HOME 和 COPILOT_OFFLINE=true。它使用 --headless --stdio 启动已安装的 CLI,然后调用以下原生 SDK 协议操作,不发送任何提示词:

  1. session.create 使用拒绝请求的本地提供者创建一个会话。
  2. session.agent.list 返回八条带有绝对配置文件路径的 source: plugin 记录。
  3. session.skills.list 返回七个具有绝对规范路径的已启用技能。
  4. session.destroy 移除该会话。

测试检查精确的 ID、路径、工具列表、评审者 userInvocable: false 以及空的代理 MCP 定义。本地提供者收到零请求。模型名称 gpt-4.1 仅是会话元数据;没有模型执行。无需额外的清单映射。

被检查的 macOS arm64 CLI 二进制文件的 SHA-256 为 948a5e69d924559fdfb2292d9cd8584b8fba28f8fd0349eeefc18711225e340f。

代表性原生记录,本地根目录缩写为 <package>:

{"id":"egm:egm-design","source":"plugin","path":"<package>/com.github.copilot/agents/egm-design.agent.md","tools":["read","search"],"userInvocable":false,"mcpServers":{}}
{"name":"egm-review","commandName":"egm:egm-review","source":"plugin","path":"<package>/skills/egm-review/SKILL.md","enabled":true}

此版本上的独立 skill list 命令省略了已挂载的技能。其输出不是会话加载器清单。本地的 plugins list --help 也声明自定义代理的检查需要会话。原生 SDK 清单在无需模型运行的情况下解决了这一发现缺口。

发现并不证明技能执行、写入拒绝或上下文隔离。RPC 清单不暴露 include-custom-instructions 的强制实施。此历史说明未标识所测试的 EGM 提交或已安装包的校验和。在依赖固定候选版本之前,请针对该候选版本重复执行发现流程。

在提出支持声明之前,在明确授权使用模型的情况下,运行每个技能的 test_scenarios.yaml 中现有的头脑风暴、草稿和评审场景。分别记录以下结果:

  1. 安装:候选 SHA、包标识、完整资源和已加载的配置文件。
  2. 工作流:宿主版本、模型标识符、日期、原生子进程的启动与完成、必需读取、产物路径以及真实的人工审批暂停。
  3. 隔离:随机仅父级标记、实际的子进程上下文、注入的指令、内存和 MCP 暴露,以及对一次性夹具的写入尝试。

检查工具记录以验证写入拒绝。评审者的承诺不是强制执行。如果记录不可用,保留未验证的结果。对共享文件的读取访问可能暴露之前的发现;全新上下文并非文件系统沙箱。

官方参考

这些参考描述了能力。它们不是 EGM 运行时测试证据。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 el/elephant-goldfish-model