feat(ack): support project agent routing overrides

skills/ack/README.md

@@ -37,7 +37,8 @@ pouch add ack -g       # 全局
 ## 使用前准备
 
 - 项目是 Git 仓库。
-- 自动拉起 Developer / Test worker 时需要 Orca，以及项目里配置好的 Codex、Cursor、Grok 或 OMP。
+- 自动拉起 Developer / Test worker 时需要 Orca，以及项目里配置好的 Codex、Cursor、Grok、OMP 或 Pi。
+- 使用 Pi 时需安装 `pi`；默认模型用 `agents.yaml` 中 `cli: pi`、`model: null` 表示。
 - 布测试环境需要同时安装 [deployer](../deployer/README.md)，并准备好 SSH 和目标机器的 Docker Compose。
 - 飞书收 bug 是可选的，要在 `project.md` 里配置 `bugIntake`。
 - 不要 `pouch init builder` 或 `pouch init deployer`。测试环境和发版直接对 `/ack` 说；缺 deployer 时 ACK 会转去它的初始化。
@@ -57,7 +58,8 @@ pouch init ack --project ~/code/my-app
 ├── tasks.yaml
 ├── knowledge.yaml
 ├── delivery.yaml       # 默认 enabled: false
-└── regression.yaml     # 默认 cases: []
+├── regression.yaml     # 默认 cases: []
+└── agents.yaml         # 可选：临时覆盖 Developer/Test 的 CLI、模型和权限
 ```
 
 不会把 ACK Skill 复制进项目。规范、模板和脚本始终从已安装的 Skill 目录读取。
@@ -94,6 +96,16 @@ pouch init ack --project ~/code/my-app
 /ack 处理这个需求：…。任务验证通过后执行 review profile。
 ```
 
+临时调整角色启动方式时直接说明意图，例如：
+
+```text
+/ack 让这个项目的 dev agent 用 pi 默认模型，test agent 用 cursor-agent auto 模型
+```
+
+ACK 会在 `.pouch/ack/agents.yaml` 保存结构化覆盖配置。它存在时优先于
+`tasks.yaml.project.orchestration`；删除后自动回退。配置 hash 会绑定启动计划和 receipt，
+修改后必须重新审阅并生成 plan。
+
 ## Agent 会做什么
 
 1. 初始化或检查 `.pouch/ack/`，缺项按统一格式列出；不从 README/CI 猜测并启用交付或知识。