docs: define subagent no-response handoff

2026-07-04 05:32:36 +00:00
parent 48b4116e08
commit 545941d5b8
2 changed files with 9 additions and 0 deletions
@@ -19,6 +19,7 @@ description: UniDesk 主代理调度子代理的必读技能。用户提到子
 - 需要提交 PR 的子代理必须在 PR 前自行用相关独立单步跑通目标运行面验证并保存 bounded 证据；测不通就继续定位和修改，直到该单步在目标侧通过。只有权限、外部依赖、架构取舍或明确越界时才写 issue 阻塞/缺口，不得先提交 PR 让主代理或自动 follower 替自己联调。
 - 主代理 review 子代理 PR 时直接信任子代理对运行结果、target-side gate 和 evidence 的描述；主代理只审核 diff、架构边界、受控入口、YAML-first、职责拆分和是否违反长期规则。除非描述自相矛盾、缺失关键字段或涉及安全/生产高风险，不要重复拉运行面证据或替子代理重跑 gate。
 - 子代理完成后必须留下可审查工件：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，并优先派回提出该反馈的子代理执行。
 ## 常用配合技能
@@ -78,6 +78,14 @@ Prompt 应足够明确，但不要塞入无界日志、长 JSON、完整 issue d
 8. 对每个已完成或已纠偏完成的子代理发送 post-task 收口要求，读取其已判断 feedback；主代理只挑选适合工程化的项转正式 FEATURE/BUG issue，并优先派回原子代理执行。
 9. 主代理 post-task：长期参考、清理已吸收 worktree；不代替子代理做 feedback 池去重。
 ## 无响应接续
 - 子代理超过当前任务合理等待窗口未回复时，先发一次明确的进度快照请求，要求返回当前 gate/文件/PR/阻塞和下一步；不要立即重复派发同一任务。
 - 第一次问询仍无结果时，主代理可以只读检查该子代理声明或可推断的 worktree、分支、PR 和 issue comment：只看 `git status`、`git log`、`git diff --stat`、PR body 和最近 comment，不改文件、不抢实现、不重跑运行面验证。
 - 只读检查后再发一次更窄的问询，把已观察到的 worktree/branch/diff 事实告诉子代理，并要求它确认或继续最小下一步。
 - 多次问询仍无响应时，关闭旧子代理，避免长期占用并发和上下文；随后在原 worktree/原分支/原 issue/原 PR 边界上重开新子代理接续。若原 worktree 已被 merge closeout 清理，新子代理应从最新目标分支创建同任务名 worktree；若原 worktree 仍在且有未提交改动，新子代理必须先读取并保护这些改动，不得 reset、checkout 或删除。
 - 重开的子代理 prompt 必须引用旧子代理的最后 issue/PR/comment 链接、原 worktree 路径、当前分支/HEAD 和主代理只读观察结论；不要复述长日志，也不要让新子代理重复已经由 issue/comment 确认的调查。
 ## 常见错误
 - 把能并行的不同 worktree 子任务排成串行，导致总体等待被单个任务拖住。