feat(ack): bind test env to deployer and add regression mode

ACK 0.19.0 hands test-environment deploys to the deployer skill,
documents bug-fix as a first-class scenario, and adds
docs/ack/regression.yaml harvest plus a /ack regression run.

skills/ack/references/adoption-checklist.md

@@ -4,8 +4,8 @@
 
 - [ ] ACK Skill 已全局安装或安装到当前项目。
 - [ ] 已运行 `skiff init ack --project <project-root>`。
-- [ ] `docs/ack/` 只包含项目自己的 `project.md`、`tasks.yaml`、`knowledge.yaml` 与
-      默认关闭的 `delivery.yaml`。
+- [ ] `docs/ack/` 只包含项目自己的 `project.md`、`tasks.yaml`、`knowledge.yaml`、
+      默认关闭的 `delivery.yaml` 与空的 `regression.yaml`。
 - [ ] 旧项目缺少 `knowledge.yaml` 时，只补空文件及缺失的
       `project.knowledgeFile` 指针，没有重跑初始化或覆盖其它项目状态。
 - [ ] 项目中没有 ACK Skill 的复制目录或 `kit`、`framework` 软链接。
@@ -19,6 +19,8 @@
       `docs/ack/knowledge.yaml`。
 - [ ] 新项目的 `project.deliveryFile` 固定为 `docs/ack/delivery.yaml`，顶层有
       `deliveryRuns: []`；旧项目未采用交付能力时可无这两项。
+- [ ] 新项目的 `project.regressionFile` 固定为 `docs/ack/regression.yaml`，顶层有
+      `regressionRuns: []`；旧项目未采用回归能力时可无这两项。
 - [ ] 技术栈、运行、构建、单测和集成测试命令均来自项目证据。
 - [ ] Coordinator、Developer、Test 的模型档位和升级规则已明确。
 - [ ] `project.orchestration` 使用受支持的 profileVersion，模型都命中项目
@@ -36,6 +38,7 @@
 - [ ] 私有配置只读且不提交。
 - [ ] `tasks.yaml` 只有 Coordinator 写。
 - [ ] `knowledge.yaml` 只有 Coordinator 写；Developer 与 Test 只通过回报提名或验证。
+- [ ] `regression.yaml` 只有 Coordinator 写；Test 只通过 `regressionCandidates` 提名。
 - [ ] `delivery.yaml` 只在用户显式维护配置时修改；Developer 与 Test 只读。
 
 ## 任务板
@@ -48,8 +51,9 @@
 ## 可选交付
 
 - [ ] `delivery.yaml` 首次生成保持 `enabled: false`，没有根据 README/CI 自动启用。
-- [ ] 测试环境部署和版本发布都写在同一份 `delivery.yaml` 的 `intents` 中，没有第二份
-      操作文档。未说明的 intent 保持 `null`。
+- [ ] 测试环境绑定 deployer（`intents.testEnvironment.via: deployer`），发版写在
+      同一份 `delivery.yaml` 的 `intents.release`。没有第二份操作文档。未说明的
+      intent 保持 `null`。旧 profile ID 字符串已迁移。
 - [ ] entrypoint 只使用声明式工具 target 或仓库内无 symlink 的可执行脚本；没有
       shell、自由 command、凭据值或环境变量值。
 - [ ] artifact、destination、environment 和 profile 引用均通过
@@ -81,6 +85,13 @@
 - [ ] 关键约束已规划下沉到测试、lint、CI 或正式规范。
 - [ ] ACK 不自动修改 `AGENTS.md`、`CLAUDE.md` 或其它 Agent 指令文件。
 
+## 回归
+
+- [ ] 新项目 `regression.yaml` 为 `cases: []`，没有虚构用例。
+- [ ] 已运行 `validate_regression.py --tasks ...` 并通过。
+- [ ] 任务 `verified` 后给出新增/更新/退役/无回归四选一，确认后才写入目录。
+- [ ] 运行回归先走 deployer 测试环境，再派独立 Test；失败不自动开修。
+
 ## 编排
 
 - [ ] 已选择 Orca 或手动模式。

skills/ack/references/closed-loop.md

@@ -43,8 +43,8 @@ Coordinator 发现或读取 open 任务
   -> wait：滚动 check --wait + 定期 worker_probe（识别审批/未回车/额度停滞）
      直到 Developer 的 worker_done / escalation（含 knowledgeApplied / knowledgeCandidates）
   -> writeback fixed_by_dev
