From 935d74b557654fe03f8ca26ab2431bf8bc9e8f67 Mon Sep 17 00:00:00 2001 From: Codex Date: Thu, 2 Jul 2026 12:43:31 +0000 Subject: [PATCH] docs: require subagent post-task feedback --- .agents/skills/unidesk-subagent/SKILL.md | 2 ++ .agents/skills/unidesk-subagent/references/gh-workflow.md | 5 ++++- 2 files changed, 6 insertions(+), 1 deletion(-) diff --git a/.agents/skills/unidesk-subagent/SKILL.md b/.agents/skills/unidesk-subagent/SKILL.md index 69854977..a335cec4 100644 --- a/.agents/skills/unidesk-subagent/SKILL.md +++ b/.agents/skills/unidesk-subagent/SKILL.md @@ -14,6 +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。 ## 常用配合技能 @@ -21,6 +22,7 @@ description: UniDesk 主代理调度子代理的必读技能。用户提到子 - AgentRun / Code Queue / AipodSpec 任务派发：`$unidesk-code-queue`。 - CI/CD、rollout、PipelineRun、Argo closeout：`$unidesk-cicd`。 - WebProbe、Workbench、浏览器复测：`$unidesk-webdev`。 +- 子代理完成后的反馈收口和反馈 issue 判定：`$post-task`。 - 需要 MDTODO 记录和执行-审查循环时再用 `$mdtodo-loop`；不要把普通 GitHub PR 并行工作强行塞进 MDTODO。 ## 何时读取 reference diff --git a/.agents/skills/unidesk-subagent/references/gh-workflow.md b/.agents/skills/unidesk-subagent/references/gh-workflow.md index 053d723c..ad36f7cd 100644 --- a/.agents/skills/unidesk-subagent/references/gh-workflow.md +++ b/.agents/skills/unidesk-subagent/references/gh-workflow.md @@ -24,6 +24,8 @@ - 修复型子代理提交 PR，并在 PR body 写明目标合并分支、关联 issue、变更范围、验证命令、风险和证据。除非用户明确授权，子代理不合并自己的 PR。 - 需要修改 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。 ## PR 工作流 @@ -60,7 +62,8 @@ Prompt 应足够明确，但不要塞入无界日志、长 JSON、完整 issue d 5. 按依赖顺序合并；合并后同步目标 worktree。 6. 触发受控 CI/CD 或让明确授权的子代理上线；主代理核对 closeout。 7. 用原入口复测；把剩余问题拆到新 issue 或追加既有 issue。 -8. post-task：长期参考、反馈去重、清理已吸收 worktree。 +8. 对每个已完成或已纠偏完成的子代理发送 post-task 收口要求，收集反馈、去重并决定是否转 issue。 +9. 主代理 post-task：长期参考、反馈去重、清理已吸收 worktree。 ## 常见错误