84 lines
4.8 KiB
Markdown
84 lines
4.8 KiB
Markdown
# 子代理执行与主代理复核
|
||
|
||
- **功能**:改动面较大时把执行交给子代理,主代理只定口径、派活、验收与整合,避免主代理逐处改到没力气判断,也避免子代理改完没人核对。
|
||
- **何时用**:方案要改很多处时;准备一次改动多个文件/模块/仓库时;已派出子代理、需要确认结果是否达标时;子代理产出与预期不符时。
|
||
|
||
## 为什么有这条规则
|
||
|
||
两个真实存在的失败模式:
|
||
|
||
1. **主代理逐处改。** 一次改动铺开十几个文件,主线上下文被读取、试错、回滚占满,真正需要判断的部分(口径是否走偏、边界是否被突破)反而没力气看。
|
||
2. **改动者自己宣布完成。** 改代码和判断「改得对不对」是同一份被细节淹没的上下文,越界改动、漏改、测试没真跑都容易漏过去。
|
||
|
||
委派的收益不是「省字」,而是把执行切成边界清楚的单元,并把最终判断留给一份没有被改动细节淹没的上下文。
|
||
|
||
## 规则
|
||
|
||
### R1 先估改动面,再决定谁写
|
||
|
||
开工前先列改动面清单:要改哪些文件/模块/仓库,彼此是否有依赖。满足任一条就按本规则委派执行:
|
||
|
||
- 改动落在 **3 个及以上互不依赖的改动单元**(不同模块、不相关文件组、或独立子项目);
|
||
- 需要跨 **2 个及以上子项目**(如后端 + 前端 + AI 服务);
|
||
- 同一批改动要来回试错多轮,主代理继续做会把上下文吃光。
|
||
|
||
达不到上述规模时主代理直接做,不要为了「用上子代理」硬拆。
|
||
|
||
### R2 按接缝拆,按单元派
|
||
|
||
按**依赖接缝**拆,不按文件数平均分。每个子任务是一个可独立验收的改动单元,并具备:
|
||
|
||
- 明确的写边界:只能改哪些文件/目录;越界必须先回来问;
|
||
- 明确的完成定义:改完后应该是什么行为,怎么证明;
|
||
- 互不重叠的写范围。同一目录单写入者仍然成立(见 `parallel-and-delegation.md`),必须同目录并行时用 worktree 隔离。
|
||
|
||
有真实依赖的单元串行派,无依赖的同时派;不要逐个等。
|
||
|
||
### R3 派活说明写全
|
||
|
||
按 `parallel-and-delegation.md` 的「派发说明要写全」:已确认口径、涉及文件、验收命令、提交信息。另外必须补两条:
|
||
|
||
- **写边界**:允许改动的文件清单;边界外一律先问。
|
||
- **输出要求**:返回实际 diff 摘要、跑过的命令与结果、未完成项或存疑项。只回「已完成」视为信息不全,退回。
|
||
|
||
### R4 主代理只做定口径、验收、整合
|
||
|
||
委派之后,主代理**不再逐个文件改同一批改动**。它的工作是:
|
||
|
||
1. 定口径与验收标准——口径没定就派不出去,先定再派;
|
||
2. 发任务并跟踪返回;
|
||
3. 收结果后自己跑验收命令、读 diff,核对是否越界、是否漏改;
|
||
4. 整合提交、收口 todo、对外汇报。
|
||
|
||
验收不通过时,把**具体差异**回给同一个子代理(resume / steer)让它继续改,不要主代理接手重写;同一子代理连续两次改不对,主代理才接手,并把原因写进记录或笔记。
|
||
|
||
### R5 复核看证据,不看声明
|
||
|
||
复核至少覆盖以下各项,任一项不通过就不算完成:
|
||
|
||
- diff 是否只落在允许的文件范围内,有没有顺手重构、加功能、改口径;
|
||
- 子代理声称跑过的验收命令,主代理自己再跑一次并看到通过;
|
||
- 有没有留下调试代码、临时文件、被注释掉的旧逻辑;
|
||
- 提交信息是否符合 `commit-convention.md`;
|
||
- 多单元改动合并后整体行为是否仍成立(跨单元边界最容易出问题)。
|
||
|
||
### R6 这些情况不委派
|
||
|
||
- 单文件、单点小改;
|
||
- 方案口径还没定——先定口径,再派执行;
|
||
- 改动本身就是探索性的(要来回试才知道改什么)——主代理先探明,再把确定的执行部分派出去;
|
||
- meta 仓库根目录的 `AGENTS.md`、`.agents/`、`OPTIMIZATION_BACKLOG.md`:由主代理自己写,子代理只读(避免 meta 仓库并发写)。
|
||
|
||
## 边界
|
||
|
||
- 委派不改变责任归属:口径、最终判断、提交、对外汇报都在主代理。
|
||
- 不得以「已派给子代理」为由跳过复核;也不得把复核再转派出去后自己不看 diff。
|
||
- 用户明确要求主代理自己做,或当前入口没有子代理能力时,按用户要求执行,并在回复里说明未委派的原因。
|
||
- 本规则约束的是「谁写、谁验」,不重复并行与依赖判断,后者仍以 `parallel-and-delegation.md` 为准。
|
||
|
||
## 怎么核对
|
||
|
||
- 每个委派批次都能说清:拆分依据、每个子任务的写边界、验收命令与结果;
|
||
- 主线看到的 diff 与子代理返回的 diff 一致,没有主代理未申报的补改;
|
||
- 最终提交里没有子代理越界产物,也没有「子代理说完成但没人验」的条目。
|