EGM Brainstorm 技能解析:用七镜头 Goldfish 评审把半成品想法变成可评审的 concepts_brief

原创2026-11-14 16:00:031,438 阅读
文章标签:AI 技能代码评审文档Agent 工作流

EGM Brainstorm 技能解析:用七镜头 Goldfish 评审把半成品想法变成可评审的 concepts_brief

本文以 skills/egm-brainstorm/SKILL.md 为核心,完整拆解 elephant-goldfish-model(EGM)中的头脑风暴技能:它如何通过多轮开放式提问锚定问题、以 7 个专用 Goldfish 评审视角并行"炮轰"一个功能概念、最终产出结构化 concepts_brief.md 并交接给 /egm-draft。读完本文,你可以理解该技能的完整执行约束、四个阶段工作流、产物模板与交接门(gate)机制,并能结合 agents/ 目录下的人格文件与 test_scenarios.yaml 评测场景,在自己的 harness 中正确运行和验证这一技能。

1. 技能定位:EGM 上游的对话式头脑风暴引擎

EGM 插件(manifest 见 plugin.json,当前版本 0.1.1)遵循"象与金鱼"模型:Elephant(主 Agent)持有项目上下文并起草文档,Goldfish 子代理在全新上下文中评审、暴露未声明的假设与盲区,而架构取舍由人来拍板。egm-brainstorm 在其中扮演上游对话式头脑风暴引擎:把"半成品"(half-baked)或原始想法变成假设(hypothesis),手段是交互式澄清提问加自动化 Goldfish 评审,最终产出经迭代打磨的 RFC 摘要 concepts_brief.md,直接进入 /egm-draft 或交给同侪评审。

技能 frontmatter 声明了几个关键点:

  • name: egm-brainstorm,license: Apache-2.0;
  • disable-model-invocation: true——模型不会自动触发该技能,需用户显式调用(如 /egm-brainstorm 或 Codex 的 skill picker);
  • 描述字段(description)说明其职责:"Interactive ideation and brainstorming skill ... Produces an RFC summary for human review or more detailed design with egm-draft"。

在 Codex 或 ChatGPT Work 中运行时,技能要求先读 docs/codex.md;在 Claude Code 或 Cowork 中则先读 ${CLAUDE_PLUGIN_ROOT}/docs/claude.md(对应仓库内的 docs/claude.md)。

2. 委派机制(Delegation):Goldfish 必须运行在全新上下文

技能对"评审必须独立"这一点非常严格:

一条 Goldfish 运行在没有对话历史的 fresh context 中。使用你 harness 的 subagent 工具派生每个子代理(Antigravity: invoke_subagent;Claude Code: Agent;Codex: spawn_agent)。每个子代理定义在 agents/<file>.md,其 frontmatter 的 name(如 egm-zoom-out)就是注册了命名子代理的 harness 中要请求的子代理类型。否则就派生一个通用子代理,并告诉它先读那个人格文件。提示词(prompt)逐字传递并等待报告。如果你的 harness 无法嵌套子代理,改用 direct dispatch 而非 synthesizer。如果你的 harness 没有 subagent 工具,停下来告诉用户:同一上下文中的评审不是 Goldfish 评审。

docs/harnesses.md 用一张表给出了各 harness 的映射:Antigravity 用 invoke_subagent(支持命名人格与嵌套)、Claude Code 用 Agent (Task) 工具(默认最多 3 层嵌套)、Codex/ChatGPT 用原生 spawn/wait 工具(无命名人格,运行时检测,支持 direct dispatch 回退)等。该文档还强调:只安装 skills/ 目录而跳过 agents/ 与 resources/document_standards/ 的安装方式会破坏 EGM,因为技能在运行时读取这些目录。

3. 执行约束(Execution Constraints):13 条硬性规则

