docs: require subagent closeout before task end

2026-07-13 09:45:58 +02:00
parent 5ea7c0bf60
commit cc2c4201d4
3 changed files with 28 additions and 0 deletions
@@ -64,6 +64,26 @@ description: UniDesk 主代理调度子代理的必读技能。用户提到子
 - 子代理完成后必须留下可审查工件：PR、issue comment、commit、验证输出摘要、部署/observer/trace 证据或阻塞说明；主代理不能只凭口头结论合并。
 - 子代理长时间无响应时，主代理按“问询 -> 只读检查 worktree/PR/issue -> 再窄问询”的顺序处理；多次问询仍无回复时，可以关闭旧子代理，并在原 worktree/原分支/原 issue 边界上重开新子代理接续。重开前不得删除或重置旧 worktree；新子代理必须先读取原 worktree 状态和既有 issue/PR/comment 链接，再继续最小下一步。
 - 子代理完成任务后，主代理必须再给该子代理发送 post-task 收口要求；若主代理要求子代理纠偏或补验证，则等纠偏完成后再发 post-task。post-task 反馈由子代理按 `$post-task` 自行给出判断，主代理不负责反馈池去重；主代理只从子代理提好的反馈中挑选适合工程化的项转成正式 FEATURE/BUG issue，并优先派回提出该反馈的子代理执行。
+- 主代理结束条件：
+  - 当前用户任务只要派出过子代理：
+    - 主代理就必须保持任务进行中；
+    - 等待本轮全部子代理进入真实终态；
+    - 不得把 task 创建成功、dispatch 成功、`running`、已提交 commit 或已创建 PR 当作主代理可以结束的交付点。
+  - 子代理返回后，主代理必须继续完成职责范围内的收尾：
+    - 完成必要的纠偏和 post-task；
+    - 审核 PR 并执行获授权的合并；
+    - 同步目标分支；
+    - 完成任务要求的自动交付、线上验证或原入口复测。
+  - 主代理还必须完成治理收尾：
+    - 完成对应 issue closeout；
+    - 写入 MDTODO 任务报告并更新状态；
+    - 清理已吸收的 worktree 和分支；
+    - 确认没有本轮子代理遗留的必要收尾后，才可以向用户结束当前任务。
+  - 不得以“异步派发”“非阻塞支线”或“后续再观察”为由提前结束。
+  - 只有满足以下任一条件时才可停止等待：
+    - 用户明确取消或暂停；
+    - 出现需要用户新增授权且无法继续的外部阻塞。
+  - 因取消、暂停或外部阻塞停止等待时，不得把任务报告为已完成。

 ## 主线与支线隔离