深入解析 Elephant-Goldfish Model 的 Copilot 适配器:egm-codebase-details 只读审计 Agent

原创2026-11-14 12:47:332,299 阅读
文章标签:AI 技能代码评审文档Agent 工作流

深入解析 Elephant-Goldfish Model 的 Copilot 适配器:egm-codebase-details 只读审计 Agent

egm-codebase-details 是 Elephant-Goldfish Model(EGM)为 GitHub Copilot CLI 提供的一个实验性 Agent Profile,负责以“Goldfish”式隔离上下文执行“文档与代码一致性”审计。本篇以该 Profile 的完整定义为主线,逐字段拆解它的权限边界、路径契约、阅读清单纪律与审计向量,并结合仓库中的规范文件、审查工作流与离线契约测试,说明它在 EGM 五阶段评审流水线中的真实调用位置与可验证边界。读完你可以独立完成三件事:正确注册与委派该 Profile、按契约给它准备输入、判断一次审查结果是否可信。

一、这个 Profile 在 EGM 适配层中的位置

EGM 的分层结构是“一套技能 + 一套人格 + 一套文档标准”,各宿主只提供薄适配层。架构设计说明把系统拆成 Skills Layer(skills/)、Personas Layer(agents/)、Document Standards(resources/document_standards/)与 Living Documentation(docs/)四个子系统,并明确“不给任何宿主 fork 一份技能文本”。

Copilot CLI 适配层位于 com.github.copilot/agents/egm.agent.md 与八个 reviewer Profile 之中。入口 Profile egm 拥有 read、search、edit、agent 四个工具,负责加载共享技能、驱动人工审批门、在本地写产物;八个 reviewer Profile 只保留 read 与 search,由主会话按需原生委派。

需要注意的是,Profile 文件名与人格文件名并非一一对应。Canonical persona 名为 egm-codebase-details,其源文件是 agents/codebase_details.md,而 Copilot Profile 位于 com.github.copilot/agents/egm-codebase-details.agent.md。docs/copilot.md 给出的映射表中,egm:egm-codebase-details 对应的正是 agents/codebase_details.md。这一层间接性让同一份人格文本可以同时服务 Claude、Codex、Muse 等宿主,而各宿主的工具名差异只留在适配文件里。

该 Profile 的完整定义

文件正文很短,但每一行都是可测试的契约:

---
name: egm-codebase-details
description: Code and documentation accuracy review using the canonical EGM persona. Experimental Copilot CLI adapter.
tools: [read, search]
include-custom-instructions: false
user-invocable: false
---

Use only the assigned task and its explicit reading list.
Require an absolute EGM package root from the caller. Read
`<EGM_ROOT>/agents/codebase_details.md` before work. Follow that canonical
persona, not a similarly named file in the user's project.
Resolve bundled standards under `<EGM_ROOT>/resources/document_standards/`.
The caller must supply absolute paths for the target and every required standard.

Read the target, required standards, and explicitly referenced source files.
If a required path is absent or unreadable, return an incomplete review.
Do not retrieve parent history or memory.
Read prior reviewer reports only when explicitly supplied in the reading list
and required by the canonical workflow stage. Do not retrieve other prior findings.
Do not edit files, run commands, delegate, or use MCP tools.
Return findings and the paths you read to the caller through the native result.
The caller writes reports. Do not claim independent verification from self-report.

二、Frontmatter 逐字段解析:五个字段构成的最小权限面

tests/unit/test_copilot_adapter.py 对该文件的 frontmatter 做了强约束:tools 必须恰好是 ["read", "search"],include-custom-instructions 必须为 False,user-invocable 必须为 False,并且键集合必须严格等于 {name, description, tools, include-custom-instructions, user-invocable}——多一个字段都会让测试失败。这意味着该 Profile 不允许携带 model、color、mcpServers 之类的扩展键。

字段 取值 契约含义
name egm-codebase-details 与 canonical persona 的 name 完全一致;原生委派时以 egm: 前缀注册为 egm:egm-codebase-details
description Code and documentation accuracy review using the canonical EGM persona. Experimental Copilot CLI adapter. 面向宿主的发现描述,同时显式标注“Experimental”
tools [read, search] 只有读取与检索能力,无写入、无命令执行、无子代理委派
include-custom-instructions false 请求宿主不向被委派子代理注入自定义指令文件
user-invocable false 不能被用户直接选为主会话,只能被主会话作为原生子代理调用

