docs: define subagent model selection policy

2026-07-03 23:16:05 +00:00
parent a96db84b4a
commit a6a7326552
2 changed files with 11 additions and 1 deletions
@@ -13,6 +13,7 @@ description: UniDesk 主代理调度子代理的必读技能。用户提到子
 - 正式 GitHub issue/PR/comment/merge 仍走 `$unidesk-gh`；子代理可以提交 PR 和写调查结论，主代理负责 review/preflight/merge，除非用户明确授权某个子代理自上线自验证。
 - 每个子代理 prompt 必须写清 repo、目标分支、独立 worktree、issue/PR、禁止触碰范围、验收命令、证据字段和是否允许部署；不要让多个子代理共享同一可写 worktree。
 - 用户指定模型（例如 `gpt-5.5`）时，主代理调度子代理必须在任务描述或调度参数中显式遵守。
+- 用户要求或授权“按任务难度分配模型”时，主代理必须按复杂度选择模型与 reasoning effort，并在 prompt 中写明选择理由；默认继承主模型，只有任务难度、风险或延迟收益明确时才显式覆盖。
 - 子代理完成后必须留下可审查工件：PR、issue comment、commit、验证输出摘要、部署/observer/trace 证据或阻塞说明；主代理不能只凭口头结论合并。
 - 子代理完成任务后，主代理必须再给该子代理发送 post-task 收口要求；若主代理要求子代理纠偏或补验证，则等纠偏完成后再发 post-task。post-task 反馈由子代理按 `$post-task` 自行给出判断，主代理不负责反馈池去重；主代理只从子代理提好的反馈中挑选适合工程化的项转成正式 FEATURE/BUG issue，并优先派回提出该反馈的子代理执行。

@@ -10,6 +10,15 @@
 - 任务要按成功率分层：调查、工具增强、业务修复、验证、PR review、上线 closeout 可以并行，但“修同一个根因的两套实现”通常不应并行。
 - 主代理需要持续调度，而不是把多个子任务排队串行执行。用户明确要求并行且任务在不同 worktree 时，应同时派发能并行的子任务，并通过 issue/PR 状态汇总。

+## 模型与思考等级
+
+- 默认不显式覆盖模型，继承主代理当前模型；只有用户要求/授权按任务难度分配，或任务风险与复杂度明确需要时，才在子代理调度参数中指定模型、reasoning effort 和必要的 service tier。
+- `gpt-5.4` / medium 适合边界清楚、低风险、可独立完成的任务：bounded grep、单文件/单模块源码定位、issue 评论整理、已知命令验证和窄范围文档更新。
+- `gpt-5.4` / high 适合需要跨多个文件或 YAML source-of-truth 判断但仍是只读或单模块边界的任务：源码/YAML 路径追踪、单运行面只读分析、低耦合实现设计和 PR bounded review。
+- `gpt-5.5` / high 适合跨运行面、CI/CD 状态机、共享契约、架构倒退风险或根因不明的任务：branch-follower/Tekton/Argo/runtime 联合分析、复杂可见性设计、高风险 PR review 和需要主代理后续决策的方案比较。
+- `gpt-5.5` / xhigh 只用于需要全局架构取舍、多个 repo/运行面同时受影响、错误成本高且等待时间可以接受的任务；不要把 routine 状态查询、机械重命名、普通 issue 评论或单文件修改派给 5.5/xhigh。
+- 子代理 prompt 必须写明“模型/思考等级选择理由”。如果多个子任务并行，低风险采集类用较轻模型，架构边界和共享状态机判断用较强模型；不要让高成本模型重复做已经由低成本子代理能可靠完成的采集工作。
+
 ## Worktree 和边界

 - 每个写代码的子代理使用独立 `.worktree/<task>`，从最新目标分支创建；不得共用主 worktree 或其他子代理 worktree。
@@ -42,7 +51,7 @@ Prompt 至少包含以下字段，按任务裁剪：

 ```text
 任务：<一句话目标>
-模型要求：<如用户指定 gpt-5.5 则写明>
+模型要求：<用户指定模型或按难度选择的模型/思考等级；写明选择理由>
 Repo/Branch：<repo> <target branch/lane>
 Worktree：从最新 <target branch> 创建独立 .worktree/<task>；不得使用主 worktree
 Issue/PR：关联 <issue>；修复完成后提交 PR；调查完成后评论 issue