From 694c449acf739aedf90518a67f42dd253edff38c Mon Sep 17 00:00:00 2001 From: Codex Date: Sat, 11 Jul 2026 15:51:24 +0200 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=98=8E=E7=A1=AE=E4=B8=BB=E4=BB=A3?= =?UTF-8?q?=E7=90=86=E6=96=87=E6=A1=A3=E6=B2=BB=E7=90=86=E8=BE=B9=E7=95=8C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .agents/skills/unidesk-subagent/SKILL.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/.agents/skills/unidesk-subagent/SKILL.md b/.agents/skills/unidesk-subagent/SKILL.md index 2b91723e..8ad67ace 100644 --- a/.agents/skills/unidesk-subagent/SKILL.md +++ b/.agents/skills/unidesk-subagent/SKILL.md @@ -10,6 +10,11 @@ description: UniDesk 主代理调度子代理的必读技能。用户提到子 ## 高频规则 - 子代理并行只用于成功率高、耦合度低、能放进独立 worktree/branch/issue/PR 的任务；共享架构方向、公共契约和同文件高冲突修改先串行定锚。 +- 管理性、决策性文档由主代理直接完成，不把决策权或治理写入外包给子代理： + - 主代理负责 `AGENTS.md`、skill 核心规则、长期 reference 规范、架构决策、主 issue anchor/closeout，以及 MDTODO FILE 的领域划分、ITEM 结构和状态治理； + - 子代理可以在已明确的 issue、MDTODO ITEM 和验收边界内独立调研，并编写对应任务报告、验证记录、实现说明和证据附件； + - 子代理报告只承载其任务事实与结论，不能自行改写上层目标、架构取舍、优先级、主线状态或跨任务治理规则； + - 主代理审阅子代理报告后，亲自把被采纳的结论写入管理性、决策性文档。 - 正式 GitHub issue/PR/comment/merge 仍走 `$unidesk-gh`；子代理可以提交 PR 和写调查结论，主代理负责 review/preflight/merge，除非用户明确授权某个子代理自上线自验证。 - 主代理和子代理必须通过 issue/PR/comment 链接传递可复用上下文、调查结论、证据链接和下一步边界；派发前先读既有评论，prompt 中只引用链接和增量任务，不复述长结论，避免不同子代理重复调查同一事实。 - 主代理派发执行型子代理前必须先创建子 issue，并把主要任务、接续上下文、目标分支/worktree、范围、禁止项和验收入口写入子 issue 正文；子代理 prompt 只给子 issue 链接和极短边界，不塞大段任务正文。每个执行型子代理维护自己的子 issue 和评论作为接续上下文；主 issue 评论区只由主代理写入主线 anchor、阶段汇总、调度决策和最终 closeout。