docs: clarify subagent feedback ownership

2026-07-02 12:53:01 +00:00
parent 935d74b557
commit 4e781b2793
2 changed files with 5 additions and 4 deletions
@@ -14,7 +14,7 @@ description: UniDesk 主代理调度子代理的必读技能。用户提到子
 - 每个子代理 prompt 必须写清 repo、目标分支、独立 worktree、issue/PR、禁止触碰范围、验收命令、证据字段和是否允许部署；不要让多个子代理共享同一可写 worktree。
 - 用户指定模型（例如 `gpt-5.5`）时，主代理调度子代理必须在任务描述或调度参数中显式遵守。
 - 子代理完成后必须留下可审查工件：PR、issue comment、commit、验证输出摘要、部署/observer/trace 证据或阻塞说明；主代理不能只凭口头结论合并。
- 子代理完成任务后，主代理必须再给该子代理发送 post-task 收口要求；若主代理要求子代理纠偏或补验证，则等纠偏完成后再发 post-task。post-task 反馈由主代理筛选、去重，并按 `$post-task` 规则决定追加既有 issue、开 `[FEEDBACK]` issue，或转成正式 FEATURE/BUG issue。
+- 子代理完成任务后，主代理必须再给该子代理发送 post-task 收口要求；若主代理要求子代理纠偏或补验证，则等纠偏完成后再发 post-task。post-task 反馈由子代理按 `$post-task` 自行给出判断，主代理不负责反馈池去重；主代理只从子代理提好的反馈中挑选适合工程化的项转成正式 FEATURE/BUG issue，并优先派回提出该反馈的子代理执行。

 ## 常用配合技能

@@ -25,7 +25,8 @@
 - 需要修改 issue/PR 正文时使用 `$unidesk-gh` 或 `trans gh:/... apply-patch`；不得用原生 `gh` 或手写 GitHub API 绕过。
 - issue closeout 必须由主代理核对真实入口证据。代码合并、测试通过或子代理口头报告不能替代用户入口/原入口验证。
 - 每个子代理完成主任务后，主代理必须发送 post-task 收口要求；如果主代理发现需要纠偏、补证据或返工，应先让子代理完成纠偏，再发送 post-task。post-task 只收集反馈和后续问题线索，不应让子代理自行扩大代码修改范围。
- 主代理负责筛选 post-task feedback：基础设施摩擦按 `$post-task` 去重后追加或新开 `[FEEDBACK]` issue；能直接执行的产品/架构/缺陷工作应另起正式 FEATURE/BUG issue；校验、门禁、guard、preflight 类治理问题不得作为 `[FEEDBACK]` issue。
+- 子代理按 `$post-task` 自行输出已判断的 feedback 候选、疑似归属和是否建议转正式 issue；主代理不负责反馈池去重，不代替子代理维护 `[FEEDBACK]` issue。主代理只从子代理提好的 feedback 中挑选适合直接工程化的项，另起正式 FEATURE/BUG issue 后继续调度。
+- feedback 转正式 issue 后，优先派回提出该 feedback 的子代理执行，使调查上下文和修复上下文保持连续；只有该子代理不可用或任务边界已变化时才派给其他子代理。

 ## PR 工作流

@@ -62,8 +63,8 @@ Prompt 应足够明确，但不要塞入无界日志、长 JSON、完整 issue d
 5. 按依赖顺序合并；合并后同步目标 worktree。
 6. 触发受控 CI/CD 或让明确授权的子代理上线；主代理核对 closeout。
 7. 用原入口复测；把剩余问题拆到新 issue 或追加既有 issue。
-8. 对每个已完成或已纠偏完成的子代理发送 post-task 收口要求，收集反馈、去重并决定是否转 issue。
-9. 主代理 post-task：长期参考、反馈去重、清理已吸收 worktree。
+8. 对每个已完成或已纠偏完成的子代理发送 post-task 收口要求，读取其已判断 feedback；主代理只挑选适合工程化的项转正式 FEATURE/BUG issue，并优先派回原子代理执行。
+9. 主代理 post-task：长期参考、清理已吸收 worktree；不代替子代理做 feedback 池去重。

 ## 常见错误