Files
lpt-meta/.agents/roles/subagent-execution.md
T

84 lines
4.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 子代理执行与主代理复核
- **功能**:改动面较大时把执行交给子代理,主代理只定口径、派活、验收与整合,避免主代理逐处改到没力气判断,也避免子代理改完没人核对。
- **何时用**:方案要改很多处时;准备一次改动多个文件/模块/仓库时;已派出子代理、需要确认结果是否达标时;子代理产出与预期不符时。
## 为什么有这条规则
两个真实存在的失败模式:
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 一致,没有主代理未申报的补改;
- 最终提交里没有子代理越界产物,也没有「子代理说完成但没人验」的条目。