AI智能体如何先设计再编码:elephant-goldfish-model的双角色审查
让AI智能体写代码之前,怎样发现那些“聊天时都懂,文档里却没写”的设计假设?elephant-goldfish-model把这个问题拆成两项任务:由熟悉项目的角色起草规格,再让没有先前对话背景的角色审查。它关注的不是直接增加代码产量,而是把隐含决策变成可讨论、可批准的设计。下面以一个明确标为假设的通知服务改造场景,解释这套方法的机制与边界。
通知失败要不要重试,为什么不能留到写代码时再决定?
假设一个团队准备给订单系统增加Webhook通知,即事件发生后向外部服务发送HTTP请求。需求看起来只有“订单变化时通知客户”,但失败后重试几次、重复事件如何处理、接收方超时是否代表未收到,都可能改变实现方案。这些是假设场景中的待决问题,并非项目已经提供的通知能力。
README建议在功能需要先做设计决策再实现时使用EGM。这里真正需要提前处理的,是不同参与者对同一句需求的不同理解。若直接进入编码,代理可能把未说明的规则自行补齐;设计审查则尝试先让这些选择显形,让人能够在代码形成之前讨论其代价。
EGM把设计起草与陌生视角审查分成两项任务
EGM是一款用于在写代码前起草规格、并用无先前对话上下文的子智能体审查规格的公开插件。它不是本文假设场景里的通知系统,也不是一个替团队自动决定架构的服务,而是配合编码代理使用的一组设计与审查技能。
它的思路可以理解为:先让熟悉来龙去脉的参与者把方案写完整,再请没有参与前期讨论的参与者检查能否读懂。在通知服务场景中,前者可能知道团队曾口头同意“允许重复投递”,后者则会追问文档有没有明确写出这一点。目标不是让两个角色重复回答,而是利用信息差暴露遗漏。这种分工能否改善具体团队的设计质量,仍需要实际使用来判断。
大象记住项目背景,金鱼只看草稿和引用材料
Elephant负责持有项目上下文并起草规格。这里的Elephant意为“大象”,用来比喻保留项目背景、需求与先前决策的角色;Goldfish意为“金鱼”,强调审查者不继承此前的聊天记录。
无先前对话上下文,不等于没有任何材料。金鱼审查者会阅读草稿以及草稿引用的源材料,因此它检查的是方案能否依靠明确材料成立,而不是凭空猜测系统。回到假设场景,如果“重试期间可能重复发送”只存在于聊天里,审查者就有机会指出文档缺口。README同时把架构取舍和规格批准交给使用者:代理负责提出与质疑,人负责决定哪些约束和代价可以接受。
从概念简报到设计批准,每一步都保留人的反馈
README给出的入门路径先讨论需求和取舍,由新建审查者挑战提案,再保存达成一致的方向。代理会把商定的方向保存到`concepts_brief.md`。这份概念简报可以理解为设计前的共识记录,而不是已经批准的完整规格。
随后,起草阶段把简报转为`design_draft.md`,并在每一节之后暂停,等待人在聊天中反馈。审查阶段再检查设计、表达清晰度、与代码的契合程度及实施计划。对于假设的通知服务,团队可以先明确失败语义,再逐段检查重试与重复处理的安排。使用者选择处理哪些发现,批准设计后再要求编码代理实施,避免把“生成了草稿”误当成“方案已被接受”。
完整插件提供的不只是技能入口,还有审查提示与文档标准
README要求安装完整插件,以便技能读取审查提示和文档标准。这说明它描述的使用单元不只是一个命令名称:技能还需要相应材料,才能按项目预设的方式组织起草与审查。不能仅因看到了技能名称,就假定复制一句提示词能够复现同样流程。
在假设场景中,值得关注的也不是能否迅速生成一份通知设计,而是审查材料是否齐备、文档是否把规则写到可供他人检查的程度。另一个关键设计是逐节反馈:它为人保留中途修正方向的机会。不过,README没有在所给材料中展开全部文档标准与审查提示的具体内容,因此不能据此推断它一定覆盖某类故障模式,或满足某项内部规范。
已有设计笔记也能切入,不必每次走完整条流程
各项技能可以按需单独使用,不必遵循完整顺序。因此,适用入口不只限于“从零开始设计”:如果团队已经有通知服务的讨论记录,可以考虑从起草环节切入;如果已有设计稿,则可以关注审查与处理审查意见的环节,而不是为了走流程重新讨论全部需求。
README还列出为既有代码库创建或更新文档、比较已提交文档与当前源码的用途,后者可理解为检查文档是否偏离实现。这些能力适合围绕设计材料的不同状态选择使用。相反,对于范围小、含义清楚的缺陷修复,README建议沿用正常编码流程。先判断有没有真正的设计分歧,再决定是否引入额外审查步骤。
新建子智能体是审查前提,审查结果也不能替代测试
如果代理不能创建新的子智能体上下文,EGM会停止审查。子智能体可以理解为由主代理派出的独立任务执行角色;这里强调的是其对话上下文必须新建,而不只是给原对话中的同一角色换个名字。这项前提直接关系到“陌生读者视角”能否成立。
README还明确指出,审查不能替代测试或人的判断。假设通知方案通过了文档审查,也不能由此认定重试逻辑运行正确、重复事件处理可靠,或上线后不会遗漏通知。本文未独立实测,无法确认各环境中的实际执行表现;所给材料也没有展开数据处理、敏感信息边界或具体资源消耗,这些都应作为使用前尚待确认的问题。
使用前先核对设计需求、材料范围和环境能力
README要求安装后启动新会话。但正式开始之前,更重要的是确认三件事:任务是否确有未定的设计选择,草稿和引用材料能否承载必要背景,以及所选代理环境能否创建新的子智能体。安装入口可见,并不等于本地条件已经满足全部流程要求。
对于假设的通知服务,可以先选“失败与重复投递如何处理”作为边界清楚的小议题,约定谁批准最终规则、哪些代码可被引用,以及审查发现如何进入后续工作。观察重点应是文档是否更明确、分歧是否更早暴露,而不是把审查轮数当作质量指标。如果关键背景无法写入材料,或团队无法安排人做取舍,那么先补齐这些条件,比直接启动整套流程更稳妥。
这套方法最值得理解的,是让“知道背景的人负责写清楚,不知道背景的人负责追问”,并把最终决定留给人。它能提供设计讨论的结构,但不能自动证明方案正确,更不能代替实现后的验证。本文仅依据README资料整理,未独立实测。
参考来源
本文仅据固定版本 README 整理,未独立实测;仅作技术介绍,不构成安全审计或投资建议。
采集时间:2026-11-05T21:11:19.050Z;12372 Star 快照。相对 2026-11-04T19:12:46.389Z,实际间隔 25.98 小时净变化 718 Star;不是自然日新增。
google/elephant-goldfish-model README · ccf79c5c0fb5df7815685d5e4994fd9aad8954bd
本文基于公开媒体报道整理,仅作信息参考,不构成任何投资依据,内容以原文为准。