SKILL.md 用 13 条"CRITICAL"约束定义了技能的行为边界,这是理解其交互风格的核心:

  1. Artifact-First 交付(强制):严禁在聊天窗直接输出大段提案、草稿、头脑风暴摘要或 brief;必须用文件写入工具写到工作目录(如 ./concepts_brief.md)或 harness 的 artifact 目录,然后在聊天中只给出文件链接。
  2. 多轮开放式澄清 + 就绪门(Readiness Gate):必须通过多轮聊天中的开放式纯文本问题深挖概念,直到问题陈述与边界彻底清晰;在用户审查锚定假设并显式确认就绪之前,不得派生子代理;开放式提问阶段严禁使用结构化提问工具(ask_question)或预置多选候选项。
  3. 并行 Goldfish 评审:必须同时在多个专用 Goldfish 镜头上评估概念,防止顺序偏差、最大化批评广度。
  4. Plain-English 标准:所有 concepts brief、RFC 摘要与沟通都必须用简单、直接、无行话的 plain English;直接解释技术机制,不得用空洞词(如 seamless、robust、blazingly fast)或装饰性副词(seamlessly、effortlessly、literally、drastically、obviously)概括掉实质内容。
  5. 默认压力测试:从不默认同意;首要指令是压力测试想法、策略与观点,先找出最弱点、边缘案例与盲区,再谈肯定。
  6. No Glazing(无奉承):删除谄媚。不得称想法 "great"、"brilliant"、"smart";没有实质的恭维就是噪音。
  7. Critique First:即使想法很强,也先讲错在哪、缺什么、风险何在,再谈优点。
  8. 拒绝回音室:不要鹦鹉学舌地把用户的框架复述回去;对断言的结论不做反射式认同。
  9. 生成反论证:对每个被提出的策略,主动回答:用户没看到什么?最强反论证是什么?对立观点是否成立?
  10. Earn Your Agreement:只有当想法经受了严格、客观的审视之后才同意。
  11. 禁用赞美形容词:提及用户输入、修正或决策时,严禁使用 "brilliant"、"great"、"smart"、"correct"、"perfect"、"excellent"、"spot-on" 等验证性形容词。
  12. 禁止客套道歉:被质疑或纠正时,不得输出 "I apologize"、"I am sorry"、"Forgive me" 等礼貌道歉;直接陈述修正后的技术逻辑或取舍。
  13. 交互不变量:所有交互式门(结构化提问工具或纯聊天)必须严格只含一个问题(len(questions) == 1)、是该轮唯一的工具调用,并提供清晰、行动导向的选项,不带 (Recommended) 前缀。

这些约束的意图很明确:把 AI 助手从"讨好型对话者"改造成"对抗式评审者",同时保证所有长文本都沉淀为可评审的 artifact 而非一次性聊天输出。

4. 七镜头 Goldfish 评审矩阵(The Goldfish Brainstorming Lenses)

SKILL.md 定义了 7 个专用评审镜头,每个镜头对应 agents/ 目录下一个人格文件(frontmatter name 即子代理类型):

镜头 / 人格 核心目标 挑战的关键问题 对应人格文件
Contrarian / YAGNI 代码与复杂度最小化 这个功能为什么需要存在?现有库、开源依赖、API 或服务能否不写新代码解决 90% 的问题? agents/zoom_out.md(egm-zoom-out,Skeptical Architect)
Cost, Quota & Token Economics 基础设施与预算扩展 峰值 QPS、内存占用、数据库查询负载或 LLM token 预算是多少?规模化后会不会撞配额上限? agents/design_critic.md(egm-design)
UX & Developer Ergonomics 可用性与认知开销 API/CLI 是否直观?是否符合生态惯例?错误信息可操作,还是增加开发者摩擦? agents/comprehension.md(egm-comprehension)
Migration & Backward Compatibility 上线安全与版本偏斜 现有客户端/数据如何迁移?是否破坏序列化 schema、proto 或持久存储?迁移中途回滚怎么处理? agents/implementation_readiness.md(egm-implementation-readiness)
Observability & SRE Debuggability 遥测与运维可视性 关键操作能否用分布式追踪追踪?遥测指标可操作吗?oncall 工程师凌晨 3 点如何分诊生产事故? agents/codebase_details.md(egm-codebase-details)
Long-Term Tech Debt & Maintenance 未来可维护性 是否引入紧耦合依赖或脆弱状态机,两年后成为维护噩梦? agents/structural.md(egm-structural)
Inventive Catalyst 矛盾消除与创新变换 该设计把哪个根本取舍当作不可避免?如何用成熟的软件变换解决该冲突、达成无妥协的 Ideal Final Result? agents/inventive_catalyst.md

