feat(ack): worker 模型固定与 worktree 决策说明 (v0.6.2)

kits/ack/VERSION

@@ -1 +1 @@
-0.6.0
+0.6.2

kits/ack/adoption-checklist.md

@@ -41,7 +41,8 @@
 
 - [ ] 决定用 Orca（`kit/core/orca-adapter.md`）还是手动模式（`kit/core/closed-loop.md`）。
 - [ ] Orca：`orca status`、`terminal list` 可用，Coordinator / Developer / Test 三个终端都在，回报能发回 Coordinator。
-- [ ] 决定用当前 worktree 还是隔离 worktree。
+- [ ] 决定子任务放当前 worktree 起子 agent，还是新建隔离 worktree（决策速查见 `kit/core/closed-loop.md` §「子任务放哪」）。
+- [ ] 多 worktree 时确认 `tasks.yaml`（SSOT）只保留一个权威副本，由 Coordinator 单写。
 
 ## 6. 验证命令
 

kits/ack/core/closed-loop.md

@@ -28,7 +28,9 @@
 ```text
 Coordinator 发现或读取 open 任务
   -> prepare：写/补全 tasks.yaml 验收信号
-  -> dispatch 给 Developer
+  -> 决定 worktree：当前 worktree 起子 agent，还是新建隔离 worktree（见下节「子任务放哪」）
+  -> 起 worker：按档位建 worker 终端（如 cursor-agent --model auto，见 model-routing.md）
+  -> dispatch 给 Developer（--to <worker handle>）
   -> wait：Developer 的 worker_done / escalation
   -> writeback fixed_by_dev
   -> dispatch 给 Test（retesting）
@@ -41,6 +43,46 @@ Coordinator 发现或读取 open 任务
 ```
 
 一次派发只修一个明确问题（细则见 `optimization-method.md` §「每轮派发只修一个明确问题」）。
+「决定 worktree」「起 worker」两步的决策见下节与 `model-routing.md` / `orca-adapter.md`。
+
+---
+
+## 子任务放哪：新 worktree 还是当前 worktree
+
+Coordinator 派发前先决定 Developer/Test 在哪工作。两种方式：
+
+**方式 1：当前 worktree 起子 agent（终端）**
+
+```bash
+orca terminal create --worktree active --command "cursor-agent --model auto" --json
+```
+
+- 适合：串行闭环、一次一个 Developer 任务、小改动、Test 要复测的正是 Developer 改的那棵树。
+- 优点：单一服务实例、无跨 worktree 对齐困扰、开销小。
+- 风险：多个 agent 同时改同一棵树会互相踩（半构建状态、git 冲突）。
+
+**方式 2：新建隔离 worktree，再在其中起子 agent**
+
+```bash
+orca worktree create --name <feature> --base-branch <base> --json
+# 然后在新 worktree 内 orca terminal create --worktree path:<new> --command "cursor-agent --model auto"
+```
+
+- 适合：并行多个互不依赖的子任务、大/高风险/实验性改动、要保持基线分支干净（如 prod 不动、feature 走独立分支）、要独立 build 或跑独立服务实例、best-of-N 尝试。
+- 优点：隔离 + 并行 + 易回滚（删 worktree 即可）。
+- 成本：各自 build/依赖、服务要用不同端口、必须处理下节的 worktree/服务对齐。
+
+**决策速查：**
+
+| 情况 | 选择 |
+|------|------|
+| 一次一个任务、串行修复 | 当前 worktree 子 agent |
+| 多个任务并行、互不依赖 | 每个任务一个新 worktree |
+| 高风险 / 实验 / 可能整体丢弃 | 新 worktree |
+| 要保持基线分支干净 | 新 worktree（feature 分支）|
+| 小改动、追求快 | 当前 worktree |
+
+**任务板（SSOT）只落一处**：无论开几个 worktree，`tasks.yaml` 只认一个权威副本（通常在基线/协调所在 worktree），由 Coordinator 单写。不要每个 worktree 各留一份会分叉的任务板。模型固定方式见 `model-routing.md` 与 `orca-adapter.md`。
 
 ---
 

kits/ack/core/model-routing.md

@@ -55,6 +55,21 @@
 
 ---
 
+## 如何给 worker 指定模型（编排相关）
+
+**模型不由编排层设置。** Orca 的 `orchestration task-create` / `dispatch` 没有 `--model` 参数——`dispatch` 只是把任务投递给一个已存在的终端 handle。**模型在创建 worker 终端、启动 agent CLI 时用 CLI 自带的 flag 固定**，之后该终端的所有 dispatch 都用这个模型。
+
+因此「档位 → 具体模型」的映射是 **agent 相关** 的，落地方式见 `orca-adapter.md` §「给 worker 终端固定模型」。常见 CLI：
+
+| Agent CLI | 指定模型的方式 |
+|-----------|----------------|
+| Cursor (`cursor-agent`) | `cursor-agent --model <model>`；`--model auto` 让 Cursor 自动选（推荐给 Test/Developer worker） |
+| 其它（codex / opencode 等） | 用各自 CLI 的模型参数或配置 |
+
+**本 kit 对 Cursor 的默认建议**：Test 与 Developer worker 用 `cursor-agent --model auto`（自动选型，天然偏向高效模型，符合"中低档位"意图）；需要更强时改成具体强模型（如 `--model claude-opus-4-8-thinking-high`）。Coordinator 作为强模型脑，通常就是发起编排的那个会话本身。
+
+---
+
 ## 成本原则
 
 强模型产出高密度、可复用的产物：需求、架构决策、验收信号、任务拆分、失败复盘。

kits/ack/core/orca-adapter.md

@@ -27,6 +27,35 @@ orca orchestration inbox --limit 20 --json
 
 ---
 
+## 给 worker 终端固定模型
+
+**编排层不设模型。** `task-create` / `dispatch` 都没有 `--model`；`dispatch --to <handle>` 只是把任务投给一个已存在的终端，用的是那个终端里 agent 会话启动时的模型。要固定模型，就在 **创建 worker 终端** 时用 agent CLI 的模型参数：
+
+```bash
+# Cursor：Test / Developer worker 用 auto 模型（自动选型）
+orca terminal create --worktree path:<dev_worktree> \
+  --command "cursor-agent --model auto" --title "DEV" --json
+
+# 需要更强模型时改成具体模型
+orca terminal create --worktree path:<dev_worktree> \
+  --command "cursor-agent --model claude-opus-4-8-thinking-high" --title "DEV" --json
+```
+
+拿到返回的 handle 后再 `task-create` + `dispatch --to <handle>`。模型档位与选型策略见 `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 --model auto" --json
+```
+
+- `cursor-agent --list-models` 可列出合法模型；`auto` 表示由 Cursor 自动选型。
+- 其它 CLI（codex / opencode 等）用各自的模型参数或配置，`--command` 相应替换。
+- 若 worker 是已在跑的会话（用 `--inject` 投递），模型已由该会话启动时决定，无法在 dispatch 时改；要换模型需新建终端。
+
+---
+
 ## 创建父任务
 
 ```bash