让人工批准的计划控制编程智能体写权限
文章建议把编程智能体拆分为不同工作模式,前期仅允许读取,待人工批准计划后再开放写入及其他有副作用的操作。该模式旨在减少任务范围悄然偏移,让执行边界提前可见。
AI 深度解读
AI 编程助手能读仓库、改文件、跑命令之后,团队要回答的就不只是「模型够不够聪明」,还有「它什么时候可以动手」。作者提出的办法很明确:先让 agent 在只读权限下理解任务、提交计划,由人批准后再开放写入,合并前再做一次人工把关。
这套流程值得看,是因为它把代码生成放回了工程交付里:先确认要做什么,再检查做得对不对。但文章提供的是流程主张和产品实践说明,没有给出效率或事故率的对照数据。
为什么等到看 diff 才审查,可能已经晚了
作者反对的是把理解、决策和执行塞进同一轮对话:用户提需求,agent 自己找代码、选方案、改文件,可能跑一下测试,最后交出 diff,也就是代码变更对比。
问题不在于每次都会改错,而在于人发现偏差时,动作已经发生了。
首先是范围偏移。用户和 agent 对任务的理解可能不同,等发现时,它已经碰了十二个文件。其次是审查成本:十行计划里就能看出来的方向错误,藏进 400 行 diff 后,需要花更多精力才能识别。
更麻烦的是,副作用不止存在于代码里。这里的副作用,指执行动作后改变了某处状态,例如运行数据库迁移、操作浏览器页面、调用外部工具。文件改坏了通常可以回退,外部状态变了却未必能恢复。
作者真正要提前审查的,是执行意图和影响范围。
因此,只在任务末尾检查代码还不够。团队还需要在第一次可能改变状态的动作前,确认方案是否成立。
四种模式要改变权限,不能只改变提示词
文章以 JuegoTech 的 JaiCode 为例,把 agent 的工作分成四种模式:
- Ask 负责理解,通过安全的只读搜索、代码导航和研究,摸清已有项目。
- Plan 负责决策,继续调查仓库、澄清范围,形成等待人工批准的结构化计划。
- Debug 负责诊断,先收集证据,诊断充分后再做针对性修复。
- Build 负责执行,在计划解锁后使用编辑、文档、Shell、浏览器、MCP 工具和检查点等能力。
关键不是界面上有四个按钮,而是不同模式拿到不同工具。作者强调,在 Ask 和 Plan 中,agent 应当确实无法写入项目。
这和在提示词里补一句「先别改代码」有区别。提示词表达行为要求,权限控制决定它能否执行动作。对于有写入能力的 Shell、浏览器和外部工具,也需要相应限制,不能只关闭文件编辑器就认为已经只读。
下面这段流程图说明了权限如何随计划审批发生变化:
[Ask] read-only tools ──► understanding, notes, open questions
│
[Plan] read-only tools ──► structured plan: scope, files, steps, risks
│
▼
HUMAN GATE: approve / edit / reject the plan
│
[Build] write tools enabled, scoped to the approved plan
│
[Review] automated review of the diff ──► human disposition: pass / fix / escalate
要看的是 [Build] 那一行:写入权限应该限定在已批准的计划内,而不是审批一次就获得后续所有操作的通行证。
作者建议,计划短到技术负责人几分钟就能看完,同时写清范围、预计修改的文件、实施步骤、风险、明确排除的工作,以及验证方式。批准这样的计划,才是在做一个可判断的决定。
批准计划之后,还需要两道边界
第一道边界是合并前审查。计划获批,只能说明准备做的事情方向正确,不能证明代码实现正确。
在 JaiCode 的流程中,Agent Review 会针对 diff 输出问题和结论,再由人决定 pass、fix 或 escalate,也就是通过、修复或升级处理。在 JuegoTech 的项目中,参与判断的是 Forward Deployment Engineer 和客户负责人。作者强调,不允许生成结果在无人明确处理的情况下悄悄合并。
于是,两个检查点各管一件事:动手前确认「是否该这么做」,合并前确认「是否做对了」。中间的执行过程可以高度自动化。
第二道边界是工具能够触达哪里。模式解决「能用什么工具」,路径授权和运行策略解决「工具能访问什么」。
原文举的例子是:允许读取 services/billing/** 并运行测试命令,但禁止读取 secrets/,也禁止调用部署脚本。即便处于只读阶段,也不代表所有内容都应该向 agent 开放。
作者还主张 local-first execution,让 agent 在自己的本地检出目录运行,以便观察过程。这在需要说明访问范围的合规团队里尤其有用。不过,文章没有展开路径限制、运行策略和计划范围校验的具体实现。
我的判断
我认同把方案审查前移,尤其是跨模块修改、数据库迁移、涉及外部工具的任务。它能让评审先讨论方案,再进入代码细节;计划、批准记录和 diff 也能连起来解释一次修改为什么发生。
但「计划获批才能写」是否值得用于所有任务,文章没有证明。对于修改一处文案这类范围清楚、容易撤销的工作,固定增加审批可能只是多一道等待。作者自己的落地建议也限定在非简单任务,没有要求每个小改动都走完整流程。
和常见的「生成代码后直接提 PR」相比,这套方法多了一次执行前决策,收益取决于任务风险和审查质量。如果计划写得含糊,审批只是回复一句 approved,仍然很难约束执行。
另一个缺口是授权如何落实。文章没说清 Build 超出计划时会被技术阻止,还是仅仅触发提醒;Debug 又如何获得修复权限,也没有展开。
批准记录可以表达授权,但真正的执行边界仍要靠工具权限落实。
至于这套模式能节省多少评审时间、减少多少返工,作者没给对照数据。目前更适合把它当作一套有理由的工程经验,而不是已经验证过的效率结论。文末提到的 multi-model BYOK 和本地执行能力,也不能单独证明审批流程有效。
能拿来做什么
- 对跨组件重构或 Node 服务改造,先用只读会话让 agent 列出调用关系、相关文件和未决问题,再决定是否进入实施阶段。
- 在 PR 描述中保存短计划,写清修改范围、排除项和测试方式。审查 diff 时,把计划之外的文件作为需要解释的内容。
- 分别配置读取和执行权限,例如限制
services/billing/**的访问范围,阻止读取secrets/和调用部署脚本,并检查 Shell 是否能绕过限制。 - 在合并流程中保留人工签字,把 Agent Review 的发现作为审查输入,由负责人决定通过、修复还是升级处理。