Matt Pocock演讲:AI时代,代码才是Agent的第一提示词

AI时代代码基本功成为驱动Agent的核心杠杆,三层护栏让Agent在可控轨道上工作。
Matt Pocock 提出「代码是 Agent 的第一提示词」,认为 AI 时代代码质量非但未过时,反而成为驾驭 Agent 的核心杠杆。他构建了三层护栏体系:自动化检查(lint、类型检查)成本低可无限堆叠;测试护栏要求设计难以被糊弄的测试,避免同义反复、过度 mock 和只测快乐路径;设计护栏倡导「深模块」理念,用极简接口封装复杂性,限制 Agent 的修改范围。此外,他给出四条实践建议:将代码审查规则从 AGENTS.md 分离到独立审查流程;用「引导词」压缩架构意图为 Agent 的思维术语;借用单向门/双向门框架决定审查力度;通过复盘让护栏体系持续进化。最后他指出,新人应先在内部工具中锻炼战略思维,再过渡到核心产品。
在AI编程工具泛滥的今天,一个反直觉的观点正在浮现:代码质量非但没有过时,反而成为驾驭AI Agent的核心杠杆。TypeScript社区知名教育者Matt Pocock在一场演讲中系统阐述了他的思考——代码是Agent的第一提示词。他提出用「自动化护栏、测试护栏、设计护栏」三层体系,把AI的产出约束在可控轨道上。
为什么AI时代基本功反而更重要
Matt Pocock开场就抛出一个尖锐问题:当AI能完成大量编码工作时,我们坐在这里学习基本功的意义是什么?
他的回答是:AI让代码生成变得廉价,但代码的可维护性、可测试性、可读性这些「老派」要求,恰恰是Agent能否被有效驱动的前提。Pocock直言,React理解力这类基本功不仅没有贬值,反而比以往更加重要——因为你需要用这些知识去构建约束Agent的框架,而不仅仅是自己写代码。
这个判断的底层逻辑是:Agent的工作成果最终要落到代码库中,而代码库的结构决定了Agent能走多远。一个混乱的代码库会让Agent越改越乱,一个设计良好的模块则能让Agent的输出自然收敛。

Agent工程的三层护栏
Pocock将支撑Agent高效工作的基础设施拆解为三层,这也是整场演讲的核心框架。
第一层:自动化护栏——让机器拦住机器
自动化检查(lint、类型检查、编译期校验)是成本最低的护栏。它们消耗的是CPU时间而非token,可以无限堆叠。Pocock特别提到,随着TypeScript、Rust以及OXLint等工具链的提速,现在可以往项目里塞入大量静态检查规则而几乎不增加负担。
他的建议很直接:推动团队把lint规则拉到最严。对Agent而言,每一条lint规则都是一次即时的纠偏,能在代码生成阶段就拦截错误,而不是留到人工审查环节。他还分享了一个细节:自己曾为同事写定制lint规则,当时担心是否小题大做,但在Agent时代,这种做法成了标配——因为Agent不会因为「不好意思」而绕过规则,规则写死了它就照做。
第二层:测试护栏——让Agent学会自我验证
测试是三层中最难做对的一层。Pocock用几个反例说明什么样的测试对Agent毫无价值:
- 同义反复测试:测试只是复述实现逻辑,代码一变测试就得跟着改,既不能发现问题也无法验证行为。
- 过度mock的测试:mock掉了真实环境中的复杂交互,测试通过但生产环境照样崩溃。
- 只测「快乐路径」的测试:无法覆盖Agent可能引入的边界错误。
他强调,Agent并没有让写测试变得更容易——恰恰相反,生成看似合理的劣质测试正是AI的强项。因此人类需要把精力放在设计「难以被糊弄」的测试上,让测试真正成为Agent的验收标准。

「深模块」(Deep Module)是 John Ousterhout 在《软件设计哲学》(A Philosophy of Software Design)中提出的核心设计原则:模块的价值取决于它隐藏的复杂性与其对外暴露的接口之比。一个「深」的模块通过极简的公开接口封装了大量内部实现细节,调用者无需理解内部逻辑即可正确使用;相反,「浅模块」的接口与实现复杂度相当,甚至接口比实现还复杂,导致复杂性外泄。对 Agent 而言,深模块意味着它只能看到有限的公开接口,无法直接触碰内部实现,从而在结构上限制了其修改范围;同时测试也只需验证接口行为,而不必关心实现细节,降低了测试维护成本。
第三层:设计护栏——模块边界就是提示词边界
这是Pocock演讲中最有洞察力的部分。他借用John Ousterhout《软件设计哲学》中的「深模块」概念:好的模块对外暴露极简接口,把复杂性封装在内部。
这种设计对Agent的意义在于:当模块足够「深」,Agent只能通过公开接口与它交互,无法窥探内部实现,也就无法在内部胡乱修改。测试同样受益——测试只需针对接口行为,而不是实现细节。Pocock指出,React生态长期鼓励把状态和逻辑散落在组件各处,这与「深模块」理念相悖,也给了Agent过多可乘之机。他建议把状态集中管理(如使用状态管理库),让状态成为可独立测试的单元,而不是散落在UI层。
四个可落地的工程实践
基于上述框架,Pocock给出了几条具体建议,部分观点来自现场问答环节的补充。
把代码审查规则从AGENTS.md里拿出来
许多团队习惯把所有规范塞进AGENTS.md,但Pocock认为代码审查规则不应放在那里。原因是AGENTS.md是每个会话都会加载的全局上下文,如果把审查规则放进去,Agent在写代码时就会「分心」——它会提前考虑审查意见,反而束手束脚。
正确做法是把审查规则放在独立的审查流程中:Agent写完代码后,再由专门的审查Agent读取diff和规则文件进行审查。这种两阶段设计让写代码和审代码各司其职,Pocock称其能显著提升Agent的产出质量。
AGENTS.md 是一种面向 AI 编码代理的配置文件约定,类似于给 Agent 的「工作手册」:它会在每个会话开始时被加载为全局上下文,用于声明项目的技术栈、编码规范、目录结构、常用命令等。由于它作用于整个会话,内容应当聚焦于「如何写代码」而非「如何审代码」。如果把审查规则也塞入 AGENTS.md,Agent 在生成代码时就会提前考虑审查意见,导致推理分心、束手束脚。因此,更合理的做法是将审查规则独立存放,由专门的审查 Agent 在代码生成完成后读取 diff 和规则文件进行审查,实现写与审的职责分离。
用「引导词」塑造Agent的思维语言
Pocock提出一个有趣的概念:引导词(leading words)。当你在编码规范中定义诸如「乐观更新」「深模块」这样的术语时,Agent会在内部推理中复用这些词,从而把复杂的架构意图压缩成几个token的「思维捷径」。

