diff --git a/.agents/skills/unidesk-subagent/SKILL.md b/.agents/skills/unidesk-subagent/SKILL.md index 21591edc..a2f57132 100644 --- a/.agents/skills/unidesk-subagent/SKILL.md +++ b/.agents/skills/unidesk-subagent/SKILL.md @@ -1,14 +1,20 @@ --- name: unidesk-subagent -description: UniDesk 主代理调度子代理的必读技能。用户提到子代理、subagent、并行代理、主代理调度、gpt-5.5、让子代理调查 issue、提交 PR、上线验证、结合 gh 的子代理工作流时必须使用。 +description: UniDesk 主代理调度子代理的必读技能。用户提到子代理、subagent、并行代理、Artificer、原生子代理、主代理调度、gpt-5.5、让子代理调查 issue、提交 PR、上线验证、结合 gh 的子代理工作流时必须使用。 --- -# UniDesk Subagent Orchestration +# UniDesk 子代理调度 主代理调度子代理时先读本 skill,再读对应 reference。子代理可以并行推进低耦合任务,但主代理必须保留架构判断、PR 审核、合并顺序、上线 closeout 和最终结论的责任。 ## 高频规则 +- 执行型和调研型委派默认优先使用 AgentRun `Artificer`: + - 只有 Artificer 已通过有界 readiness、最短真实派单或同 session 续跑证据,才判定为可用;单个业务任务失败必须先按 typed reason 判断,不能直接宣告 Artificer 不可用; + - Artificer 可用时,新任务和可安全接续的剩余任务必须优先交给 Artificer,原生子代理只用于管理性主代理职责以外、且 Artificer 本身修复或恢复所必需的工作; + - Artificer 已被证明确实不可用时,先创建独立 issue 和泛化问题域 MDTODO,再派一个原生子代理修复 Artificer;紧急且边界独立的业务任务可以暂时派原生子代理,但不得把临时 fallback 固化为长期调度入口; + - Artificer 恢复后,原生子代理必须在 clean commit、PR 或只读报告 checkpoint 停止继续扩展;主代理通过原 issue、MDTODO 和 session 传递接续上下文,再由 Artificer 接替尚未完成的工作;禁止两个执行面共享可写 worktree、重复提交或并发修改同一任务; + - 管理性、决策性文档仍由主代理负责,不为了满足 Artificer 优先规则而外包治理决策。 - 子代理并行只用于成功率高、耦合度低、能放进独立 worktree/branch/issue/PR 的任务;共享架构方向、公共契约和同文件高冲突修改先串行定锚。 - 管理性、决策性文档由主代理直接完成,不把决策权或治理写入外包给子代理: - 主代理负责 `AGENTS.md`、skill 核心规则、长期 reference 规范、架构决策、主 issue anchor/closeout,以及 MDTODO FILE 的领域划分、ITEM 结构和状态治理;