name 的一致性不是形式问题。测试会从 agents/*.md 读取 canonical persona 的 frontmatter 名,再要求 com.github.copilot/agents/ 下的 Profile 文件名(去掉 .agent 后缀)与该名字集合加上 egm 完全相等。若人格名与 Profile 名漂移,或漏掉任何一个 reviewer Profile,测试立即失败。

为什么只给 read 和 search

只读是 EGM Goldfish 语义的物理保障,而非礼貌请求。docs/copilot.md 明确写道:入口 Profile 允许 agent 用于委派、edit 用于产物;每个 reviewer 只允许 read 和 search,“Reviewers cannot delegate or write reports”。这与 resources/document_standards/implementation-readiness-standard.md 中“实现计划必须给出精确文件边界,以便执行阶段用写入白名单约束改动”的思路形成呼应:审查者与执行者的能力集必须分离。

把审查者的写权限去掉,还带来一个副作用:报告只能由主会话写。这样“发现”与“记录”在权限上被切开,避免审查者在写报告时顺手改目标文档,从而破坏后续阶段的语义边界(FeatureRange 与 DetailedRange)计算。

三、include-custom-instructions: false 能保证什么,不能保证什么

这是最容易被误读的字段。Profile 设置了 false,Copilot 官方文档对“被委派子代理”描述过该设置;但 docs/copilot.md 明确记录了限制:“The local version's enforcement is unverified. A separate context window alone does not prove that instructions, memory, or shared files are isolated.”

因此正确的理解是:

  • 该字段是声明性的隔离请求,在宿主支持的前提下减少项目级与用户级指令注入;
  • 它不等于沙箱。Goldfish 仍可读取工作区文件,而共享文件里可能残留上一轮审查结论;
  • 若宿主记录(host records)不可见,就应把隔离结论保留为“未验证”,而不是从“prompt 里说了只读”反推“确实只读”。

docs/harnesses.md 在通用层面重复了同一判断:Codex 的 fork_context: false 与 fork_turns: "none" 隔离的是父轮次,并不能证明项目指令被排除。这一认识对 Copilot 适配器同样适用。

四、路径契约:<EGM_ROOT> 是任务输入,不是环境变量展开

Profile 全文使用 <EGM_ROOT> 前缀引用三类资源:canonical persona、resources/document_standards/、以及由调用方给出的目标文档。这里有一个关键细节:<EGM_ROOT> 是调用方在任务中提供的绝对路径,不是宿主对环境变量的展开。docs/copilot.md 的 “Resource paths” 一节专门指出这一点,并要求:“Preserve spaces and Unicode characters in paths. Do not split paths on whitespace.”

由此派生出一套可执行规则:

  1. 入口要求绝对路径。入口 Profile 要求“从用户或原生插件清单取得绝对安装根”,且不得猜测缓存路径。
  2. 不得用项目内同名文件顶替。Profile 正文的 “Follow that canonical persona, not a similarly named file in the user's project” 就是针对“用户项目里恰好也有 agents/codebase_details.md”这类冲突。
  3. 技能目录回溯三位父级。若拿到的是 skills/<skill>/SKILL.md 的发现结果,需要向上三层得到包根,再从包根解析 agents/、resources/、docs/;技能的 references/ 相对该技能目录解析;用户文档相对项目工作目录解析。
  4. 任一必需资源不可用即停。不是降级、不是替换,而是停止并报告。

tests/unit/test_copilot_adapter.py 通过把整个运行时复制到包含空格与 Unicode 的临时目录(如 relocated EGM café)来验证这套契约:它先用正则从每个 Profile 抽出所有 <EGM_ROOT>/... 引用,再逐条断言被引用路径在迁移后的包中真实存在;同时断言 com.github.copilot/skills 不存在,防止出现第二份技能副本。

该测试还有一个容易被忽略的断言:Profile 文本中不得出现 ${。原因是 docs/copilot.md 明确不假设 Copilot 会展开 Markdown 正文里的变量,因此适配文件必须使用字面量 <EGM_ROOT> 占位,而不是 ${EGM_ROOT}。这一点与 Claude 适配器形成对照:.claude-plugin/agents/codebase_details.md 使用的是 ${CLAUDE_PLUGIN_ROOT},因为 Claude 会展开该变量。

调用方必须准备的输入清单

输入 形式要求 缺失后果
EGM 包根 绝对路径 无法定位 canonical persona,审查不能开始
目标文档 绝对路径 返回不完整审查
每一项必需标准 绝对路径 返回不完整审查
阅读清单(可选) 显式列出的源码/文档路径 只能读任务本身与清单内文件,不得自行扩展
审查模式 REVIEW 或 BRAINSTORM 人格文件按 Mode 分支执行,缺失则行为不确定

五、阅读清单纪律:状态最小化而非“尽可能多读”

Goldfish 的价值来自“零历史”。 agents/codebase_details.md 的 Core Mandates 第 2 条称之为 “Stateless Mindset (Goldfish Isolation)”:以刚加入项目的新成员视角阅读文档,不带任何对话历史或外部假设。

Copilot Profile 把这条原则翻译成四条可执行禁令:

  • Do not retrieve parent history or memory. —— 不回溯父会话历史与记忆;
  • Read prior reviewer reports only when explicitly supplied in the reading list and required by the canonical workflow stage. —— 既往前序报告只有在“被显式列入清单”且“该工作流阶段确实需要”时才可读;
  • Do not retrieve other prior findings. —— 即便同类报告存在,也不得主动捞取;
  • Use only the assigned task and its explicit reading list. —— 任务与清单是唯一信息源。

这解释了为什么 Stage 8(Intermediate Zoom Out)在流程定义中必须由调用方把 zoom_out_report.md 的绝对路径放进阅读清单:skills/egm-review/SKILL.md 的 Step 8 用前序报告做增量复核,这是“被规范要求的例外”,而不是“顺手多读一点”。测试 tests/unit/test_copilot_adapter.py 对该句做了逐字断言,且同时对 docs/copilot.md 与每个 reviewer Profile 参数化校验,确保这句话不会在重构中悄悄弱化。

对实践者的启示是:阅读清单就是审查的输入契约。把无关文件塞进清单会引入偏见;把必需文件漏掉会让审查退化为猜测。清单应当只包含目标文档、必需标准、以及文档中显式引用的源码。

六、失败语义:incomplete review 优先于任何结论

Profile 正文规定:If a required path is absent or unreadable, return an incomplete review. 这与 Claude 适配器中的表述一致(“report an incomplete review instead of a verdict”),也与 docs/copilot.md 的阶段完整性规则一致:子代理缺失、读取失败、超时、工具被拒,都会让该阶段“incomplete”,必须停止并报告限制,“Never simulate a child or treat missing findings as a passing result.”

这条规则的实际价值在于阻断三类常见污染:

  1. 用零发现冒充通过。人格文件与 synthesizer 都要求:失败或未返回报告的 reviewer 状态记为 not run,绝不能算作“未发现问题”。
  2. 用自述冒充验证。Profile 结尾的 Do not claim independent verification from self-report. 直接否定了“我读了所以我验证了”的推理;可核验的证据是宿主记录中实际发生的读取。
  3. 用主会话代替子代理。入口 Profile 明确:“Never substitute an inline review for a missing native reviewer.” 同一上下文里的“审查”不是 Goldfish 审查。

The caller writes reports. 进一步划清了产物归属:Profile 通过原生返回值交回发现与“实际读过的路径列表”,报告文件由主会话写入。这样审查者的输出是数据,不是副作用。

七、审计职责:人格文件定义的六个向量

适配层只负责工具与路径,真正的评审标准来自 agents/codebase_details.md。其角色定义是“学究式的技术质量审计员”——不接受含糊解释、未声明假设或缺失细节,目标是让文档与代码实现完全且穷尽地对齐。

REVIEW 模式的四步流程

  1. Map the Scope:解析目标范围,确定它描述了哪些源文件;
  2. Verify Code vs. Doc:逐个读取源文件,核对公共 API、核心算法、配置开关、关键逻辑路径是否都被写入目标范围;
  3. Audit against the Standard:把描述深度与准确度对照 Target Standard 的要求,标记不达标处;
  4. Filter Test Files:忽略简单单元测试文件,但严格审计测试基础设施(mocks、helpers、基类)。

第 4 步常被误读为“测试不用看”。实际约束相反:一次性断言文件可以略过,但共享的 mock、fixture helper、基类必须与生产代码同等详尽地记录,因为它们才是复现成本与理解成本的大头。

六个审计向量

向量 触发条件 典型证据
Missing Logic Detail 代码中存在但目标范围未记录的函件、校验规则、算法 公共函数、边界校验、状态机分支
Unstated Assumptions 硬编码常量、环境变量、系统依赖未记录 超时值、默认路径、必需的外部服务
Undocumented Edge Cases catch 分支、空值检查、重试上限、失败模式缺失 异常处理路径、降级策略
Test Infrastructure Neglect 共享 mock 与测试辅助未被记录 测试夹具、工厂函数、基类契约
Contradicts the Code 文档描述的“当前行为”源码并不具备 与实际实现冲突的描述,直接升级为 🔴 Blocker
Non-Existent References 文档声称现存但不存在的文件、函数、端点、表 逐条核对每一个引用

Contradicts the Code 被要求报为 Blocker 的理由很直白:“every later reader inherits the false statement.” 一个错误的“现状描述”会被后续所有读者继承。

“计划中的文件不是缺陷”

人格文件专门用一段处理实现计划的特殊性:“Proposed files are not findings.” 实现计划会列出将要创建的文件,它们的缺失不是缺陷。因此 Non-Existent References 只适用于文档声称现在已存在的对象。如果计划列出了文件却没有逐个标注 Create、Modify、Delete,则只报一次 🟡 Major,而不是对每个路径重复开单。这条规则显著降低噪声,也让严重级别更有区分度。

输出格式

REVIEW 模式下每条发现必须包含三要素:Severity(Blocker / Major / Nit)、Affected Scope(文件路径、API 或行号)、以及“差异描述与理由”(说明代码漂移,或通过代码检索发现的既有库复用机会)。三项缺一,主会话就难以在 synthsize 阶段去重与排序。

BRAINSTORM 模式的另一副面孔

同一人格在 Mode: BRAINSTORM 下做的是上游概念评估,聚焦可观测性:

  1. Telemetry & Tracing:关键操作能否在分布式追踪中定位?指标是否可行动?
  2. Operational Debuggability:凌晨三点的 oncall 工程师如何定位这次生产事故?
  3. 把可观测性要求与遥测缺口报告回编排器。

该模式的输出格式是四要素:Severity、Dimension(Observability & Operational SRE Debuggability)、Operational Risk(缺失的 trace 上下文、未监控指标、排障摩擦)、Mitigation Requirement(写入 Concepts Brief/PRD 的强制遥测要求)。因为该 Profile 只有 read 与 search,在 BRAINSTORM 阶段它同样只能“读代码、找证据、报缺口”,不能改任何文件——这正好符合上游概念阶段不应产生实现副作用的约定。

八、它在审查流水线中的调用位置:Stage 9

skills/egm-review/SKILL.md 定义五阶段评审。egm-codebase-details 出现在最后一步:

  • Stage 5 Initial Zoom Out:egm-zoom-out + egm-inventive-catalyst,标准为 zoom-out-standard
  • Stage 6 Comprehension Test:直接用 egm-comprehension,不套标准
  • Stage 7 Critic Review:egm-design + egm-structural + egm-style,标准为 feature-spec-standard
  • Stage 8 Intermediate Zoom Out:egm-zoom-out,需传入 Stage 5 的报告路径
  • Stage 9 Implementation Readiness:egm-implementation-readiness + egm-codebase-details + egm-style,标准为 implementation-readiness-standard

也就是说,Copilot 侧的 egm:egm-codebase-details 在完整流程里对应 Stage 9,审查目标是 DetailedRange(## Detailed Implementation Plan 之后的部分),不是高层特性描述。这个定位解释了两件事:

其一,Profile 必须拿到 implementation-readiness-standard 的绝对路径。该标准的核心是 Zero-Decision Rule:计划不得把任何设计或架构选择留给实现者,否则直接不通过;并且要求给出精确的仓库相对路径清单(Target Scope & File Boundary),以便执行阶段建立写入白名单。codebase_details 在其中的作用,是核对计划引用的每一个文件、函数、表格是否真实存在,以及描述是否与代码一致——这正是“零决策”能否落地的事实基础。

其二,Copilot 的 egm:egm-codebase-details 与 egm:egm-implementation-readiness 是互补而非重复:前者查“文档说的东西是否存在、是否与代码一致”,后者查“计划是否足够可执行、是否留了决策”。两者同批派出,才能同时覆盖事实准确性与可执行性。

若你想缩小范围只跑实现计划评审,egm-review 的 Preset 3 会跳过语义切分确认后的前序阶段,直接跳到 Stage 9;若跑的是 Feature spec only,流程会在 Stage 8 后干净停止,不会调用 egm-codebase-details——因为它审计的是实现细节,而 FeatureRange 按 Zoom Out 标准本就不该包含代码级内容。

九、注册、委派与人工门

注册与启动

docs/copilot.md 给出的离线验证路径使用 --plugin-dir 挂载完整检出,而不是只复制 skills/:

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

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

第一条命令中的 plugin list 只验证注册,不验证 reviewer 能否执行;后者需要显式的模型使用授权。首条消息应同时给出包根与要运行的技能:

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

关键约束:必须以 egm:egm 作为入口 Agent 启动,让宿主映射先加载再进入技能;把某个 reviewer 直接选为主会话,并不能产生一个新的 Goldfish 上下文。使用前还应检查 /agent 是否存在同名冲突,因为个人 Profile 可能覆盖包内 Profile。

VS Code 侧的实验性工作区发现由 .vscode/settings.json 提供两个已弃用的兼容设置:chat.agentSkillsLocations 指向 skills,chat.agentFilesLocations 指向 com.github.copilot/agents。测试会断言这两个键与目录实际存在,但 docs/copilot.md 明确指出这属于 issue 追踪中的实验能力,且这些设置的弃用状态意味着未来可能失效。

委派时的提示构造

docs/copilot.md 的 “Native delegation” 一节给出四条硬规则:

  1. 使用宿主的原生自定义 Agent 委派工具,先检查其暴露的 schema,不要臆造工具参数;
  2. 以命名空间 ID 选择已注册 Profile(egm:egm-codebase-details);
  3. 每次审查都新起一个原生子代理,包括重复审查;
  4. 任务只包含:模式、目标、行范围、人格、标准、显式阅读清单。不要转发对话、私有推理、记忆,或目标文档本应自行解释的答案。

一个符合契约的委派任务形如(示意):

Mode: REVIEW
Persona: egm-codebase-details
EGM package root: /abs/path/to/elephant-goldfish-model
Target: /abs/path/to/project/docs/designs/payments.md
Line range: 180-420 (DetailedRange)
Standard: /abs/path/to/elephant-goldfish-model/resources/document_standards/implementation-readiness-standard.md
Reading list:
  - /abs/path/to/project/src/payments/service.py
  - /abs/path/to/project/src/payments/schema.sql

注意这里没有“上一轮我们已经讨论过……”这类前缀,也没有把 Stage 7 的 critic_report.md 塞进清单——Stage 9 的规范并未要求它。

人工门与产物归属

技能的人工审批门不能绕开。若宿主没有结构化提问工具,就用一条纯文本问题并等待;“缺少工具”不构成默认同意,也不允许用 autopilot 跳过。产物默认写入工作目录,除非用户给出 EGM artifact directory: <path>;docs/harnesses.md 补充了目录越界规则:若指令文件中配置的路径在跟随符号链接后落在工作目录之外,EGM 必须先征求确认;无人可确认(如无头运行)则退回工作目录。

十、如何验证这套适配器:三条离线证据链

全部验证都可在不消耗模型配额的情况下完成。

1. Profile 契约测试

pytest tests/unit/test_copilot_adapter.py

tests/unit/test_copilot_adapter.py 覆盖三件事:Profile 的 frontmatter 与工具集、prior report 的读取纪律、以及迁移后资源路径的可解析性。它还有一条易被忽略的断言:入口 Profile 的文本中必须出现“Use the {N} registered EGM reviewer profiles”且 N 由 REVIEWERS 元组长度推导,这意味着新增或删除 reviewer 时必须同步改文案,否则测试失败。

2. 原生加载器发现(需已安装 CLI)

EGM_COPILOT_OFFLINE=1 pytest tests/unit

该测试要求 copilot --version 输出包含 GitHub Copilot CLI 1.0.82.,随后以 --headless --stdio 启动 CLI,通过 SDK 协议依次调用四个操作而不发送任何提示:

  1. session.create:以一个本地“拒绝型”provider 建会话;
  2. session.agent.list:返回 8 条 source: plugin 记录及绝对 Profile 路径;
  3. session.skills.list:返回 7 个启用的技能及绝对 canonical 路径;
  4. session.destroy:销毁会话。

本地 provider 记录到的请求数必须是 0;模型名 gpt-4.1 只是会话元数据,不执行任何模型。测试同时校验精确 ID、路径、工具列表、reviewer 的 userInvocable: false,以及空的 agent MCP 定义。

按 docs/copilot.md 记录,2026-10-24 在 CLI 1.0.82 上该检查成功加载了全部 8 个 Profile 与 7 个技能,被检视的 macOS arm64 二进制 SHA-256 为 948a5e69d924559fdfb2292d9cd8584b8fba28f8fd0349eeefc18711225e340f。仓库存档也保留了代表性原生记录:

{"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 也说明检查自定义 Agent 需要会话;原生 SDK 清单正是为补上这一缺口而存在。

3. 工作流与隔离证据(需显式授权)

发现不等于执行。要支撑“可用”的结论,还需按各技能 test_scenarios.yaml 跑通 brainstorm、draft、review,并把三类结果分开记录:

类别 需记录内容
安装 候选提交 SHA、包身份、资源完整性、已加载 Profile
工作流 宿主版本、模型标识、日期、原生子代理启动与完成、必需读取、产物路径、真实的人工审批暂停
隔离 仅父会话可见的随机标记、子代理实际上下文、注入指令、记忆与 MCP 暴露、对一次性夹具的写入尝试

写入拒绝必须从工具记录判断,“reviewer 承诺只读”不算执行证据。若记录不可得,就保留“未验证”结论。

十一、已知边界与排障速查

症状 可能原因 处理方式
委派时报找不到 Profile 未以 egm:egm 入口启动,或被个人同名 Profile 覆盖 先 --agent egm:egm 启动,再用 /agent 检查冲突
子代理读到了用户项目里的同名人格 使用了相对路径或在项目目录内搜索 传入包根与人格文件的绝对路径;依赖 Profile 中的“not a similarly named file in the user's project”
返回 incomplete review 目标、标准或引用源码缺失/不可读 补齐绝对路径后重跑,不要用总结代替缺失文件
reviewer 行为看似“知道”前几轮结论 阅读清单里混入了往期报告,或共享文件被读到 精简清单;把“共享文件可读 ≠ 上下文隔离”记入结论限制
审查“通过”但实现时仍需做设计选择 错用了 feature-spec-standard,或未跑 Stage 9 用 implementation-readiness-standard 审 DetailedRange,并核对 Zero-Decision Rule
skill list 看不到技能 该 CLI 版本的独立命令不读挂载目录 使用会话级 session.skills.list 原生清单检查
路径含空格或 Unicode 时读取失败 按空白切分了路径 保持路径整体传递;参考迁移测试中的 relocated EGM café 用例

另外三点需在选型时说明清楚:该适配器整体标注为 Experimental,docs/copilot.md 开头即声明“Workflow execution and reviewer isolation remain unverified”,且不构成对 VS Code 内 Copilot 或云端 agent 的支持承诺;持久化安装(copilot plugin install)在 1.0.82 上未验证;Bootstrap worker 不在该适配器已验证范围内。此外,只复制 skills/ 的安装方式会直接破坏 EGM,因为技能在运行时会读取 agents/ 与 resources/document_standards/。

十二、小结

egm-codebase-details 这个 25 行的适配文件,实际上把三件事同时钉死了:能力边界(只有 read 与 search)、输入契约(绝对包根 + 绝对目标 + 绝对标准 + 显式阅读清单)、失败语义(不可读即 incomplete review,报告由调用方写)。它把 agents/codebase_details.md 中那份“学究式审计”的人格定义原样搬到 Copilot CLI 上,让 Stage 9 能够逐条核对实现计划里的每个文件、函数与表格是否真的存在、描述是否与代码一致。

如果你的目标是让一次审查结论可信,判断顺序应当是:Profile 是否正确注册并按命名空间委派 → 阅读清单是否只含必需文件 → 宿主记录里是否真的发生了读取 → 缺失资源是否被如实报为不完整。四步都成立,Goldfish 的“零历史”才有意义;任一步缺失,结论就应保留为未验证。

登录后查看全文
elephant-goldfish-model