-  -> 若 delivery.yaml intents.testEnvironment 已启用：Coordinator 先执行该 profile
-     拉起待测服务，再派 Test；Test 不发明编译或启动命令
+  -> 若 delivery.yaml intents.testEnvironment 已启用：Coordinator 先按 deployer
+     绑定拉起 `.skiff/deployer/<env>`，再派 Test；Test 不发明编译或启动命令
   -> 为 Test 独立解析安全 profile；安全重置同角色空闲 worker，或重新 plan/launch fresh worker
   -> dispatch 给 Test（retesting）
   -> 确认 Test 已开始执行（terminal read 确认任务注入；未开始按环境失败处理）
@@ -174,9 +174,9 @@ python3 <ack-skill-dir>/scripts/launch_worker.py launch \
 | 小改动、追求快 | 当前 worktree |
 
 **项目状态（SSOT）只落一处**：无论开几个 worktree，`tasks.yaml`、
-`knowledge.yaml` 和可选 `delivery.yaml` 都只认一个权威副本（通常在基线/协调所在
-worktree）。Coordinator 单写任务、知识与 `deliveryRuns`；交付能力只在显式配置维护
-时修改。`project.orchestration`、顶层 `workerReceipts` 和任务 dispatch 也只写入这个
+`knowledge.yaml`、可选 `delivery.yaml` 和可选 `regression.yaml` 都只认一个权威
+副本（通常在基线/协调所在 worktree）。Coordinator 单写任务、知识、回归目录、
+`deliveryRuns` 与 `regressionRuns`；交付能力只在显式配置维护时修改。`project.orchestration`、顶层 `workerReceipts` 和任务 dispatch 也只写入这个
 副本；不要每个 worktree 各留一份会分叉的项目状态。profile 解析、launcher 与
 receipt 规则见 `model-routing.md` 和 `orca-adapter.md`。
 
@@ -271,7 +271,7 @@ frontendDir:
 worktreePath:
 ```
 
-如果开发在 `<dev_worktree>` 修复，但服务跑的是另一个 worktree，必须**停止并重启正确服务**后再测。长跑服务或静态前端尤其要确认加载的是最新构建产物。若项目配置了 `intents.testEnvironment`，重启方式以该 profile 为准，不另写一套启动命令。
+如果开发在 `<dev_worktree>` 修复，但服务跑的是另一个 worktree，必须**停止并重启正确服务**后再测。长跑服务或静态前端尤其要确认加载的是最新构建产物。若项目配置了 `intents.testEnvironment`，重启方式以 deployer 绑定为准，不另写一套启动命令。
 
 ---
 

skills/ack/references/delivery.md

@@ -54,28 +54,33 @@ channel、environment 或 source revision 漂移时重新确认。
 
 ## 3.1 测试环境与发版写在同一份契约
 
-`docs/ack/delivery.yaml` 是测试环境部署和版本发布的唯一文档。不要另写操作手册，
+`docs/ack/delivery.yaml` 是测试环境绑定和版本发布的唯一文档。不要另写操作手册，
 也不要把其中一项写进 `project.md`。用户用自然语言说明「怎么布测试环境」或
-「怎么发版」时，Coordinator 把两者都维护进这份文件的 `intents`、entrypoint、
-artifact、environment 和 profile。
+「怎么发版」时，Coordinator 把两者都维护进这份文件的 `intents`。
 
 ```yaml
 intents:
-  testEnvironment: local-binary   # profile ID，或 null
-  release: null                   # profile ID，或 null
+  testEnvironment:
+    via: deployer
+    env: test          # 项目 .skiff/deployer/test；尚未说明时为 null
+  release: null        # profile ID，或 null
 ```
 
-- `testEnvironment` 指向 `stopAt: validation_ready` 的 profile：build 产物、部署到
-  development/staging、健康检查。用户说「重新布测试环境」「我要测试」时执行它；
-  派发 Test 复测前，若该 intent 已配置且 `enabled: true`，Coordinator 也先执行它。
-  不要求当前有 `verified` 任务。Test 不对这个 intent 发明编译或启动命令。
+- `testEnvironment` 绑定 deployer skill 的项目环境目录。用户说「重新布测试环境」
+  「我要测试」时，ACK 加载 deployer 的 `SKILL.md`，对 `.skiff/deployer/<env>`
+  按服务执行 sync + up 和健康检查。派发 Test 复测或跑回归前，若该 intent 已配置
+  且 `enabled: true`，Coordinator 也先执行它。不要求当前有 `verified` 任务。
+  Test 不对这个 intent 发明编译或启动命令。旧的 profile ID 字符串不再执行，必须
+  迁到 `{via: deployer, env: <env>}`。本地进程启动写在 `project.md`，不算这个
+  intent。
 - `release` 指向 `stopAt: released` 的 profile。用户说「发布一个版本」时执行它。
   口头「发版」不能代替 stable/production 的 `approval` 步骤。
 - 对应 intent 为 `null` 或交付未启用：停止，请用户说明怎么做，按「交付配置维护」
   写入同一文件后再执行。不猜测 Makefile、镜像仓库或发布通道。
 - 用户触发的 intent 运行写入 `tasks.yaml.deliveryRuns`，`intent` 填
-  `testEnvironment` 或 `release`，`taskIds` 可为空。绑定任务的常规交付 run 不填
-  `intent`，仍只能引用 `verified` 任务。
+  `testEnvironment` 或 `release`，`taskIds` 可为空。测试环境 run 的 `profile` 记
+  `deployer-<env>`。绑定任务的常规交付 run 不填 `intent`，仍只能引用
+  `verified` 任务。
 
 ## 4. 运行前检查
 
@@ -147,7 +152,9 @@ ID 指向不同 commit、digest 或目标时停止，不覆盖或另建伪装成
 ## 7. 与低层 Skill 的边界
 
 ACK 只负责读取项目交付契约、编排顺序、守住审批点并汇总证据，不复制低层 skill 的
-上传、镜像或 Git 发布实现。`builder` 和
-`manage-release` 仍是可独立使用、独立安装的能力；缺失时 ACK 使用契约中已审查的
-项目 entrypoint，二者都不可用时把对应步骤标为 `blocked`。低层 skill 自身要求显式
-调用时，ACK 不能绕过它的触发与授权边界。
+上传、镜像、Git 发布或远程 Compose 实现。`builder`、`manage-release` 和
+`deployer` 仍是可独立使用、独立安装的能力。运行测试环境时 ACK 必须加载
+deployer skill，不能把 compose/rsync/远程 docker 命令写进 ACK。发版步骤缺失
+builder 或 manage-release 时，ACK 使用契约中已审查的项目 entrypoint，二者都不可用
+时把对应步骤标为 `blocked`。低层 skill 自身要求显式调用时，ACK 不能绕过它的
+触发与授权边界；ACK 内部调用 deployer 布测试环境是该 skill 的合法调用路径。

skills/ack/references/init-new-project.md

@@ -12,7 +12,8 @@
 3. `skiff` 命令可用。
 
 不要覆盖已有的 `docs/ack/project.md`、`docs/ack/tasks.yaml`、
-`docs/ack/knowledge.yaml`、`docs/ack/delivery.yaml`、`AGENTS.md` 或其它 Agent
+`docs/ack/knowledge.yaml`、`docs/ack/delivery.yaml`、`docs/ack/regression.yaml`、
+`AGENTS.md` 或其它 Agent
 指令文件。ACK 不会自动
 修改 `AGENTS.md`、`CLAUDE.md` 或其它 Agent 指令文件。不要把 token、`.env`
 内容或其它私有配置写入 ACK 项目状态。
@@ -38,7 +39,8 @@ docs/ack/
 ├── project.md
 ├── tasks.yaml
 ├── knowledge.yaml
-└── delivery.yaml       # 默认 enabled: false
+├── delivery.yaml       # 默认 enabled: false
+└── regression.yaml     # 默认 cases: []
 ```
 
 如果任一目标文件已经存在，命令会拒绝覆盖。初始化过程不会创建 `kit`、
@@ -62,6 +64,13 @@ docs/ack/
 `deliveryRuns: []`。首次生成保持 `enabled: false`，按 `delivery.md` 展示并确认
 解析结果后才启用。不要重跑 `skiff init ack`，也不要改写已有任务或知识。
 
+### 旧项目补充回归目录
+
+`regression.yaml` 对旧项目是可选能力。用户明确要求回归或授权补齐时，从
+`templates/regression.template.yaml` 生成 `docs/ack/regression.yaml`，并只补
+`project.regressionFile: docs/ack/regression.yaml` 与顶层 `regressionRuns: []`。
+保持 `cases: []`，不要从聊天虚构用例。
+
 ## 完善项目覆盖层
 
 编辑 `docs/ack/project.md`，填入：
