@xulthekl/team-flow 0.43.1 → 0.45.0

package/skills/business-analysis/references/interaction-rules.md

@@ -0,0 +1,86 @@
+# 业务分析多轮交互规则
+
+本规则约束业务分析 skill 与用户的对话方式、待办处理、确认机制和断点恢复。
+
+## 核心交互原则
+
+### 一次只问一个问题
+
+- 每轮只向用户提出 **1 个** 清晰问题
+- 等待用户回答后再决定下一个问题
+- 禁止一次抛出 2 个及以上问题
+
+### 优先选择题
+
+- 当答案有限时，给出 2–3 个选项并推荐其一
+- 选项后简述每个选项的 trade-off
+- 用户可自由选择或给出新答案
+
+### 开放题仅用于真正开放的场景
+
+- 以下情况使用开放题：
+  - 用户首次输入极短，需要补充背景
+  - 询问 Acceptance 的具体阈值
+  - 确认业务角色名称
+
+## 待办（TODO）处理规则
+
+### 何时记录 TODO
+
+- 用户明确表示 "不知道"、"需要确认"、"后续补充"
+- 问题虽然重要，但当前无法获得可靠答案
+- 继续追问会影响对话收敛效率
+
+### 如何记录 TODO
+
+1. 在 `## Open Questions / TODOs` 段落新增一行：
+   - `TODO-xxx`
+   - 问题原文
+   - 记录日期
+   - 状态 `pending`
+   - 关联的 `REQ-xxx` / `SC-xxx`（如有）
+2. 将相关 REQ/SC 的状态保持为 🔵 pending
+3. 向用户复述已记录的 TODO，确认无误后继续
+
+### TODO 后续回填
+
+- 用户补充答案后，将 TODO 状态改为 `answered`
+- 把答案回填到对应 REQ/SC 的缺失维度
+- 重新运行 QA 检查
+
+## 确认机制
+
+### 增量确认（默认）
+
+- 每轮提取的结构化内容先以 🔵 pending 写入 `business-analysis.md`
+- 最终确认时统一把所有 🔵 翻转为 ✅ confirmed
+- 最终确认前展示完整文档预览，让用户选择 **Confirm / Adjust / Abort**
+
+### 最终确认内容
+
+确认前必须展示：
+- 当前 Requirements List 完整表格
+- 当前 Scenario List 完整表格
+- Open Questions / TODOs 列表
+- 本轮回新增/修改的摘要
+
+### 用户选择
+
+- **Confirm**：写入文件，pending → confirmed
+- **Adjust**：指出需要调整的条目，返回对话循环
+- **Abort**：保持当前 pending 状态，不翻转 confirmed，向用户说明已保存的 pending 内容
+
+## 终止条件
+
+正常终止需满足：
+- QA 所有 Error 检查通过，或
+- 用户明确说 "生成文档" / "确认输出"
+
+安全兜底：
+- 单轮对话最多 10 个问题；达到上限时强制进入最终确认
+
+## 断点恢复
+
+- `business-analysis.md` 本身就是断点载体
+- 恢复时先读取现有文件，把 ✅ confirmed 条目作为基线，🔵 pending 条目作为待确认内容
+- 向用户展示当前进度并询问 "继续完善 / 新建版本 / 覆盖"

package/skills/business-analysis/references/output-schema.md

