成为赞助商——支持中文 Agent 生态

了解赞助
库Agent场景库
← 返回用例列表

Zeybek:给 Agent PR 加范围/行为/测序 CI 闸,而不是「再仔细读」

对照团队工程案例:Agent PR 过半后事故促改;声明范围 diff 预算、行为变更清单、先读代码再读测;披露首审中位约 5h→2h、体量约 310→160、两周回滚 6→1;不代你降事故、不外推。

场景说明

面向 Agent 大量开 PR 的团队:把「加人多审一轮」写成可对账的 PR 工件+CI 失败即修,区别于自治 CI 贡献者与 hooks 工作流引擎。

案例叙事

01他们做了什么

Ahmet Zeybek 在《How we review pull requests that an agent wrote》(页内 2026-06-23;JSON-LD datePublished 2026-06-23 → 2026-06-23)写明:主服务上编码 Agent 开的 PR 从约一月五分之一升到五月过半;旧评审默认「作者理解每一行」不再成立。四月一次事故:Agent 正确改了 schema,但默默去掉默认值,作者未察却获两票批准。失败模式是光环改动、同作者自写自测绿灯、以及顺带重构扩 scope——「再仔细读」无效。

对策写入 CI:① PR 描述声明文件/目录范围,diff 越界即失败并列出文件;② 可观察行为变更必须成清单(弱校验:相关路径变更时段落非空);③ 评审工具先折叠测试,先读代码再把测试当「主张」核对;改测需一行理由。另设约 400 行变更上限(不计生成物/lockfile)。停做:迷信绿灯、给 Agent PR 加第二审批人分责、把时间花在风格上。作者职责写成模板确认:开 PR 即声明已读每一行改动。检查失败文案按 Agent 可读来写,一个月后多数 PR 在人看前已自带范围与行为段。数字(作者仓窗口):引入检查后约五月至八月,首审中位约 5 小时→约 2 小时;中位 PR 体量约 310→160 行;合并两周内回滚从变更前一季 6 次→后一季 1 次(且该次为人写 PR)。本场景据此输出「Agent PR 工件闸」提纲。禁止声称事故率对你仓已下降。

02实际效果

  • 源披露首审中位约 5h→2h、中位体量约 310→160、两周回滚 6→1,以及约 400 行上限等团队窗口数字;属作者服务仓叙事,不可外推为你的缺陷密度或评审 SLA。
  • 能把「再加人多审」与「范围/行为/测序 CI 工件 + 单人责任制」拆开。
  • 为光环改动、测俘获与双批准分责提供提问清单。

03值得知道

  • 行为清单校验偏弱,仍依赖人对照 diff。
  • 拉取分支手测 10–20 分钟有团队争议,需按风险分级。
  • 上面写的是个人/团队工程博客,不是 GitHub 官方评审文档。

04可复制提示词

Agent PR 工件闸简报

你是工程流程顾问。只根据用户约束写提问清单,不要编造已上线。

仓与 CI:{{repo_ci}}
Agent 开 PR 占比:{{agent_pr_share}}
行数上限偏好:{{line_cap}}

输出 Markdown:
1. Scope/Behaviour 模板字段
2. CI 检查失败应打印给 Agent 的文案要点
3. 单审责任制与禁项
4. 人工周回顾清单
禁止声称回滚率已下降;禁止建议取消人审。

默认值被静默删除复盘提纲

Agent PR 去掉某列默认值导致生产事故,请写复盘提纲。

PR 摘要:{{pr}}
当时审批情况:{{approvals}}

输出:
1. 是范围未声明、行为清单缺失,还是测被改成迎合新行为
2. 最小门禁补丁
3. 数据回填/热修步骤
4. 人工确认清单
不要伪造「事故已自动消除」。

怎么做

  1. 粘贴当前 PR 模板、Agent 占比,以及是否允许 CI 因范围越界失败
  2. Agent 按实践帖输出:Scope 段格式→行为清单规则→测改分阅→行数上限提问清单
  3. 人工保留合并与事故责任;Agent 不代你声称回滚率已下降

实用提示

  • 源帖:四月因默认值被静默删掉导致生产事故;对策是改「评审前必须具备的工件」,不是加第二审批人
  • 与 clickhouse-groeneai-autonomous-contributor / nick-tune-claude-hooks-workflow-engine 不同:本条是人审 Agent PR 的 CI 工件闸,不是仓库自治修 CI 或 hooks 当工作流引擎
#Agent PR#代码评审#CI 闸#范围预算#团队工程