@@ -89,6 +98,8 @@ docs/ack/
   不再参与路径绑定。
 - 新项目的 `project.deliveryFile` 固定为 `docs/ack/delivery.yaml`，并保留顶层
   `deliveryRuns: []`。旧项目只有在采用交付能力时才补这两个字段。
+- 新项目的 `project.regressionFile` 固定为 `docs/ack/regression.yaml`，并保留顶层
+  `regressionRuns: []`。旧项目只有在采用回归能力时才补这两个字段。
 - `allowedWorktrees` 已废弃（v0.19 起），新任务板不生成该字段；worker 默认在
   `--project-root` 工作。模型 allowlist、profiles 和 defaults 使用项目实际允许值。
   不要把完整启动命令、`extraArgs`、`env` 或任意 executable 写进任务板。
@@ -118,10 +129,16 @@ candidate 留在任务证据中，不会被派发。只有 Test 独立验证且
 
 新项目的 `docs/ack/delivery.yaml` 保持 `enabled: false`、空能力表、空 profile，以及
 `intents.testEnvironment: null` 与 `intents.release: null`。
-不要根据 README 或 CI 自动推断并启用发布/部署。用户用自然语言说明测试环境或发版
-方式后，Coordinator 按 `delivery.md` 把两者都写入这一份契约：`intents` 指向对应
-profile，工具 target 与仓库脚本分开引用。配置中不保存 shell、环境变量值或凭据
-正文；稳定发布和生产部署必须有显式 approval 步骤。
+不要根据 README 或 CI 自动推断并启用发布/部署。用户说明测试环境后，Coordinator
+按 deployer skill 准备 `.skiff/deployer/<env>`，并把
+`intents.testEnvironment` 写成 `{via: deployer, env: <env>}`；发版仍指向 profile。
+配置中不保存 shell、环境变量值或凭据正文；稳定发布和生产部署必须有显式
+approval 步骤。
+
+## 初始化回归目录
+
+新项目的 `docs/ack/regression.yaml` 保持 `cases: []`。不要从 README 或聊天猜测
+用例。任务 `verified` 后按 `regression.md` 收获。
 
 ## 校验
 
@@ -132,12 +149,14 @@ python3 <ack-skill-dir>/scripts/validate_tasks.py docs/ack/tasks.yaml
 python3 <ack-skill-dir>/scripts/validate_knowledge.py docs/ack/knowledge.yaml --tasks docs/ack/tasks.yaml
 python3 <ack-skill-dir>/scripts/validate_delivery.py docs/ack/delivery.yaml \
   --tasks docs/ack/tasks.yaml --project-root <project-root>
+python3 <ack-skill-dir>/scripts/validate_regression.py docs/ack/regression.yaml \
+  --tasks docs/ack/tasks.yaml
 ```
 
 同时确认：
 
-- `project.md`、`tasks.yaml`、`knowledge.yaml` 和 `delivery.yaml` 没有未替换的
-  `<...>` 占位符。
+- `project.md`、`tasks.yaml`、`knowledge.yaml`、`delivery.yaml` 和
+  `regression.yaml` 没有未替换的 `<...>` 占位符。
 - `project.overlayFile` 指向真实文件。
 - `project.knowledgeFile` 指向 `docs/ack/knowledge.yaml`。
 - 新项目的 `project.deliveryFile` 指向 `docs/ack/delivery.yaml`；交付默认关闭。
@@ -154,7 +173,7 @@ python3 <ack-skill-dir>/scripts/validate_delivery.py docs/ack/delivery.yaml \
 
 完成后报告：
 
-- 创建或确认的四个项目文件。
+- 创建或确认的项目文件（含回归目录）。
 - 检测到的技术栈和验证命令。
 - 任务板、项目知识和交付契约校验结果。
 - 仍需用户补充的值。

skills/ack/references/kickoff.md

@@ -37,11 +37,12 @@
    Developer/Test profile；优先选择同一轮内角色/profile/worktree 匹配的空闲 worker，
    只有历史消息已可信清理并取得新会话身份才复用，否则审阅 plan 后用 expected
    fingerprint 创建 fresh worker；
-   dispatch 开发 → worker_done → 若 intents.testEnvironment 已启用则先拉起测试环境 →
+   dispatch 开发 → worker_done → 若 intents.testEnvironment 已启用则先用 deployer 拉起测试环境 →
    dispatch 测试独立复测 → 你读证据终检 → 回写 tasks.yaml；
    每个任务最多三轮有效产品复验，三轮不过记 leftover 并升级我复盘；环境失败单独
    记录、恢复并告诉我下一步，不占产品复验轮次。
-7. 所选任务都 verified 后，只有本次计划包含交付时才按 profile 顺序执行并写
+7. 所选任务都 verified 后，按 regression.md 给出新增/更新/退役/无回归，确认后写入
+   docs/ack/regression.yaml。只有本次计划包含交付时才按 profile 顺序执行并写
    deliveryRuns；启用 delivery 时不能省略 defaultProfile，默认停在 validation_ready
    或 review_ready，stable/production 步骤再次向我确认。
 ```