@@ -0,0 +1,88 @@
+# business-analysis.md 输出格式
+
+本文件定义 `requirement/vN/business-analysis.md` 的精确格式。业务分析 skill 只能输出此格式，不得写入 `ledger.md`、PRD、流程或架构等下游制品。
+
+## 文件定位
+
+- 路径：`requirement/vN/business-analysis.md`
+- 作用：承接对话沉淀，为 PRD 提供需求与场景数据
+- 不直接写入 `requirement/ledger.md`；版本归档由 orchestrator 统一处理
+
+## Frontmatter
+
+```yaml
+---
+version: vN
+status: draft | confirmed
+last_updated: YYYY-MM-DD
+source: business-analysis skill
+---
+```
+
+## 必须包含的两大板块
+
+1. **需求列表（Requirements List）**
+2. **业务场景列表（Scenario List）**
+
+可选追加板块：
+
+3. **Open Questions / TODOs** —— 仅用于记录用户暂时无法回答的问题
+
+## 需求列表格式
+
+每个需求一行，字段如下：
+
+| 字段 | 要求 |
+|------|------|
+| ID | `REQ-xxx`，版本内顺序编号 |
+| Description | 一句话意图，用 SHALL/MUST 表达 |
+| Related Scenarios | `SC-xxx` 列表，逗号分隔 |
+| Status | 🔵 pending / ✅ confirmed |
+| Change History | `[vN.M YYYY-MM-DD create/modify 摘要]` |
+
+## 业务场景格式
+
+每个场景一行，字段如下：
+
+| 字段 | 要求 |
+|------|------|
+| ID | `SC-xxx` |
+| Role | 具体角色，禁止泛化 "user" |
+| Goal | 角色目标 |
+| Trigger | 触发事件/条件 |
+| Precondition | 前置条件 |
+| Constraint | 规则/限制/策略 |
+| Acceptance | 可测试成功条件，必须含具体阈值/字段/结果 |
+| Related Requirements | `REQ-xxx` 列表 |
+| Status | 🔵 pending / ✅ confirmed |
+| Change History | `[vN.M YYYY-MM-DD create/modify 摘要]` |
+
+## Open Questions / TODOs 格式
+
+| 字段 | 要求 |
+|------|------|
+| ID | `TODO-xxx` |
+| Question | 未能回答的问题原文 |
+| Recorded At | YYYY-MM-DD |
+| Status | pending / answered / dropped |
+| Related REQ/SC | 可选 |
+
+## 状态管理
+
+- 仅两种状态：🔵 pending、✅ confirmed
+- 状态转换只能经由用户阻塞确认
+- 确认前必须先通过 QA 检查
+
+## 与 PRD 的映射
+
+| PRD 章节 | 来源内容 |
+|---------|---------|
+| §7 D7.5_系统功能清单 | 需求列表 + 场景关联（REQ / SC） |
+| §8 D7.6_系统功能处理说明书 | 按场景分组的功能模块 |
+
+## 禁止事项
+
+- 禁止在 `business-analysis.md` 中直接写入 `ledger.md`
+- 禁止用泛化角色如 "user" 替代具体业务角色
+- 禁止 Acceptance 写成不可测试的模糊描述
+- 禁止写入业务流程详情（L1-L4、Mermaid、活动表等）

package/skills/business-analysis/references/qa-checklist.md

@@ -0,0 +1,31 @@
+# 业务分析 QA 检查清单
+
+业务分析 skill 在最终确认前必须执行以下 QA 检查。所有 Error 级别项必须全部通过，否则不得将条目标记为 ✅ confirmed。
+
+## Error 级别检查
+
+- [ ] **C1 角色覆盖**：用户输入中提到的所有具体角色都有对应的场景（SC-xxx）覆盖
+- [ ] **C2 六维度齐全**：每个场景都填满 Role / Goal / Trigger / Precondition / Constraint / Acceptance
+- [ ] **C3 REQ 引用存在**：场景中引用的 `REQ-xxx` 必须出现在需求列表中
+- [ ] **C4 对话证据可追溯**：每个场景都能在对话记录或输入中找到证据，禁止编造
+- [ ] **C5 Acceptance 可测试**：验收标准必须具体、可验证，含明确阈值/字段/结果
+
+## Warning 级别检查
+
+- [ ] **W1 角色具体化**：不存在 "user"、"管理员" 等泛化角色，除非已明确定义为业务角色
+- [ ] **W2 需求表述**：需求描述使用 SHALL/MUST，避免 "should"、"可以" 等弱约束
+- [ ] **W3 变更历史**：新增或修改的条目都含变更历史
+
+## QA 不通过时的处理
+
+1. 定位导致失败的条目和维度
+2. 向用户提出**一个**针对性的澄清问题
+3. 根据回答更新文档
+4. 重新运行 QA 检查
+5. 最多允许 3 轮内部自修正；仍无法通过则记录 TODO 并保持 pending
+
+## 待办（TODO）的 QA 规则
+
+- TODO 问题可以暂时不阻塞其他已确认条目的确认
+- 与 TODO 相关的 REQ/SC 必须保持 🔵 pending 状态
+- 用户后续补充答案后，应更新 TODO 状态为 answered 并回填到对应条目

