diff --git a/.agents/skills/unidesk-subagent/SKILL.md b/.agents/skills/unidesk-subagent/SKILL.md index 0b69b187..86eedcdc 100644 --- a/.agents/skills/unidesk-subagent/SKILL.md +++ b/.agents/skills/unidesk-subagent/SKILL.md @@ -11,6 +11,7 @@ description: UniDesk 主代理调度子代理的必读技能。用户提到子 - 子代理并行只用于成功率高、耦合度低、能放进独立 worktree/branch/issue/PR 的任务;共享架构方向、公共契约和同文件高冲突修改先串行定锚。 - 正式 GitHub issue/PR/comment/merge 仍走 `$unidesk-gh`;子代理可以提交 PR 和写调查结论,主代理负责 review/preflight/merge,除非用户明确授权某个子代理自上线自验证。 +- 主代理和子代理必须通过 issue/PR/comment 传递可复用上下文、调查结论、证据链接和下一步边界;派发前先读既有评论,prompt 中引用已确认结论,避免不同子代理重复调查同一事实。 - 每个子代理 prompt 必须写清 repo、目标分支、独立 worktree、issue/PR、禁止触碰范围、验收命令、证据字段和是否允许部署;不要让多个子代理共享同一可写 worktree。 - 用户指定模型(例如 `gpt-5.5`)时,主代理调度子代理必须在任务描述或调度参数中显式遵守。 - 用户要求或授权“按任务难度分配模型”时,主代理必须按复杂度选择模型与 reasoning effort,并在 prompt 中写明选择理由;默认继承主模型,只有任务难度、风险或延迟收益明确时才显式覆盖。 diff --git a/.agents/skills/unidesk-subagent/references/gh-workflow.md b/.agents/skills/unidesk-subagent/references/gh-workflow.md index 6288126d..4507df6b 100644 --- a/.agents/skills/unidesk-subagent/references/gh-workflow.md +++ b/.agents/skills/unidesk-subagent/references/gh-workflow.md @@ -29,7 +29,10 @@ ## GitHub Issue 协作 - 大任务先有 GitHub issue 或在既有 issue 中补并行计划:列出子任务、负责人/子代理、目标分支、预期 PR、验证入口、依赖关系和哪些任务可并行。 +- issue/PR/comment 是子代理之间传递上下文的稳定介质。主代理派发前必须先读取并整理既有评论中的已确认事实、证据链接、阻塞点和禁止重复范围,在 prompt 中显式引用;子代理开始前也要复用这些结论,除非评论已过期、与新证据冲突或主代理要求复核。 - 调查型子代理优先把结论写入 issue comment 或 issue 正文的调查段;主代理再根据调查结论决定修复子任务,而不是让调查子代理直接扩大 scope。 +- 调查评论要写成可接力格式:结论、证据来源、未覆盖范围、下一步建议和可直接复用的命令/对象名。不要只写口头判断,也不要把无界日志或大 JSON 贴进评论。 +- 主代理每轮阶段切换时在 issue 中留下短 anchor comment,说明哪些结论已经被采纳、哪些路径不再重复查、下一批子代理只需要补哪一段;后续子代理必须以该 anchor 为上下文起点。 - 修复型子代理提交 PR,并在 PR body 写明目标合并分支、关联 issue、变更范围、验证命令、风险和证据。除非用户明确授权,子代理不合并自己的 PR。 - 需要修改 issue/PR 正文时使用 `$unidesk-gh` 或 `trans gh:/... apply-patch`;不得用原生 `gh` 或手写 GitHub API 绕过。 - issue closeout 必须由主代理核对真实入口证据。代码合并、测试通过或子代理口头报告不能替代用户入口/原入口验证。