@@ -155,7 +156,7 @@ worktree 走同一套 `plan` -> 带 expected fingerprint 的 `launch`。在调
 task-create → dispatch 给 DEV → 先确认 DEV 已开始执行（read/probe；未开始按环境失败处理）→ 滚动 wait 等 worker_done
   → 每个角色先检查可安全重置的空闲 worker；不符合即通过 plan + expected fingerprint launch fresh worker
   → 每轮使用 Coordinator 分配的稳定 <task-id>-A<round>
-  → 回写 fixed_by_dev → 若 intents.testEnvironment 已启用则先拉起测试环境 → dispatch 给 TEST 复测 → 等 retest_result
+  → 回写 fixed_by_dev → 若 intents.testEnvironment 已启用则先用 deployer 拉起测试环境 → dispatch 给 TEST 复测 → 等 retest_result
   → Developer 回 knowledgeApplied / knowledgeCandidates，Test 回 knowledgeChecks
   → 环境无法完成：记录 environmentIncidents，报告影响与用户下一步，恢复后重新复验（不计轮次）
   → Coordinator 读证据终检 → 过则 verified，产品失败则 failed_retest 再派 DEV（最多累计 3 轮）
@@ -174,8 +175,13 @@ Coordinator 只内联本轮 `knowledgeRefs` 指向的少量知识，不要求 wo
 
 ## 第 5 步：可选交付
 
-用户说「重新布测试环境」或「发布一个版本」时，按 `delivery.md` §3.1 的
-`intents` 执行对应 profile，不另找文档。intent 为 null 时先做交付配置维护。
+用户说「重新布测试环境」时加载 deployer skill 执行
+`intents.testEnvironment` 绑定；「发布一个版本」时按 `delivery.md` §3.1 的
+release profile 执行。intent 为 null 时先做交付配置维护。
+
+所选任务 `verified` 后，按 `regression.md` 把本轮黑盒路径收获进
+`docs/ack/regression.yaml`（新增/更新/退役/无回归四选一，用户确认后写入）。
+用户说「回归」时先布测试环境，再派 Test 按目录执行。
 
 所选任务都由 Coordinator 标记为 `verified` 后，若用户确认的计划包含交付，按
 `delivery.md` 执行所选 profile。启用交付时必须在计划中默认列出 `defaultProfile`，
@@ -203,6 +209,6 @@ Coordinator 最后标记整轮任务完成后，用 `scripts/reclaim_workers.py`
 产品文档 + 验收信号写在前（你，强模型）→ 确认显式 `knowledgeRefs` → 从
 `tasks.yaml.project.orchestration` 解析安全 profile → 审阅 plan 并用 expected
 fingerprint 启动 fresh DEV/TEST → dispatch / 复测 / 终检循环 → 任务结论落
-`tasks.yaml` → 可选 delivery profile 到审核点，验证后的
-跨任务知识由 Coordinator 落 `knowledge.yaml` → 整轮完成后回收仅属于 verified
-任务的 worker，保留 blocked/failed/leftover worker。
+`tasks.yaml` → 可选收获回归用例到 `regression.yaml` → 可选 delivery profile
+到审核点，验证后的跨任务知识由 Coordinator 落 `knowledge.yaml` → 整轮完成后回收
+仅属于 verified 任务的 worker，保留 blocked/failed/leftover worker。

skills/ack/references/optimization-method.md

@@ -176,14 +176,18 @@ one dispatch = one bug = one acceptance path
 
 ## 8. 优先让测试可执行化
 
