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:
在第一条消息中,提供绝对包根路径和所请求的技能:
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 的情况下,包含其离线原生发现检查:
在 2026-10-24,CLI 1.0.82 从挂载的包中加载了全部八个配置文件和七个技能。该测试使用一次性的 COPILOT_HOME 和 COPILOT_OFFLINE=true。它使用 --headless --stdio 启动已安装的 CLI,然后调用以下原生 SDK 协议操作,不发送任何提示词:
session.create使用拒绝请求的本地提供者创建一个会话。session.agent.list返回八条带有绝对配置文件路径的source: plugin记录。session.skills.list返回七个具有绝对规范路径的已启用技能。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 中现有的头脑风暴、草稿和评审场景。分别记录以下结果:
- 安装:候选 SHA、包标识、完整资源和已加载的配置文件。
- 工作流:宿主版本、模型标识符、日期、原生子进程的启动与完成、必需读取、产物路径以及真实的人工审批暂停。
- 隔离:随机仅父级标记、实际的子进程上下文、注入的指令、内存和 MCP 暴露,以及对一次性夹具的写入尝试。
检查工具记录以验证写入拒绝。评审者的承诺不是强制执行。如果记录不可用,保留未验证的结果。对共享文件的读取访问可能暴露之前的发现;全新上下文并非文件系统沙箱。
官方参考¶
这些参考描述了能力。它们不是 EGM 运行时测试证据。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 el/elephant-goldfish-model