package/skills/business-analysis/references/version-resolution.md

@@ -0,0 +1,41 @@
+# 业务分析版本解析规则
+
+本规则定义业务分析 skill 如何确定目标版本 `vN`。
+
+## 解析顺序
+
+按以下优先级依次解析：
+
+1. **显式参数**：用户在调用 skill 时传入的版本，如 `business-analysis v2`
+2. **运行时配置**：`tf runtime config --get active.requirement`（若返回有效值）
+3. **目录扫描**：读取 `requirement/` 下已有的 `vN` 目录，取最大 N
+4. **默认回退**：以上皆无时使用 `v1`
+
+## 目录扫描规则
+
+- 只识别 `requirement/vN/` 形式目录，其中 N 为正整数
+- 忽略非版本目录（如 `archived/`、`draft/`）
+- 若存在 `v1`、`v2`、`v3`，则取 `v3`
+
+## 模式判断
+
+解析出版本后，判断当前是 Create 还是 Update 模式：
+
+| 条件 | 模式 | 行为 |
+|---|---|---|
+| `requirement/vN/business-analysis.md` 不存在 | Create | 新建文件 |
+| 文件已存在 | Update | 读取现有条目，追加或修订 |
+
+## 已存在文件的处理
+
+检测到文件已存在时，必须向用户询问以下三者之一：
+
+- **继续完善**：在当前版本基础上追加/修改条目
+- **新建版本**：创建 `v(N+1)/business-analysis.md`，旧版本保持 archived
+- **覆盖**：清空当前版本重新生成（不推荐，需用户明确确认）
+
+## 版本号输出
+
+- 最终输出的 `business-analysis.md` frontmatter 中必须包含 `version: vN`
+- Change History 中的版本号采用 `vN.M` 形式，其中 M 为本次编辑的次要版本（同一 vN 内递增）
+- 首次创建使用 `vN.1`，后续补充依次递增

package/skills/contract-builder/SKILL.md

@@ -118,9 +118,9 @@ hotfix/tweak workflow 不生成 test-matrix.md（guard 豁免）；full workflow
 tf state set <change-dir> test_matrix_skipped true && tf state set <change-dir> test_matrix_skip_reason "<一句话说明>"
 ```
 
-### GLAF4 Java 路由
+### GLAF4 Java 路由（v2.1 §6 实施委托交接）
 
-当项目技术栈为 GLAF4 Java（Spring Boot / JUnit 5 / Mockito）时，提示用户是否调用 `glaf4-test:glaf4-tests` 做精细矩阵设计。用户同意后：`glaf4-tests-design` 生成 `test-matrix.json` → `glaf4-tests-validate` 校验 → `tf test-matrix-export <test-matrix.json> <change-dir>/test-matrix.md` 转换为 team-flow 格式。完整 7 步协议见 workflow-start `references/routing-rules.md`「Route to glaf4-tests」。
+当项目技术栈为 GLAF4 Java（pom.xml/build.gradle + Spring Boot/JUnit5/Mockito）时，运行时探测 glaf4-dev 插件（`detectGlaf4Delegation`）。若 `is_glaf4_java && glaf4_dev_available && delegation_mode !== 'off'`，产出 `## GLAF4 Delegation` 段（mode + write_set_boundary + 权限位），作为**实施委托交接**——GLAF4 change 的生产+测试整体委托 glaf4-dev 七模式流，build-executor 退为兜底。完整协议见 `references/glaf4-delegation.md`（§6.1-§6.7）。矩阵设计委托（glaf4-test）已统一到 glaf4-dev（v2.1 §1.3）。**GLAF4 委托 change 例外**：上方 Hotfix/Tweak 的显式 skip 豁免不适用——委托路径下 test-matrix 是审计基线，`test_matrix_skipped` 被委托协议禁止（唯一例外 TEST_BOOTSTRAP 零测试，v2.1 §6.3 skip 禁令）。
 
 ## Approval Model (DP-3)
 