-如果某个问题需要多轮修复，说明它值得沉淀成自动化检查。这类可执行测试由 Test 拥有并维护（见 `roles-and-permissions.md` 权限表的 `<integration_test_paths>`）。优先级：
+如果某个问题需要多轮修复，说明它值得沉淀成自动化检查。黑盒回归目录是
+`docs/ack/regression.yaml`（见 `regression.md`）；可执行脚本仍由 Test 维护在
+`<integration_test_paths>`。优先级：
 
-1. API smoke。
-2. 浏览器脚本或 case 文档。
-3. 单元测试。
-4. 人工检查清单。
+1. 把本轮验收信号收获进 `regression.yaml`。
+2. API smoke。
+3. 浏览器脚本或 `automationRef`。
+4. 单元测试。
+5. 人工检查清单。
 
-目标不是全部自动化，而是把最容易反复误判的路径自动化。
+目标不是全部自动化，而是把最容易反复误判的路径变成可重复跑的回归用例。任务
+`verified` 后必须给出新增/更新/退役/无回归四选一。
 
 ---
 

skills/ack/references/prompt-templates.md

@@ -128,7 +128,7 @@ Developer 本轮声称（仅供参考，不作数）：
 - <K-014@2>: <directive + rationale + verification.ref + resolved path/args>
 
 复测要求（见 roles-and-permissions.md §三角色能力清单 · Test）：
-- 先对齐运行环境（pwd / 分支 / commit / 服务 worktree，见 closed-loop.md），避免测错实例或旧构建。测试环境由 Coordinator 按 `delivery.yaml` 的 `intents.testEnvironment` 拉起；不要自行发明编译或启动命令。网站类确认 Base URL 已指向这次产物后再测。
+- 先对齐运行环境（pwd / 分支 / commit / 服务 worktree，见 closed-loop.md），避免测错实例或旧构建。测试环境由 Coordinator 按 deployer 绑定拉起；不要自行发明编译或启动命令。网站类确认 Base URL 已指向这次产物后再测。
 - 网站类任务优先用浏览器复测真实交互，其次才是 API / 脚本。
 - 逐条验证下列验收信号，不要只看静态文案，要验证交互后的真实状态：
   1. <observable signal 1>
@@ -137,7 +137,7 @@ Developer 本轮声称（仅供参考，不作数）：
 - 若 worker、权限、服务、测试数据、浏览器或工具导致验收无法完成，明确回报
   `environmentFailure`，不要把“未验证”写成产品 `signals-failed`；若已有独立产品失败
   证据，则分别列出产品信号与环境限制。
-- 需要时把易反复误判的路径沉淀成可执行测试（见 optimization-method.md §8）。
+- 需要时把本轮通过的黑盒路径写成 `regressionCandidates`（见 regression.md），不要直接改 `docs/ack/regression.yaml`。
 - 对每条适用的 `knowledgeRef`，把它的 verification.ref 交给
   `<ack-skill-dir>/scripts/run_verification.py docs/ack/knowledge.yaml
   <verification-ref> --project-root <project-root>`，并回报 `knowledgeChecks`。
@@ -215,6 +215,16 @@ knowledgeChecks:
   - ref: <K-001@1>
     result: <passed|failed|not_applicable>
     evidence: <independent evidence>
+regressionCandidates:
+  - title: <reusable black-box case>
+    surface: browser/api
+    suite: smoke/full
+    setup: <preconditions>
+    steps: [<step>]
+    expected:
+      - kind: visible-text/api-status/api-field/url/interaction
+        value: <observable signal>
+    sourceKind: feature/bug
 knowledgeCandidates:
   - kind: guardrail/pitfall/verification
     title: <new lesson found by Test>
@@ -263,6 +273,10 @@ Orca 模式下用 `orca-adapter.md` §「Test 回报复测结果」的命令发
 - 新增或更新：<active/stale/superseded entries written by Coordinator, or none>
 - 待验证 candidate：<remaining candidates or none>
 
+回归：
+- 收获：新增/更新/退役/无回归 <case ids or none>
+- 最近一次回归运行：<RR-id / passed|failed|n/a>
+
 交付（未启用时写 n/a）：
 - run/profile/status：<delivery run id / profile / validation_ready|review_ready|released|blocked|failed>
 - PR/MR：<URL and head/base>
