docs: require subagent post-task feedback
This commit is contained in:
@@ -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
|
||||
|
||||
@@ -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。
|
||||
|
||||
## 常见错误
|
||||
|
||||
|
||||
Reference in New Issue
Block a user