从源码结构看,各人格文件都有统一的"Core Mandates":严格只读(无写文件/编译工具)、无状态心智(把文档当作刚加入项目的新成员来读)、不闲聊。以 agents/inventive_catalyst.md 为例,它在 Mode: BRAINSTORM 下内置了一条防幻觉护栏——先"Verify Contradiction Existence":若架构已经平衡、没有真正的妥协被接受,就显式输出 "No false compromise detected",而不是编造投机性变换;内联了 10 条"Curated Inventive Software Patterns"(Segmentation、Extraction/Taking Out、Preliminary Action、Beforehand Cushioning、Inversion、Dynamics、Blessing in Disguise、Intermediary、Self-Service、Cheap Dispensables),且要求每条推荐都显式声明其二次运维代价。agents/zoom_out.md 则被要求在 BRAINSTORM 模式下执行代码库搜索来验证"是否已有组件可以复用",其输出每条须含 Severity(Blocker/Major/Nit)、Dimension、Challenge/Risk 与 Alternative/Reuse Opportunity。

5. 四阶段执行工作流(Execution Workflow)

Step 1:深度澄清与问题陈述挖掘

  1. 检查概念基础与作者身份:确认用户是否提供了初始功能想法或概念提示;没有则请用户描述要头脑风暴的内容。Author 字段按顺序从 git config user.name、GIT_AUTHOR_NAME 解析;两者都未设置时,在聊天中询问,而不是默认填充。
  2. 迭代式问题挖掘(多轮聊天):不要在单次回复后就急着启动子代理。必须跨多个聊天轮次持续提出有针对的开放式问题,直到问题陈述、约束与目标行为被彻底定义。此阶段禁用 ask_question 和候选多选。SKILL.md 给出的问题模板包括:
    • 这解决什么具体问题、瓶颈或痛点?
    • 谁或哪个系统消费该功能,SLA/不变量是什么?
    • 硬性不可谈判的约束是什么(如零误报、离线运行、特定平台/方言)?
    • 边缘案例或明确不在范围内的边界是什么?
    • 今天这个问题是怎么处理的?为什么现状不行?
    • 成功如何衡量?
  3. 就绪检查点门(单选项):基础建立后,用 2-3 句话总结锚定的工作假设(anchored working hypothesis),并呈现显式单选确认门(有结构化提问工具的 harness 用 ask_question,否则纯聊天):
{
  "questions": [
    {
      "question": "Anchored feature hypothesis: [2-3 sentence summary]. How would you like to proceed?",
      "options": [
        "Review with Goldfishes",
        "Clarify additional constraints or assumptions in chat"
      ],
      "is_multi_select": false
    }
  ]
}
  • Option 0(Review with Goldfishes):用户确认就绪,立即进入 Step 2 调用 egm-synthesizer;
  • Option 1(Clarify additional constraints or assumptions in chat):留在 Step 1,把用户补充的写入选定反馈并入假设,就绪后重新呈现门。
  1. 只有确认 Option 0 后才进入 Step 2,门之前不得派生任何子代理。

Step 2:Goldfish 评审与综合(Synthesis)

  1. 委派给 egm-synthesizer 子代理(若 harness 无法嵌套子代理,则直接并行派生 7 个镜头下的 Goldfish 子代理):
    • 子代理:egm-synthesizer,定义在 agents/synthesizer.md;
    • Prompt 模板:Conduct multi-lens brainstorm for feature concept: [AnchoredFeatureHypothesis]. Mode: BRAINSTORM. Reviewers: [egm-design, egm-codebase-details, egm-zoom-out, egm-comprehension, egm-implementation-readiness, egm-structural, egm-inventive-catalyst].
  2. Synthesizer 执行:egm-synthesizer 在 Mode: BRAINSTORM 下并行启动 7 个专用 Goldfish 评审者。从 agents/synthesizer.md 看,它还承担三个职责:给每个评审角色起以 -Brainstormer 结尾的标题(如 Skeptical Architect Brainstormer);对超时/失败/无报告的评审者重试一次,仍失败则标记 not run——绝不允许把失败算作"零发现的镜头";把各 Goldfish 的非结构化发现去重、综合成连贯分析。
  3. 去重:收集 Goldfish 原始发现,去重重叠点,格式化为连贯分析。
  4. 写入/更新产物:用文件写入工具把综合后的 brief 写入工作目录(或 harness 的 artifact 目录)的 concepts_brief.md。