package/skills/contract-builder/references/glaf4-delegation.md

@@ -0,0 +1,130 @@
+# GLAF4 Delegation 段产出协议（v2.1 §6.1/§6.2）
+
+> 设计溯源（工作区开发期文档，非运行时加载路径）：`docs/plan/glaf4-dev-integration-design.md` v2.1（glaf4-dev 集成增强方案，位于 team-flow-workspace 工作区根）。
+> 职责：contract-builder 在产出 execution-contract.md 时，对 GLAF4 Java change 追加 `## GLAF4 Delegation` 段，
+> 作为**实施委托交接**（非矩阵设计委托）。经 DP-4 批准后生效。
+
+## 1. 运行时探测（v2.1 §4 接口①）
+
+contract-builder 产出 execution-contract 时（DP-4 前）实时探测——**显式运行 CLI 命令**（第三轮复评接线统一：探测必须写 config，纯库函数不落盘）：
+
+```bash
+tf glaf4-delegation detect <target_root> [--delegation-mode <auto|manual|off>]
+```
+
+`detect` 内部调用 `conventions-generator.mjs` 的 `detectGlaf4Delegation(root)` 解析 `~/.claude/plugins/installed_plugins.json`（glaf4-dev 条目含 installPath + version），产出三态：
+
+- `is_glaf4_java`（技术栈命中：pom.xml/build.gradle + Spring Boot/JUnit5/Mockito）
+- `glaf4_dev_available`（插件可用，含 version）
+- `delegation_mode`（auto/manual/off，用户可开关）
+
+探测结果写 `team-flow.config.json` 的 `glaf4_dev: {enabled, version, delegation_mode}` 段
+（git root ≠ target_root 时写 git root 冗余副本，monorepo 下多服务 OR 聚合；未传 `--delegation-mode` 保留已有值）。
+
+**判定**：`is_glaf4_java && glaf4_dev_available && delegation_mode !== 'off'` → 产出 GLAF4 Delegation 段。
+**依赖**：`recommendExecutionModesForChange` 读 `config.glaf4_dev.enabled` 决定是否注入 glaf4-delegation——**必须**先跑 detect 写 config，否则委托链不可达。
+
+## 2. change 性质 → 委托模式映射（v2.1 §6.1）
+
+| change 性质 | glaf4-dev 模式 | 权限位 |
+|---|---|---|
+| 新功能 / 新增接口 / 新增模块 | FEATURE_TDD | after-red |
+| 缺陷修复 | BUGFIX_REGRESSION | after-red |
+| 行为不变重构 | REFACTOR_PROTECTED | allowed + baseline_green_required |
+| 补单元测试(存量) | COMPLETE_UNIT_TESTS | none(test-only) |
+| 补集成测试(存量) | COMPLETE_INTEGRATION_TESTS | none(test-only) |
+| 测试环境冷启动(零测试) | TEST_BOOTSTRAP | none(test-only) |
+
+> REFACTOR 委托前置：存量基线不绿时委托必 NEEDS_INPUT → 先走 TEST_BOOTSTRAP/COMPLETE_UNIT_TESTS 补基线。
+
+## 3. GLAF4 Delegation 段结构
+
+execution-contract.md 追加段（write_set_boundary 权威源，不落 state YAML）：
+
+```markdown
+## GLAF4 Delegation
+
+- mode: FEATURE_TDD
+- permission: after-red
+- write_set_boundary:
+  - src/main/java/com/example/OrderService.java
+  - src/main/java/com/example/OrderRepository.java
+- target_root: <工程根绝对路径>
+- delegation_mode: auto
+- glaf4_dev_version: 0.3.0
+```
+
+## 4. DP-4 委托方案确认（v2.1 §6.6）
+
+先走 S1 执行模式选择（v2.1 §6.6），选 `glaf4-delegation` 产单 wave 计划：
+
+```bash
+# 0. 选模式（DP-4 决策门；单 wave = 委托 glaf4-dev 完成 change）
+tf execution plan <change-dir> --mode glaf4-delegation --wave w1:serial:delegate --confirm --reason "<委托理由>"
+```
+
+模式选定后，确认 5 项并写状态：
+
+```bash
+# 1. 写 write-set.json（边界文件清单）+ dp_4_glaf4_mode + dp_4_write_set_hash
+tf glaf4-delegation confirm <change-dir> --mode FEATURE_TDD --write-set <write-set.json>
+
+# 2. 置 delegation_status（委托进行中）
+tf state set <change-dir> delegation_status in_progress
+```
+
+5 项确认：① change→mode 映射 ② write_set_boundary ③ 串行特征 ④ 两级门预期 ⑤ 授权委托。
+`dp_4_glaf4_mode` 入 state；`dp_4_write_set_boundary`（文件清单）不落 state YAML（writeState 硬编码字段列表 +
+parseYaml 仅标量），落 `.superpowers/glaf4/write-set.json`，state 只存 `dp_4_write_set_hash` 引用 hash。
+`dp_4_result` 由 `tf execution plan --confirm` 程序化写入，手工 set 会被覆写。
+
+## 5. 委托 run 后对账（v2.1 §6.3）
+
+```bash
+# write-set 对账（门禁级 FAIL，阻断 closing）
+tf glaf4-delegation verify-write-set <change-dir> --run-dir <run-dir>
+
+# task 完成度审计（WARN，人工核对）
+tf glaf4-delegation verify-tasks <change-dir>
+```
+
+允许集（change 边界之外允许写入）：pom.xml/build.gradle、src/test/java/**、src/test/resources/**、
+.glaf4-dev/runs/**、test-environment.json。这是唯一约束 change 边界的机械机制。
+
+## 6. 委托失败恢复（v2.1 §6.7）
+
+- delegation_status=failed → guard 阻断 closing 直到人工重置（三选一）
+- ① 重试（retry_count 封顶 3，达上限禁止继续重试）② 降级（reset 删 plan 重走 DP-4）③ 标记阻塞转人工
+- 环境错误（environment_error=true）直接转 ②/③，不浪费重试
+- BLOCKED 残留 partial writes：`tf glaf4-delegation record-partial <change-dir> --run-dir <run-dir>` 落 `delegation_partial_writes` 清单，人工核对从"扫盘"降为"确认清单"
+
+## 7. 骨架矩阵先行时序（v2.1 §5，I6 固化防 H1 死锁复发）
+
+**顺序写死，不可颠倒**——否则骨架矩阵缺失 → GLAF4 change 进不了 executing（原 H1 死锁复发）：
+
+```
+bridging：contract-builder 产非空骨架矩阵 test-matrix.md（过 test-matrix-ready 入口门）
+  → tf state rebuild（捕获骨架矩阵 hash）
+  → 委托 run（glaf4-dev 七模式流）
+  → run 终局 → 矩阵回灌覆盖骨架（test-matrix-export v2 转 MD）
+  → tf state rebuild（过 test-matrix-complete 出口门）
+```
+
+## 8. closing 时序协议（v2.1 §6.3，I5 固化防 plan 过期卡死）
+
+**顺序不可乱**——tasks.md 翻转/矩阵回灌改变 artifacts_hash → plan 过期（receipt 失效）；必须先 refresh-hash 再记录 review：
+
+```
+run 终局 PASS
+  → 矩阵回灌（test-matrix-export v2 + 覆盖 test-matrix.md）
+  → tf state rebuild（只改 state 文件，不动 plan JSON）
+  → tf execution refresh-hash（更新 plan.artifacts_hash，防 plan 过期）
+  → 委托代理 commit glaf4-dev 产物
+  → code-reviewer 独立审查 base..head（报告落 .superpowers/sdd/reviews/）
+  → tf execution review --wave w1 --verdict pass
+  → tf glaf4-delegation verify-write-set（门禁级对账，FAIL 阻断）
+  → tf state set delegation_status success
+  → tf state transition ... closing
+```
+
+> `tf state rebuild` 不能替代 `refresh-hash`（前者不动 plan JSON）；review 需真实 git base≠head，必须 commit 后取 SHA。

package/skills/workflow-start/SKILL.md

@@ -88,7 +88,7 @@ Full protocol in `references/routing-rules.md`「Route to architecture-design」
 Guard: `tf runtime guard check <dir> exploring specifying --json` → fail = BLOCK. **arch_design_decision must not be null** → fail = BLOCK (v0.9 §26). User knows what they want, artifacts missing/incomplete.
 
 ### Route to contract-builder (dispatch sub-agent)
-Guard: `... check <dir> specifying bridging --json` → fail = BLOCK. Artifacts exist, implementation requested, contract missing/stale. Include `DP-3: 契约批准`. **full workflow 必产 test-matrix.md（v0.13 §52 B1）**：契约 `## Test Matrix` 段 + 非空矩阵文件 + `tf state rebuild` 捕获 hash；确无测试需求只能显式 skip + 理由（`test_matrix_skipped=true` + `test_matrix_skip_reason`）。GLAF4 Java 项目矩阵生成的工具选择见 `references/routing-rules.md`「Route to glaf4-tests」。
+Guard: `... check <dir> specifying bridging --json` → fail = BLOCK. Artifacts exist, implementation requested, contract missing/stale. Include `DP-3: 契约批准`. **full workflow 必产 test-matrix.md（v0.13 §52 B1）**：契约 `## Test Matrix` 段 + 非空矩阵文件 + `tf state rebuild` 捕获 hash；确无测试需求只能显式 skip + 理由（`test_matrix_skipped=true` + `test_matrix_skip_reason`）。GLAF4 Java 项目实施委托（glaf4-dev）与矩阵工具选择见 `references/routing-rules.md`「Route to glaf4-dev 实施委托」。
 
 ### Route to build-executor (dispatch sub-agent)
 Contract exists and approved, contract matches artifacts. Include `DP-4: 执行模式选择`: propose waves, run `tf execution recommend <change-dir> [--wave ...]`, show the user every available mode plus evidence and the recommendation, then obtain a clear selection. The command saves a current receipt; before the first implementation edit, `build-executor` must run `tf execution plan <change-dir> --mode <selected> --confirm ...` (and `--acknowledge-recommendation` when the selected mode differs from the recommendation) using matching artifacts, contract, and waves, then `tf execution show <change-dir> --json`; report the saved revision, selected mode, recommendation alignment, ordered waves, and actual concurrent-dispatch capability. A revision must repeat recommend and confirmation. Do not transition to `executing` until `show` reports `current: true`; then run `... check <dir> approved-for-build executing --json` → fail = BLOCK. **v0.13 §49 门禁前移**：该 guard 含 `test-matrix-ready` 维度——full 模式非存量 change 必须"带着矩阵开工"（矩阵存在非空 OR 显式 skip 附理由）；FAIL 时回 bridging 让 contract-builder 补矩阵，或按指引显式 skip，禁止绕过。

package/skills/workflow-start/references/routing-rules.md

@@ -313,23 +313,23 @@ Inference: **hotfix** (≤2 tasks, ≤2 files, no schema/API/new modules), **twe
 ## Post-transition
 💡 `tf inject <change-dir>` to update phase-guard artifacts.
 
-## Route to glaf4-tests (v0.12 §46, v0.31.0, v0.13 §52 B3 归位)
+## Route to glaf4-dev 实施委托 (v0.12 §46, v0.31.0, v0.13 §52 B3 归位; v2.1 §1.3 统一到 glaf4-dev)
 
-**归位说明（v0.13）**：本段的触发主体是 **bridging 阶段的 contract-builder 子代理**（矩阵生成者），workflow-start 主路由表不包含 glaf4-tests 条目——放在本文件仅作 bridging 期参考。
+**归位说明**：本段的触发主体是 **bridging 阶段的 contract-builder 子代理**（矩阵生成者 + GLAF4 Delegation 段产出者）。glaf4-test 已统一到 glaf4-dev（v2.1 §1.3），矩阵设计委托改为 glaf4-dev 实施委托全链路。
 
-**强制性澄清（v0.13 §52 B1）**：full workflow 生成 test-matrix.md 本身是**必选动作**（`test-matrix-ready`/`test-matrix-complete` 门禁强制）；**可选的是工具选择**——GLAF4 Java 项目可选用 glaf4-tests 流水线做精细矩阵设计，非 GLAF4 项目用内置 test-strategy skill。两条路都必须产出非空 `test-matrix.md` + contract `## Test Matrix` 段 + `tf state rebuild`。
+**强制性澄清（v0.13 §52 B1 + v2.1）**：full workflow 生成 test-matrix.md 本身是**必选动作**（`test-matrix-ready`/`test-matrix-complete` 门禁强制）；GLAF4 Java change 走 glaf4-dev 实施委托（生产+测试整体委托七模式流），team-flow 矩阵骨架定位为**审计基线**（回灌后对比 vNext 覆盖）。
 
-**触发条件**：`project_type == glaf4-java`（Spring Boot / JUnit 5 / Mockito）。
+**触发条件**：`project_type == glaf4-java`（pom.xml/build.gradle + Spring Boot/JUnit5/Mockito）∧ glaf4-dev 插件可用（运行时探测 delegation_mode ≠ off）。
 
 **协议**：
-1. contract-builder 检测项目技术栈（读取 `pom.xml` / `build.gradle` 判断是否 GLAF4 Java）
-2. GLAF4 项目 → 提示用户：「检测到 GLAF4 Java 项目，是否调用 `glaf4-test:glaf4-tests` 做精细测试矩阵设计？」
-3. 用户同意 → 调用 `glaf4-test:glaf4-tests-design` 生成 `test-matrix.json`
-4. `glaf4-tests-validate` 校验矩阵完整性
-5. `tf test-matrix-export <test-matrix.json> <change-dir>/test-matrix.md` 转换为 team-flow 格式
-6. 用户确认（轻量版 DP-A）
-7. contract 中添加 `## Test Matrix` 段引用 + `tf state rebuild` 捕获 test_matrix_hash
+1. contract-builder 运行时探测（`detectGlaf4Delegation`，v2.1 §4）
+2. 命中 GLAF4 Java → 产出 `## GLAF4 Delegation` 段（mode + write_set_boundary + 权限位，v2.1 §6.1/§6.2），**实施委托交接**——完整协议见 contract-builder `references/glaf4-delegation.md`
+3. 委托 run 回灌 → `tf test-matrix-export`（v2，支持 vNext）转 team-flow 12 列 MD 作为**审计基线**（v2.1 §5）
+4. 证据回灌：`tf glaf4-evidence-export` → `tf test record --from`（v2.1 §7）
+5. `tf glaf4-delegation confirm`（DP-4 委托确认 5 项）+ `verify-write-set`/`verify-tasks`（双层对账，v2.1 §6.3/§6.6）
+
+**混合栈串行承接（v2.1 §6.8，L1 明确）**：委托仅限 Java 文件边界（src/main/**、src/test/** 的 Java 面）；change 内非 Java 文件（SQL DDL / src/main/resources / 前端）由 build-executor 在委托 run 终局后、closing 前**串行承接**（S1 单 wave 计划不新增 wave）。这是与 glaf4-dev 租约模型唯一兼容的选项——委托 run 期间主线程零写入，非 Java 承接必须在 run 终局释放租约后。
 
 **非 GLAF4 项目**：contract-builder 使用预加载的 test-strategy skill 直接生成 `test-matrix.md`（同等强制）。
 
-**用户拒绝 glaf4-tests 时**：回退内置 test-strategy 生成（不是跳过矩阵）。确无测试需求的特例走显式 skip + 理由。
+**委托不可用（glaf4-dev 未装 / delegation_mode=off / 用户拒绝）**：回退 build-executor 实施 + 内置 test-strategy 生成矩阵（不是跳过矩阵）。**两类 skip 区分**：① 委托路径（glaf4-delegation 模式）矩阵是审计基线，`test_matrix_skipped` 被禁止（v2.1 §6.3 skip 禁令，唯一例外 TEST_BOOTSTRAP 零测试）；② 非委托路径确无测试需求（纯文档/纯配置）才走显式 skip + 理由（v0.13 §48.2 可审计豁免）。

package/templates/execution-contract.md

@@ -69,13 +69,25 @@ wave 才可以开始。`parallel` 只表示允许在宿主支持并发派发时
 ## Execution Mode
 
 - **可用方式与推荐**：`tf execution recommend <change-dir> [--wave <id>:<parallel|serial>:<task,...>[:<depends-on,...>]]`
-- **用户确认的模式**：`sdd` | `inline` | `batch-inline`
+- **用户确认的模式**：`sdd` | `inline` | `batch-inline` | `glaf4-delegation`
 - **推荐理由 / 项目事实**：
 - **非推荐选择的风险确认**：`--acknowledge-recommendation`（若适用）
 - **执行计划命令**：`tf execution plan <change-dir> --mode <mode> --confirm --reason <text> --wave <id>:<parallel|serial>:<task,...>[:<depends-on,...>] [--acknowledge-recommendation]`
 - **允许的修订**：将已有计划保留/升级为 `sdd`；先重新 recommend，并以 `--confirm` 生成新 revision 和清除旧 receipt；不允许降级：`tf execution revise <change-dir> --mode sdd --confirm --reason <text> --wave <id>:<parallel|serial>:<task,...>[:<depends-on,...>] [--acknowledge-recommendation]`
 - **计划 revision / artifact hash**：
 
+## GLAF4 Delegation（v2.1 §6.1/§6.2，GLAF4 Java change 实施委托时填写）
+
+> 运行时探测（`tf glaf4-delegation detect <root>`）命中 GLAF4 Java 且 glaf4-dev 可用时产出本段。write_set_boundary 权威源 = 本段；机械对账读 `.superpowers/glaf4/write-set.json`（`tf glaf4-delegation confirm` 写入）。
+
+- mode: FEATURE_TDD | BUGFIX_REGRESSION | REFACTOR_PROTECTED | COMPLETE_UNIT_TESTS | COMPLETE_INTEGRATION_TESTS | TEST_BOOTSTRAP
+- permission: after-red | none(test-only) | allowed+baseline_green_required
+- write_set_boundary:
+  - <相对 target_root 的 Java 文件路径，如 src/main/java/com/example/OrderService.java>
+- target_root: <工程根绝对路径>
+- delegation_mode: auto | manual | off
+- glaf4_dev_version: <运行时探测的插件版本，如 0.3.0>
+
 ## Verification Dimensions
 
 | 维度 | 状态 | 发现 |