From 849237f6ea6c075ef12c12d9e4d13b0be96d8418 Mon Sep 17 00:00:00 2001 From: Codex Date: Sat, 11 Jul 2026 02:57:38 +0200 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=9B=BA=E5=8C=96=E4=B8=BB=E7=BA=BF?= =?UTF-8?q?=E6=94=AF=E7=BA=BF=E9=9A=94=E7=A6=BB=E7=AD=96=E7=95=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .agents/skills/unidesk-subagent/SKILL.md | 10 ++++++++++ AGENTS.md | 5 +++++ 2 files changed, 15 insertions(+) diff --git a/.agents/skills/unidesk-subagent/SKILL.md b/.agents/skills/unidesk-subagent/SKILL.md index 599b8a2b..2b91723e 100644 --- a/.agents/skills/unidesk-subagent/SKILL.md +++ b/.agents/skills/unidesk-subagent/SKILL.md @@ -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`。 diff --git a/AGENTS.md b/AGENTS.md index e2eca79d..94e3ee5d 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -83,6 +83,11 @@ - 走 `$unidesk-gh` / `bun scripts/cli.ts gh ...`； - 禁止原生 `gh`/手写 API； - 写入默认中文。 +- P0: 可临时缓解的非主线问题： + - 先创建独立 GitHub issue 和语义化 MDTODO； + - 主代理只执行有界、可逆、可验证的临时缓解； + - 支线交独立子代理后，主代理立即回到原主线； + - 完整判定和交付规则见 `$unidesk-subagent`。 - P0: 远端文本修改： - 优先走 `$unidesk-trans` 的 `trans apply-patch`； - route/cwd 见 `docs/reference/cli.md`。