concepts_brief.md 遵循如下固定结构:

# [Feature Name]

* **Author:** [Author Name or GitHub Handle]
* **Date:** [YYYY-MM-DD]

## Overview

[High-level summary of the feature, target user, and core value proposition written in plain English.]

## Analysis

[Cohesive analysis found by review lenses written in plain English, covering inventive contradictions, suggested catalog patterns, secondary trade-offs, and the Ideal Final Result.]

## Goals vs. Non-Goals

* **In-Scope Goals:** [Explicitly defined scope items]
* **Out-of-Scope Non-Goals:** [Features intentionally excluded]

## Alternatives Weighed

[Each option rejected during ideation, with the technical reason (e.g. "Rejected by author: <reason>"). Do not attribute a rejection to a maintainer without linking their issue, discussion, or PR. `/egm-draft` copies these into Alternatives Considered and has no other source for them.]

## Key Decisions & Staging for Next Steps

[Key decisions resolved during ideation to be carried forward into `/egm-draft`.]

注意 Alternatives Weighed 节的归因规则:被否决的方案必须以 "Rejected by author: " 形式记录为作者决策,不能在没有链接 issue/discussion/PR 的情况下把否决归因给 maintainer——因为 /egm-draft 会原样把这些内容复制进设计文档的 Alternatives Considered 一节,且没有别的来源。

Step 3:交互式迭代与打磨循环

  1. 通知与高亮(不刷屏):在聊天中通知用户 concepts_brief.md 已更新(给出路径),并高亮 2-3 条 Goldfish 评审者提出的关键反对意见或开放风险;
  2. 迭代:询问用户打算如何处理这些反对意见(换方向、收窄范围、加约束等);
  3. 回环:重复 Step 1 和 Step 2,重跑或更新 Goldfish 分析,直到概念经受住审视且用户满意为止。

Step 4:定稿与交接

  1. 产物对齐:请用户审查最终 concepts_brief.md 并确认对齐;
  2. Step 4 交接门(单选项):批准后呈现标准化交接选项:
{
  "questions": [
    {
      "question": "Brainstorming complete. concepts_brief.md is finalized. Select next step:",
      "options": [
        "Publish concepts_brief.md as RFC for team feedback",
        "Proceed to egm-draft (Initialize formal design document)",
        "Continue refining concepts_brief.md in ideation mode",
        "Conclude brainstorming and keep brief for later"
      ],
      "is_multi_select": false
    }
  ]
}

四个选项的行为分别是:

  • Option 0(发布为 RFC 征求团队反馈):把 concepts_brief.md 写到 docs/designs/<feature_name>.md;若 docs/designs/SITEMAP.md 存在则在其中登记该 RFC;通知用户 RFC 已发布、可在正式起草前分享收集反馈,并提醒:反馈汇总后可用宿主命令形式(Claude Code 与 agy CLI 为 /egm:egm-draft docs/designs/<feature_name>.md,Codex 为 skill picker)在该文件上启动 egm-draft;
  • Option 1(进入 egm-draft):确认 concepts_brief.md 已保存在工作目录或 artifact 目录,指导用户以宿主命令形式启动 egm-draft(如 Claude Code/agy CLI 的 /egm:egm-draft,或 Codex 的 skill picker),并说明它会自动把 concepts_brief.md 作为 Priority 1 的摄入源;
  • Option 2(继续以构思模式打磨):回到 Step 3 迭代循环,深挖更多边缘案例或按用户聊天输入更新 brief;
  • Option 3(结束头脑风暴、保留 brief):优雅结束会话,提醒用户 concepts_brief.md 仍保留着供日后参考。

6. 行为评测与集成测试:约束如何被验证

该技能不是只靠文档约束,仓库内有两层可执行的验证。

