fix: 复用 agent

kits/ack/core/orca-adapter.md

@@ -27,6 +27,30 @@ orca orchestration inbox --limit 20 --json
 
 ---
 
+## 解析并复用 worker
+
+**默认复用，创建是兜底。** 每次向 Developer 或 Test 派发前都先解析 worker，不能直接照后文示例执行 `terminal create`：
+
+1. 运行 `orca terminal list --json`，筛选 `connected=true`、`writable=true`、目标 `worktreePath` 一致、标题角色和配置一致的终端。稳定标题使用 `ACK-<ROLE>-<CLI>-<TIER>-<N>`，例如 `ACK-DEV-CODEX-TERRA-1`、`ACK-TEST-CODEX-LUNA-1`、`ACK-DEV-CURSOR-AUTO-1`；强档示例为 `ACK-DEV-CODEX-SOL-1`。
+2. 运行 `orca orchestration task-list --status dispatched --json`。若候选 handle 出现在活跃任务的 `assignee_handle`，视为 busy，不复用；不要仅凭终端预览文本或最近输出时间猜忙闲。
+3. 对空闲候选运行 `orca terminal show --terminal <handle> --json`，确认仍存活且 worktree、角色和 Agent CLI / 模型档位符合本次要求。符合就直接把该 handle 作为 `dispatch --to` 的目标。
+4. 只有不存在兼容的空闲候选时才创建。若同角色同配置已有 busy worker，使用下一个未占用序号，例如 `ACK-DEV-CODEX-TERRA-2`；不要创建另一个同名终端。
+5. dispatch 成功后，把实际 handle 写入对应 `tasks.yaml` 条目的 `dispatch.worker`。下一轮先尝试该 handle；若它已消失、断开、不可写、worktree/角色/档位不兼容或正忙，再回到第 1 步选择其它 worker。
+
+`tasks.yaml.dispatch.worker` 记录“这个任务实际用了谁”，便于续跑和审计；`orca terminal list` 记录“谁现在还活着”，是运行时存活状态的事实源。不要另建一份永久 worker 池，因为终端关闭后其中的 handle 会过期。
+
+复用决策：
+
+| 情况 | 动作 |
+|------|------|
+| 任务已记录 worker，且该 handle 存活、兼容、空闲 | 优先复用原 handle |
+| 有其它同 worktree、同角色、兼容的空闲 worker | 复用该 handle |
+| 同角色 worker 存在但都 busy | 创建下一编号的临时并发 worker |
+| worker 已关闭、断开或不存在 | 创建新 worker |
+| 模型升级或 worktree 不同 | 不复用不兼容 worker，创建对应档位/路径的新 worker |
+
+---
+
 ## 给 worker 终端固定模型
 
 **编排层不设模型。** `task-create` / `dispatch` 都没有 `--model`；`dispatch --to <handle>` 只是把任务投给一个已存在的终端，用的是那个终端里 agent 会话启动时的模型。要固定模型，就在 **创建 worker 终端** 时用 agent CLI 的模型参数：
@@ -36,35 +60,35 @@ orca orchestration inbox --limit 20 --json
 ```bash
 # Cursor：Test / Developer worker 用 auto 模型，并按项目要求启用 YOLO
 orca terminal create --worktree path:<dev_worktree> \
-  --command "cursor-agent --yolo --model auto" --title "DEV" --json
+  --command "cursor-agent --yolo --model auto" --title "ACK-DEV-CURSOR-AUTO-1" --json
 
 # 需要更强模型时改成具体模型
 orca terminal create --worktree path:<dev_worktree> \
-  --command "cursor-agent --yolo --model claude-opus-4-8-thinking-high" --title "DEV" --json
+  --command "cursor-agent --yolo --model claude-opus-4-8-thinking-high" --title "ACK-DEV-CURSOR-STRONG-1" --json
 
 # Codex：Developer worker
 orca terminal create --worktree path:<dev_worktree> \
   --command "codex --dangerously-bypass-approvals-and-sandbox -m gpt-5.6-terra -c model_reasoning_effort=medium" \
-  --title "DEV" --json
+  --title "ACK-DEV-CODEX-TERRA-1" --json
 
 # Codex：Test worker
 orca terminal create --worktree path:<test_worktree> \
   --command "codex --dangerously-bypass-approvals-and-sandbox -m gpt-5.6-luna -c model_reasoning_effort=low" \
-  --title "TEST" --json
+  --title "ACK-TEST-CODEX-LUNA-1" --json
 
 # Codex：复杂 Developer 任务升级
 orca terminal create --worktree path:<dev_worktree> \
   --command "codex --dangerously-bypass-approvals-and-sandbox -m gpt-5.6-sol -c model_reasoning_effort=high" \
-  --title "DEV-STRONG" --json
+  --title "ACK-DEV-CODEX-SOL-1" --json
 ```
 
-拿到返回的 handle 后再 `task-create` + `dispatch --to <handle>`。模型档位与选型策略见 `model-routing.md`。
+这些创建命令只在复用流程找不到空闲兼容 worker 时执行。拿到返回的 handle 后再 `task-create` + `dispatch --to <handle>`，并把 handle 写入 `tasks.yaml` 的 `dispatch.worker`。模型档位与选型策略见 `model-routing.md`。
 
 需要隔离/并行时，先建新 worktree 再在其中起 worker（是否新建见 `closed-loop.md` §「子任务放哪」）：
 
 ```bash
 orca worktree create --name <feature> --base-branch <base> --json
-orca terminal create --worktree path:<new_worktree> --command "cursor-agent --yolo --model auto" --json
+orca terminal create --worktree path:<new_worktree> --command "cursor-agent --yolo --model auto" --title "ACK-DEV-CURSOR-AUTO-1" --json
 ```
 
 - `cursor-agent --list-models` 可列出合法模型；`auto` 表示由 Cursor 自动选型。