这意味着,团队沉淀的领域术语本身就是一种高效的提示词工程。术语越精准,Agent的推理路径就越接近资深工程师的思路。
「引导词」的概念可类比于领域驱动设计中的「通用语言」(Ubiquitous Language):在团队内部形成一套精确、共享的术语体系,用以描述业务规则和架构决策。当这些术语被写入编码规范时,Agent 在推理过程中会自然复用它们,将一段冗长的架构意图压缩为几个 token 的「思维捷径」。例如,定义「乐观更新」这一术语后,Agent 无需每次重新推导更新策略,而是直接引用该词作为推理锚点。术语越精准、越贴近团队实际,Agent 的推理路径就越接近资深工程师的思维模式,从而提升决策质量。
区分单向门与双向门,决定审查力度
针对「AI审AI是否可信」的疑问,Pocock借用了亚马逊的单向门/双向门决策框架:
- 单向门:不可逆或难以回滚的变更(如涉及金融、医疗等敏感领域),必须保留人工审查。
- 双向门:可以快速回滚的变更(如改个变量名),可以放心交给Agent自动审查和合并。

他还补充了一个设计层面的思路:通过代码设计把单向门改造成双向门——比如保留数据、支持回滚,让原本不可逆的操作变得可逆,从而扩大Agent可以自主处理的范围。
「单向门/双向门」框架源自亚马逊的决策方法论:单向门指不可逆或难以回滚的决策,一旦通过便无法回头,需要谨慎评估、充分论证并保留人工审查;双向门指可快速回滚的决策,试错成本低,可以授权给自动化流程或一线人员快速推进。在 Agent 工程中,这一框架用于划分审查力度:涉及金融、医疗等敏感领域的单向门变更必须人工介入,而改变量名等双向门变更可放心交给 Agent 自动审查合并。更进一步,通过代码设计(如保留数据、支持回滚)可以把原本的单向门改造成双向门,从而扩大 Agent 可自主处理的范围,提升整体效率。
用复盘让系统持续进化
Pocock推荐在每次Agent会话后做一次「复盘」(retro),哪怕任务完成得很顺利。复盘Agent会分析本次会话的效率、发现的问题,并把改进建议反哺到lint规则、测试模板和编码规范中。这套机制让护栏体系随着使用不断加厚,而不是一次配置后放任不管。
新手如何参与Agent流水线
现场有观众提问:在AI承担大量基础工作的团队里,新人如何成长?Pocock的回答是:让新人先为内部构建工具,而不是直接参与产品开发。
内部工具的用户是同事,反馈快、风险低,新人可以在真实场景中练习战略思维——思考代码的长期演进,而不只是完成眼前任务。Pocock将工程师的成长分为战术层和战略层:战术层是完成手头的任务,战略层是理解系统如何演进。Agent擅长战术执行,人类的核心价值在战略判断。让新人在低风险的内部工具中锻炼战略思维,再逐步过渡到核心产品,是更合理的路径。
结语:基本功是给Agent铺的路
Matt Pocock的整场演讲指向一个结论:AI并没有降低对工程师基本功的要求,而是改变了基本功的用途。过去你写代码是为了让机器执行,现在你写代码、写测试、写规范、设计模块,是为了让Agent在正确的轨道上运行。代码是Agent的第一提示词——你的代码库有多清晰,Agent就有多可靠。
相关推荐
科技前沿Textly:Mac上任意位置抓取文字和表格的效率神器
Textly是一款Mac菜单栏效率工具,支持从截图、PDF、视频和应用中框选捕获文字与表格,保持行列完整并导出CSV、Markdown、TSV,还内置即时翻译和剪贴板历史。
科技前沿Frameboy:World Labs Atlas 世界模型浏览器实时体验
World Labs 在 Product Hunt 发布 Frameboy,基于 Atlas 世界模型的浏览器实时演示,移动相机即可在云端 GPU 生成新视角,最高 15 fps 串流,探索 AI 生成的可漫游世界。
科技前沿Keypause:一键锁定Mac键盘,清洁时不再误触
Keypause是一款Mac菜单栏应用,一键锁定键盘所有按键,方便清洁时避免误触。本文介绍其功能、使用体验、潜在风险及适用场景,帮你判断是否值得尝试。