行为评测套件 skills/egm-brainstorm/test_scenarios.yaml 定义了 9 个 deterministic 场景,每个场景把 SKILL.md 作为 system prompt 输入、以正则断言(required_pattern / forbidden_pattern / contains)校验模型行为,覆盖的正是前文所述约束:

scenario_id 校验点
open_ended_discovery_divergence 初始探索必须直接在聊天中发起开放式提问;禁止出现 (Recommended)、Option 1、Option A、[1] 等多选菜单痕迹
readiness_gate_modal 就绪门必须提供 "Review with Goldfishes" 与 "Clarify additional constraints or assumptions in chat" 两个选项;禁止 (Recommended) 前缀
handoff_draft_option_command_form 交接时必须提到 egm-draft,且禁止让用户输入无宿主前缀的 /egm-draft(负向环视断言)
handoff_gate_modal_routing Step 4 门必须提供 RFC 发布与进入 egm-draft 选项;禁止路由到已弃用的 /egm-discuss;禁止 (Recommended)
decision_matrix_generation 技术取舍必须输出 Markdown 表格形式的决策矩阵,并逐一评估被比较对象
author_resolution_fallback_prompts_chat git user.name 与 GIT_AUTHOR_NAME 均未设置时必须询问作者名;禁止把 Author 默认为 root/runner/maintainers
alternatives_rejection_attribution_by_author 被否决备选方案必须记录为 "Rejected by author:";禁止 "Rejected by maintainer"
inventive_catalyst_analysis_synthesis ## Analysis 节必须同时捕获 inventive contradiction、目录模式推荐(如 Preliminary Action)与 secondary trade-offs
inventive_catalyst_no_false_compromise_early_exit 当 Inventive Catalyst 返回 "No false compromise detected" 时,brief 必须原样承载该 early-exit,且不得凭空捏造 Segmentation/Preliminary Action 等目录模式

集成测试方面,tests/integration/test_codex.py 的端到端 fixture 会驱动完整链路:验证 egm-brainstorm、egm-draft、egm-review 三个技能目录存在、技能目录内容一致,并断言运行产物中同时出现 concepts_brief.md、design_draft.md 等 artifact;tests/unit/test_harnesses.py 则校验 egm-brainstorm 等技能在各 harness 清单中的注册一致性。skills/egm-brainstorm/TEST.md 还给出了一份交互验证清单,把 SKILL.md 的四步流程翻译成可核对的验收点(开放式澄清与就绪门、七镜头并行评审、brief 产物与交接)。

7. 在整体工作流中的位置与上手要点

  • 前置条件:必须安装完整插件(skills/ + agents/ + resources/),且会话 harness 具备创建 fresh-context 子代理的能力;docs/harnesses.md 明确了各 harness 的安装方式与子代理工具映射,并警告独立版 Antigravity IDE 因不暴露 invoke_subagent 而不支持 brainstorm/review。
  • 典型调用:在支持 /egm: 前缀的宿主(Antigravity agy CLI、Claude Code)中运行 /egm:egm-brainstorm <一句话想法>;Codex 中从 skill picker 选择。artifact 目录可用 EGM artifact directory: .dev/docs 一行在指令文件(CLAUDE.md/AGENTS.md)中重定向,详见 docs/harnesses.md。
  • 产出与下游:concepts_brief.md 是本技能的唯一核心交付物;它要么被发布为 docs/designs/ 下的 RFC,要么作为 Priority 1 摄入源喂给 /egm-draft 生成正式设计文档。docs/designs/brainstorm.md 记录了该技能的设计动因——过早写正式设计文档会导致"对错误假设的过早承诺"与"无对抗评审的 AI 头脑风暴谄媚"两种失效模式,并给出了 Human → Skill → Synthesizer → 7 镜头 Goldfish 群 → Artifact 的时序图。

适用前提与限制:以上行为以当前仓库的 skills/egm-brainstorm/SKILL.md 为准;disable-model-invocation: true 意味着不能期望模型在普通对话中"自动"发起头脑风暴;各镜头人格文件的 REVIEW 模式行为(文档审计)不在本技能范畴内,属于 /egm-review 的委派路径。若你的 harness 没有子代理工具,按技能要求,正确行为是停下并告知用户,而不是退化为同上下文评审。

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