@@ -274,3 +288,28 @@ Orca 模式下用 `orca-adapter.md` §「Test 回报复测结果」的命令发
 - <repo_path>: <git status summary>
 - <dev_worktree>: <git status summary>
 ```
+
+---
+
+## 7. 派发给 Test 跑回归
+
+```text
+请按回归目录对当前测试环境做独立黑盒回归。
+suite: <smoke|full|custom>
+baseUrl: <deployer 给出的地址>
+
+用例（来自 select_regression.py，不要发明步骤）：
+- <REG-id>: surface=<browser|api>
+  setup: <setup>
+  steps: <steps>
+  expected: <expected signals>
+
+要求：
+- 先确认 Base URL 可访问；不可访问时回报 environmentFailure，不要编造产品失败。
+- surface=browser 必须走真实页面交互，不能改成只打 API。
+- 逐条对照 expected 回报 pass/fail 与证据。
+- 不要修改源码，不要写 tasks.yaml / knowledge.yaml / regression.yaml。
+
+完成后按 §5 的复测报告格式回报，signals 使用 REG-id。
+```
+

skills/ack/references/regression.md

@@ -0,0 +1,73 @@
+# ACK 回归目录与运行
+
+本文件是回归用例目录、收获时机和运行模式的 SSOT。三角色闭环仍见
+`closed-loop.md`；测试环境部署见 `delivery.md` 与 deployer skill。
+
+回归不是新 skill，也不写入 `knowledge.yaml`。知识是护栏；回归是可观测的黑盒
+用例清单。
+
+## 1. 目录
+
+项目状态是 `docs/ack/regression.yaml`。任务板用
+`project.regressionFile: docs/ack/regression.yaml` 声明，运行证据写在
+`tasks.yaml.regressionRuns`。新项目初始化会生成空目录；旧项目没有该文件时，
+「运行回归」先停下来，用户授权后再从模板补齐。
+
+只有 Coordinator 写 `regression.yaml`。Test 在复测报告里提名
+`regressionCandidates`；用户确认后 Coordinator 落盘，并把 case id 写入任务的
+`regressionRefs`。不要把用例散落到第二份文档，也不要让 Test 直接改
+`docs/ack/`。
+
+`tests/browser/**` 仍可由 Test 维护可执行脚本。用例可用可选 `automationRef`
+指向那些脚本；没有脚本时 Test worker 按目录里的步骤和验收信号执行。
+
+## 2. 用例
+
+每条用例是给独立 Test worker 的说明书，复用
+`optimization-method.md` §1 的可观测信号。ACK 不提供 YAML-DSL 解释器，也不强制
+Playwright。
+
+读取时用 `scripts/select_regression.py`，不要把完整目录注入上下文：
+
+```bash
+python3 <ack-skill-dir>/scripts/select_regression.py docs/ack/regression.yaml
+python3 <ack-skill-dir>/scripts/select_regression.py docs/ack/regression.yaml \
+  --suite full
+python3 <ack-skill-dir>/scripts/select_regression.py docs/ack/regression.yaml \
+  --case-id REG-login-001
+```
+
+默认 `--suite smoke` 只返回 `status: active` 且 `suite: smoke` 的用例。
+`--suite full` 返回全部 active 用例。写回前仍运行
+`scripts/validate_regression.py`。
+
+`surface: browser` 的用例必须走真实页面交互，不能改成只打 API。
+`surface: api` 以 HTTP 状态和字段为证据。
+
+## 3. 收获
+
+任务进入 `verified` 且改了用户可见行为或 API 后，闭环结束前 Coordinator 必须给出
+四选一，不能跳过：
+
+- 新增
+- 更新已有用例
+- 退役（功能已删除）
+- 无回归（纯内部重构、leftover、无用户可见变化）
+
+草案来自任务验收信号和 Test 的独立证据，按 `path + expected` 去重。用户确认后
+才写入目录。P0 / 主路径默认 `suite: smoke`，其余 `full`。
+
+## 4. 运行
+
+用户说「回归」「跑回归测试」时执行本模式，不要求当前有 `verified` 任务。
+
+1. 目录存在且有选中的 active 用例；否则停止。
+2. 先按「运行测试环境」调用 deployer，拿到 Base URL。
+3. Coordinator 派独立 Test worker，只带选中用例、Base URL 和 surface。
+4. Test 逐条对照 `expected` 回报证据。Coordinator 终检后写入 `regressionRuns`。
+5. 失败只报告，不自动派 Developer，不占任务三轮预算。用户明确要求修复时，按
+   「修 bug」为每条失败开一个任务。
+
+环境失败（没有浏览器、打不开部署地址、deployer 失败）记环境事件，不记产品失败。
+
+默认跑 smoke。用户点名 full 或具体 case id 时按点名范围执行。

skills/ack/references/roles-and-permissions.md

@@ -12,7 +12,7 @@ ACK 默认三个独立 Agent：**Coordinator 只编排、Test 只验证、Develo
 
 | 角色 | 主要职责 | 验证方式 | 不应做的事 |
 |------|----------|----------|------------|
-| Coordinator (PM) | 需求拆解、定验收信号、排优先级、单写 `tasks.yaml` / `knowledge.yaml`、选择知识、向 Developer/Test 派发、跑三轮闭环、做最终 gate；经确认后编排可选交付 | 读 Test 证据并对齐原始意图（不亲自跑测试）；核对交付证据 | 修改源码、亲自复测、凭 worker_done 直接标 `verified`、自动激活未验证知识、把配置当作发布授权 |
+| Coordinator (PM) | 需求拆解、定验收信号、排优先级、单写 `tasks.yaml` / `knowledge.yaml` / `regression.yaml`、选择知识、向 Developer/Test 派发、跑三轮闭环、做最终 gate；经确认后编排可选交付与回归 | 读 Test 证据并对齐原始意图（不亲自跑测试）；核对交付与回归证据 | 修改源码、亲自复测、凭 worker_done 直接标 `verified`、自动激活未验证知识、把配置当作发布授权 |
 | Test | 黑盒复测、回归验证、执行知识检查、独立验证知识候选、沉淀可执行测试、产出证据 | 浏览器、API、集成脚本、用户可见行为 | 修改应用源码、修改产品规格、写 `tasks.yaml` 或 `knowledge.yaml` |
 | Developer | 实现修复、写单元测试、运行构建和白盒验证、提名项目知识 | 单元测试、类型检查、构建、本地运行 | 修改产品规格与集成测试、写项目状态、标记 `verified`、绕过测试声称完成 |
 | User / Decision Owner | 决定范围、优先级、阻塞项是否继续 | 审阅报告和遗留清单 | 直接替代复测证据 |
@@ -110,6 +110,7 @@ ACK 默认三个独立 Agent：**Coordinator 只编排、Test 只验证、Develo
 | `<local_config>` | Read-only | Read-only | Read-only | 本地私有配置，不提交 |
 | `tasks.yaml` | R/W | Read-only | Read-only | 见下方「项目状态写入约定」 |
 | `knowledge.yaml` | R/W | Read-only | Read-only | Coordinator 单写；Developer/Test 通过回报提名或验证 |
+| `regression.yaml` | R/W | Read-only | Read-only | Coordinator 单写；Test 通过 `regressionCandidates` 提名 |
 | `delivery.yaml` | 仅显式维护时 R/W | Read-only | Read-only | 声明项目交付能力，不保存凭据或执行授权 |
 
 ---
@@ -178,11 +179,12 @@ planned -> skipped
 
 ## 项目状态写入约定（并发安全）
 
-`tasks.yaml` 是任务与交付运行事实源，`knowledge.yaml` 是跨任务项目知识事实源，
-`delivery.yaml` 是项目交付能力事实源。为避免多 Agent 并发写冲突：
+`tasks.yaml` 是任务、交付运行与回归运行事实源，`knowledge.yaml` 是跨任务项目知识
+事实源，`regression.yaml` 是黑盒回归用例事实源，`delivery.yaml` 是项目交付能力
+事实源。为避免多 Agent 并发写冲突：
 
-- **只有 Coordinator 写 `tasks.yaml` 和 `knowledge.yaml`**。Test 与 Developer
-  对它们都是只读的。
+- **只有 Coordinator 写 `tasks.yaml`、`knowledge.yaml` 和 `regression.yaml`**。
+  Test 与 Developer 对它们都是只读的。
 - Developer 的实现状态、Test 的复测证据都通过消息回传（`worker_done` / 复测报告），由 Coordinator 落盘。
 - Developer 和 Test 只能通过 `knowledgeCandidates` 提名知识；candidate 保存在
   当前任务证据中，在 Test 独立验证和 Coordinator gate 前不写成可派发的 active