docs: 固化主线支线隔离策略
This commit is contained in:
@@ -25,6 +25,16 @@ description: UniDesk 主代理调度子代理的必读技能。用户提到子
|
||||
- 子代理长时间无响应时,主代理按“问询 -> 只读检查 worktree/PR/issue -> 再窄问询”的顺序处理;多次问询仍无回复时,可以关闭旧子代理,并在原 worktree/原分支/原 issue 边界上重开新子代理接续。重开前不得删除或重置旧 worktree;新子代理必须先读取原 worktree 状态和既有 issue/PR/comment 链接,再继续最小下一步。
|
||||
- 子代理完成任务后,主代理必须再给该子代理发送 post-task 收口要求;若主代理要求子代理纠偏或补验证,则等纠偏完成后再发 post-task。post-task 反馈由子代理按 `$post-task` 自行给出判断,主代理不负责反馈池去重;主代理只从子代理提好的反馈中挑选适合工程化的项转成正式 FEATURE/BUG issue,并优先派回提出该反馈的子代理执行。
|
||||
|
||||
## 主线与支线隔离
|
||||
|
||||
- 主线执行中遇到可临时缓解的非主线问题时,固定按以下顺序处理:
|
||||
- 先创建边界独立的 GitHub issue,并在语义化 MDTODO 中引用 issue 链接、根因假设、临时缓解和最终验收入口;
|
||||
- 主代理仅通过受控入口执行有界、可逆、可验证的临时缓解,同时保存缓解前后证据和回退方式;
|
||||
- 将根因修复交给独立子代理、worktree、branch 和 PR,禁止让支线继续占用主代理主线;
|
||||
- 缓解达到继续主线的最低条件后,主代理立即恢复用户原始目标,不等待支线完成。
|
||||
- 临时缓解不得标记为根因已修复,不得用于关闭支线 issue,也不得引入第二套长期 authority、fallback 或隐藏状态。
|
||||
- 涉及数据丢失、Secret 暴露、安全边界、不可逆迁移或无法证明影响范围的问题,不属于可直接缓解范围;主代理必须先停止扩大影响,再按对应专项技能处理。
|
||||
|
||||
## 常用配合技能
|
||||
|
||||
- GitHub issue/PR 正式读写、preflight、merge:`$unidesk-gh`。
|
||||
|
||||
@@ -83,6 +83,11 @@
|
||||
- 走 `$unidesk-gh` / `bun scripts/cli.ts gh ...`;
|
||||
- 禁止原生 `gh`/手写 API;
|
||||
- 写入默认中文。
|
||||
- P0: 可临时缓解的非主线问题:
|
||||
- 先创建独立 GitHub issue 和语义化 MDTODO;
|
||||
- 主代理只执行有界、可逆、可验证的临时缓解;
|
||||
- 支线交独立子代理后,主代理立即回到原主线;
|
||||
- 完整判定和交付规则见 `$unidesk-subagent`。
|
||||
- P0: 远端文本修改:
|
||||
- 优先走 `$unidesk-trans` 的 `trans <route> apply-patch`;
|
||||
- route/cwd 见 `docs/reference/cli.md`。
|
||||
|
||||
Reference in New Issue
Block a user