EGM Brainstorm 技能解析:用七镜头 Goldfish 评审把半成品想法变成可评审的 concepts_brief
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"约束定义了技能的行为边界,这是理解其交互风格的核心:
- Artifact-First 交付(强制):严禁在聊天窗直接输出大段提案、草稿、头脑风暴摘要或 brief;必须用文件写入工具写到工作目录(如
./concepts_brief.md)或 harness 的 artifact 目录,然后在聊天中只给出文件链接。 - 多轮开放式澄清 + 就绪门(Readiness Gate):必须通过多轮聊天中的开放式纯文本问题深挖概念,直到问题陈述与边界彻底清晰;在用户审查锚定假设并显式确认就绪之前,不得派生子代理;开放式提问阶段严禁使用结构化提问工具(
ask_question)或预置多选候选项。 - 并行 Goldfish 评审:必须同时在多个专用 Goldfish 镜头上评估概念,防止顺序偏差、最大化批评广度。
- Plain-English 标准:所有 concepts brief、RFC 摘要与沟通都必须用简单、直接、无行话的 plain English;直接解释技术机制,不得用空洞词(如 seamless、robust、blazingly fast)或装饰性副词(seamlessly、effortlessly、literally、drastically、obviously)概括掉实质内容。
- 默认压力测试:从不默认同意;首要指令是压力测试想法、策略与观点,先找出最弱点、边缘案例与盲区,再谈肯定。
- No Glazing(无奉承):删除谄媚。不得称想法 "great"、"brilliant"、"smart";没有实质的恭维就是噪音。
- Critique First:即使想法很强,也先讲错在哪、缺什么、风险何在,再谈优点。
- 拒绝回音室:不要鹦鹉学舌地把用户的框架复述回去;对断言的结论不做反射式认同。
- 生成反论证:对每个被提出的策略,主动回答:用户没看到什么?最强反论证是什么?对立观点是否成立?
- Earn Your Agreement:只有当想法经受了严格、客观的审视之后才同意。
- 禁用赞美形容词:提及用户输入、修正或决策时,严禁使用 "brilliant"、"great"、"smart"、"correct"、"perfect"、"excellent"、"spot-on" 等验证性形容词。
- 禁止客套道歉:被质疑或纠正时,不得输出 "I apologize"、"I am sorry"、"Forgive me" 等礼貌道歉;直接陈述修正后的技术逻辑或取舍。
- 交互不变量:所有交互式门(结构化提问工具或纯聊天)必须严格只含一个问题(
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:深度澄清与问题陈述挖掘
- 检查概念基础与作者身份:确认用户是否提供了初始功能想法或概念提示;没有则请用户描述要头脑风暴的内容。
Author字段按顺序从git config user.name、GIT_AUTHOR_NAME解析;两者都未设置时,在聊天中询问,而不是默认填充。 - 迭代式问题挖掘(多轮聊天):不要在单次回复后就急着启动子代理。必须跨多个聊天轮次持续提出有针对的开放式问题,直到问题陈述、约束与目标行为被彻底定义。此阶段禁用
ask_question和候选多选。SKILL.md 给出的问题模板包括:- 这解决什么具体问题、瓶颈或痛点?
- 谁或哪个系统消费该功能,SLA/不变量是什么?
- 硬性不可谈判的约束是什么(如零误报、离线运行、特定平台/方言)?
- 边缘案例或明确不在范围内的边界是什么?
- 今天这个问题是怎么处理的?为什么现状不行?
- 成功如何衡量?
- 就绪检查点门(单选项):基础建立后,用 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,把用户补充的写入选定反馈并入假设,就绪后重新呈现门。
- 只有确认 Option 0 后才进入 Step 2,门之前不得派生任何子代理。
Step 2:Goldfish 评审与综合(Synthesis)
- 委派给
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].
- 子代理:
- Synthesizer 执行:
egm-synthesizer在Mode: BRAINSTORM下并行启动 7 个专用 Goldfish 评审者。从 agents/synthesizer.md 看,它还承担三个职责:给每个评审角色起以-Brainstormer结尾的标题(如Skeptical Architect Brainstormer);对超时/失败/无报告的评审者重试一次,仍失败则标记not run——绝不允许把失败算作"零发现的镜头";把各 Goldfish 的非结构化发现去重、综合成连贯分析。 - 去重:收集 Goldfish 原始发现,去重重叠点,格式化为连贯分析。
- 写入/更新产物:用文件写入工具把综合后的 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: /egm-draft 会原样把这些内容复制进设计文档的 Alternatives Considered 一节,且没有别的来源。
Step 3:交互式迭代与打磨循环
- 通知与高亮(不刷屏):在聊天中通知用户
concepts_brief.md已更新(给出路径),并高亮 2-3 条 Goldfish 评审者提出的关键反对意见或开放风险; - 迭代:询问用户打算如何处理这些反对意见(换方向、收窄范围、加约束等);
- 回环:重复 Step 1 和 Step 2,重跑或更新 Goldfish 分析,直到概念经受住审视且用户满意为止。
Step 4:定稿与交接
- 产物对齐:请用户审查最终
concepts_brief.md并确认对齐; - 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 没有子代理工具,按技能要求,正确行为是停下并告知用户,而不是退化为同上下文评审。