用户登录

技术文章

外部链接将在新标签页打开。

从写代码到查问题:agentic engineering 四个环节的职责边界

一句话回答

Agentic engineering 的四个环节——规划、写代码、审查变更、排查生产问题——边界应按“这一步错了能否在本环节内被发现”来划,而不是按 agent 的能力上限划。每个环节留可交接的产物:规划交可验证假设,写代码交可回滚的小步,审查交一致性证据,排查交收敛后的证据链;意图判断、因果定性和止损决策始终留给人。

核心要点 TL;DR
  • 划分依据不是 agent 能力上限,而是错误在该环节的可发现性与可逆性。
  • 边界如果只写在文档里会退化;每个环节要留下可交接的产物,边界才可执行。
  • 本次材料只含标题与摘要,GitHub 原文对各环节工具能力的具体描述未核验,本文不引用其细节。

把 agentic engineering 理解成“更强的代码生成”,边界一定会失守。GitHub 博客那篇开发者指南的标题与摘要给出的划分更实用:写代码变快了,但围绕写代码的工作没有同步变快;文章按规划、写代码、审查变更、排查生产问题四个环节展开(来源,据其摘要转述)。据此,职责边界不该按“agent 能不能做”来划,而该按“这一步做错了,能否在本环节内被发现”来划。

说明:本次材料只包含该文标题与摘要,未包含原文对各环节工具能力的具体描述,因此下文不引用其产品细节;涉及具体能力处标注待核实。

三个判断维度#

  • 可逆性:改错了能否低成本撤回。可逆的操作适合下放,不可逆的(改配置、动数据、对外发布)保留人工确认。
  • 验证成本:有没有便宜的检查手段。有测试、有类型、有 lint 的改动,错误在环节内就会暴露;只能靠“看起来对”判断的改动不行。
  • 上下文位置:判断所需信息是否都在可读材料里。仓库内的依赖关系可读,组织里的优先级和取舍不可读。

四个环节各自交付什么#

规划:交付假设,不交付决心

agent 适合把模糊需求拆成可验证假设、列出受影响的模块、给出验收条件与风险点。人保留的是:这件事要不要做、先做哪个、接受哪个取舍。越界信号是把 agent 写出的方案直接当成已决定的架构。

写代码:边界在“一步能回滚”

在明确契约下改小范围、补测试、做机械重构,属于可下放区间。接口形态、数据模型、跨模块约定这类改动,一旦合入就要别人跟着改,应保留人工决策。越界信号是一次提交横跨多个不相关模块——出了问题无法二分定位。

审查变更:agent 查一致性,人查意图

一致性是机械问题:命名与约定是否统一、调用点是否漏改、测试是否覆盖新增分支、边界条件是否处理。意图是另一回事:这个改动是否符合本意、是否该现在合、是否引入产品层面风险。agent 给出的审查意见应视为待复核线索,而不是结论。

排查生产问题:agent 收敛证据,人定因果与止损

从日志、指标、最近变更里收敛候选原因,列出待验证假设,是 agent 的强项,因为它是收敛型工作。人保留两件:先止损还是先定位,以及因果是否成立。把相关性当因果、直接回滚或改配置,是这一环节最常见的越界。

边界要落在交接物上#

只写在文档里的边界会退化成口头约定。每个环节应留下一个下游能直接用的物件:

环节可下放部分人保留交接物
规划拆假设、列影响面、写验收条件优先级与取舍每条假设附验证方式
写代码小范围改动、补测试、机械重构接口与数据模型可单独回滚的提交
审查变更一致性检查、遗漏调用点意图与合入时机按严重度分级的意见清单
排查问题收敛证据、生成候选假设因果确认与止损假设—证据—验证结果三列

最小交接模板(示例)#

以下为演示用文本模板,未执行,也不对应任何真实系统;方括号内为占位内容。

环节: [规划 / 写代码 / 审查 / 排查]
假设: [一句话,可被证伪]
证据: [日志行、指标名、文件路径]
验证方式: [命令或检查项]
可逆性: [可回滚 / 不可逆,需人工确认]
未决问题: [需要人判断的取舍]

三条常见越界#

  1. 把“能生成”当成“已验证”。生成只是产出了候选,验证仍是独立步骤。
  2. 只声明边界,不产出交接物。下游拿不到可复核的东西,边界等于没有。
  3. 在不可逆操作上让 agent 自主执行。改配置、动数据、对外发布应先停在人工确认。

至于各环节里具体工具能覆盖到哪一步,取决于所用产品与版本,本次材料未提供可核验细节,相关能力待核实。可操作的判断顺序仍是:先看这一步错了能否被发现,再看能否低成本撤回,最后才看 agent 做得多快。

常见问题(FAQ)

agentic engineering 和“AI 帮我写代码”差在哪?
按 GitHub 博客该文摘要的说法,写代码变快了,但围绕它的工作没有同步变快;文章把范围放在规划、写代码、审查变更、排查生产问题四个环节,而不只是代码生成这一步。
四个环节里人还要做什么?
三件事难以外包:要不要做(意图与优先级)、是不是这个原因(因果定性)、现在要不要止损(不可逆决策)。其余可验证、可回滚的部分更适合交给 agent。

参考来源

  1. Beyond code generation: A developer’s guide to agentic engineering

以上为本文写作时的参考资料,引用观点以原文为准。

作者:沐小悠

本文约 4 分钟读完 · 关键词:agentic engineering、职责边界、AI 编程助手、代码审查、生产问题排查

更多文章 GET 示例接口

「」标签下的其他文章