@hunter-harness/workflow-harness 0.4.8 → 0.4.9

package/harness/bundles/general/claude-code/harness-review/checklist.md

@@ -8,7 +8,7 @@ description: harness-review 的6维度审查检查项详细列表。仅在执行
 
 用 Glob 搜索 `.harness/changes/*/plans/*-plan.md`（**排除 `.harness/archive/*/`**），读取 frontmatter 提取 `change-name`。默认最多一个未归档变更；如有多个，优先取最近修改的，或询问用户。后续所有路径基于此变更名。
 
-**读取 worktree 状态**：读 `.harness/changes/<change-name>/meta/worktree.json`。`requested=true` 且 worktree 已创建 → 后续 `git diff` 的 `<项目路径>` 用 worktree 路径（`.worktrees/<change-name>`）；`requested=true` 但 worktree 不存在 → 停止，提示先修复 `harness-run`，不得静默回主目录。
+**读取 worktree 状态**：读 `.harness/changes/<change-name>/meta/worktree.json`。`requested=true` 且 worktree 已创建 → 后续 `git diff` 的 `<项目路径>` 用 worktree 路径（`.worktrees/<change-name>`）；`requested=true` 但 worktree 不存在 → 停止，提示先修复 `harness-execute`，不得静默回主目录。
 
 ## 审查流程
 

package/harness/bundles/general/claude-code/harness-submit/SKILL.md

@@ -21,7 +21,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=3c6eec08da6f5a5c; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=8aa1d6994e1d3d22; overlay=none; agent=claude-code; do not edit -->
 # harness-submit — 最终提交（含 worktree 合并）
 
 ## Purpose

package/harness/bundles/general/claude-code/harness-submit/checklist.md

@@ -33,7 +33,7 @@ description: harness-submit 的8 步工作流详细步骤和执行日志记录
 1. 通过 state layout resolver 读取权威 `evidence/verification-ledger.json`，记录 `diffHash` / `currentHead` / `unitTest` / `apiTest` 状态；split-v1 不得回退复制到 contract 目录
 2. 执行 `harness_ledger.py diff-hash --repo . --base <baseCommit> --change-dir ".harness/changes/<change-name>" --json` 计算当前 diffHash；manifest 校验失败即停止，不得绕过后与 ledger 比对
 3. 若 test 之后有代码变更（当前 diffHash ≠ test 完成时的 diffHash），按 7 类对 post-test diff 分类（见 `../protocols/ledger-protocol.md` 第六章），写入 ledger 的 `postTestClassification`
-4. 行为性变更（BEHAVIORAL_SERVICE_CHANGE / API_CONTRACT_CHANGE / SQL_OR_MAPPER_CHANGE / SECURITY_OR_PERMISSION_CHANGE）→ **停止 submit**，提示先重跑 `/harness-test` 相关场景
+4. 行为性变更（BEHAVIORAL_SERVICE_CHANGE / API_CONTRACT_CHANGE / SQL_OR_MAPPER_CHANGE / SECURITY_OR_PERMISSION_CHANGE）→ **停止 submit**，提示先重跑 `/harness-execute` 相关场景
 5. 非行为性变更（NON_BEHAVIORAL_CLEANUP / COMMENT_ONLY / TEST_ONLY）→ 可继续 submit，但后续验证按复用规则处理
 
 **append `phase.start` 事件**（`harness_events.py append`；`note` 含 ledger diffHash、post-test 分类、验证策略）：

package/harness/bundles/general/claude-code/harness-submit/reference.md

@@ -136,7 +136,7 @@ powershell.exe -NoProfile -Command "git -C '<项目路径>' log HEAD..@{u} --one
    powershell.exe -Command "[System.IO.Directory]::Delete('<worktree-path>', $true)"
    ```
 
-4. **ExitWorktree 工具限制**：`ExitWorktree(remove)` 只删由 `EnterWorktree` 创建的 worktree。若本会话进入的是已存在 worktree（由 `harness-run` 创建），工具会拒绝删除。此时用 `action:keep` 返回主仓库，再按上述 1-3 步手动清理。
+4. **ExitWorktree 工具限制**：`ExitWorktree(remove)` 只删由 `EnterWorktree` 创建的 worktree。若本会话进入的是已存在 worktree（由 `harness-execute` 创建），工具会拒绝删除。此时用 `action:keep` 返回主仓库，再按上述 1-3 步手动清理。
 
 5. **清理后更新 `meta/worktree.json`**：置 `created=false` + 追加 `removedAt`/`removedBy`/`removalNote`，记录产出保留待 `/harness-archive`。
 

package/harness/bundles/general/claude-code/harness-sync/SKILL.md

@@ -19,7 +19,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=3c6eec08da6f5a5c; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=8aa1d6994e1d3d22; overlay=none; agent=claude-code; do not edit -->
 # harness-sync
 
 ## Purpose

package/harness/bundles/general/claude-code/protocols/evidence-based-reporting-protocol.md

@@ -42,7 +42,7 @@ description: harness 全流程的证据化报告协议。所有 skill 输出必
 | 情况 | 状态标记 | 报告表述 |
 |------|:--------:|----------|
 | 测试命令输出包含测试通过证据（Java=`Tests run: N, Failures: 0`；前端/Python 按各自工具） | ✅ | ✅ 已测试通过：N 个用例，0 失败 |
-| TDD 降级（无测试基础设施） | 🟡 | 🟡 静态验证通过，未执行真实单元测试，待测试基础设施补齐后运行 harness-test |
+| TDD 降级（无测试基础设施） | 🟡 | 🟡 静态验证通过，未执行真实单元测试，待测试基础设施补齐后运行 harness-execute |
 | 测试命令被 hook 拒绝 | ❌ | ❌ 测试命令被拒绝，无法确认测试结果 |
 | 测试失败（有 Failures > 0） | ❌ | ❌ 测试失败：N 个用例，M 个失败 |
 | 用户确认跳过测试 | 🟡 | 🟡 用户确认跳过测试 |

package/harness/bundles/general/claude-code/protocols/ledger-protocol.md

@@ -4,7 +4,7 @@ description: verification-ledger、diffHash、service-fingerprint 的统一协
 
 # Ledger Protocol
 
-> 本协议被 harness-plan / harness-run / harness-test / harness-submit / harness-archive 共同引用。
+> 本协议被 harness-plan / harness-execute / harness-execute / harness-submit / harness-archive 共同引用。
 > 目标：消除跨阶段重复编译/测试，让每个"✅ 已验证"结论可追溯、可复用，避免 post-test 小改动导致前序报告有效性表达不清。
 
 ## 一、为什么需要 verification-ledger
@@ -156,7 +156,7 @@ verification-ledger 把每次验证（compile / unit test / api test / package
   "moduleInputsHash": "sha256:<依赖闭包内容指纹>",
   "moduleInputsFiles": ["<project>/Svc.java", "..."],
   "profile": "local-dev-remote-sdk",
-  "overlayPath": "C:/temp/harness-test-overlay/<change>/application-harness-test.yml",
+  "overlayPath": "C:/temp/harness-execute-overlay/<change>/application-harness-execute.yml",
   "startCommandHash": "sha256:<command 指纹>",
   "command": "<serviceStart.command>",
   "startedAt": "..."
@@ -165,7 +165,7 @@ verification-ledger 把每次验证（compile / unit test / api test / package
 
 `moduleInputsHash` 由 CLI `--files` ∪ `build-profile.json` 的 `serviceStart.inputFiles`（glob 列表，相对 project 展开）计算。**空输入被拒绝**（exit 非 0），不得生成可复用的空指纹（§5.1/§5.2）。
 
-复用必须**同时**满足（§5.3）：`moduleInputsHash` 一致、`startCommandHash` 一致、`profile` 一致、`overlayPath` 一致、进程身份（pid 存活 + create time 匹配 `startedAt`）可确认。任一变化 -> AI 自动 restart；身份无法确认 -> `needs-user-decision`；非 AI 用户进程永不自动 kill。否则必须进入 Service Decision Gate（见 harness-test）。
+复用必须**同时**满足（§5.3）：`moduleInputsHash` 一致、`startCommandHash` 一致、`profile` 一致、`overlayPath` 一致、进程身份（pid 存活 + create time 匹配 `startedAt`）可确认。任一变化 -> AI 自动 restart；身份无法确认 -> `needs-user-decision`；非 AI 用户进程永不自动 kill。否则必须进入 Service Decision Gate（见 harness-execute）。
 
 ### 4.2 unitTestFull 最终全量门禁
 
@@ -216,13 +216,13 @@ harness_ledger.py diff-hash --repo <projectRoot> --base <baseCommit> --change-di
 - manifest 存在时必须严格验证 schema/mode/projectRoot、精确相对路径、文件存在性与 SHA-256；结构非法、路径越界或 hash 漂移均非零退出，旧 ledger 不得复用。
 - ignored test 在 checkpoint 前由 manifest 加入内容集；经 guard force-stage/commit 后由 Git diff 加入同一路径，集合去重，因此 hash 保持不变。
 - diffHash 只用于"内容是否变化"判断，不等于 commit hash
-- 账本中 `currentHead`（验证时 HEAD）与 `diffHash` 分开记录；reuse 规则 #2 允许 HEAD 前移（如 harness-run Step 5 checkpoint commit），因 diffHash 已 commit-invariant，HEAD 前移不改变指纹
+- 账本中 `currentHead`（验证时 HEAD）与 `diffHash` 分开记录；reuse 规则 #2 允许 HEAD 前移（如 harness-execute Step 5 checkpoint commit），因 diffHash 已 commit-invariant，HEAD 前移不改变指纹
 - **禁止**使用类似 `3files-84plus-5minus` 的描述性字符串作为复用依据
 - **禁止**删除/忽略 test-tracking manifest 后继续复用，也禁止用手写 Git/Node/PowerShell hash 替代 canonical 命令。
 
 ## 六、Post-test 变更分类
 
-当 `/harness-test` 完成后又发生代码变更（常见于 review 后清理、submit 前发现的小问题），后续 submit/package/archive **必须先对变更做分类**，写入 ledger 的 `postTestClassification`：
+当 `/harness-execute` 完成后又发生代码变更（常见于 review 后清理、submit 前发现的小问题），后续 submit/package/archive **必须先对变更做分类**，写入 ledger 的 `postTestClassification`：
 
 | 类型 | 示例 | 是否需要重跑 API | 是否需要重跑 unit | 是否需要重 compile |
 |------|------|:---:|:---:|:---:|
@@ -245,15 +245,15 @@ post-test 变更: NON_BEHAVIORAL_CLEANUP
 API 测试: 🔁 复用上一轮结果（diffHash 未变 / 仅清理性变更）
 ```
 
-**行为性变更**：必须重新运行 `/harness-test` 的相关场景（至少覆盖变更影响的接口/权限/SQL），ledger 对应项作废并重写。
+**行为性变更**：必须重新运行 `/harness-execute` 的相关场景（至少覆盖变更影响的接口/权限/SQL），ledger 对应项作废并重写。
 
 ## 七、各阶段与 ledger 的交互
 
 | 阶段 | 读 ledger | 写 ledger |
 |------|:---:|:---:|
 | harness-plan | 计划起点读（了解前序变更状态/已有 ledger，作为复用链起点） | 计划落定后写初始 ledger（changeName/module/profile/baseCommit/diffHash 占位） |
-| harness-run | 步骤 2 前读（确认是否已有 compile/unitTest 可复用） | 步骤 2 后写 compile + unitTest（若跑了全量测试） |
-| harness-test | Phase 1 前读（复用 run 的 unitTest） | Phase 1/2 后写 unitTest + apiTest |
+| harness-execute | 步骤 2 前读（确认是否已有 compile/unitTest 可复用） | 步骤 2 后写 compile + unitTest（若跑了全量测试） |
+| harness-execute | Phase 1 前读（复用 run 的 unitTest） | Phase 1/2 后写 unitTest + apiTest |
 | harness-submit | 验证前读（复用 test 的 compile/unitTest） | 若重跑则写回 |
 | harness-archive | 归档前读（汇总各阶段状态，写入 `summary-data.json` 并上传平台） | 不写（归档时一并移入 archive） |
 

package/harness/bundles/general/claude-code/protocols/sensitive-info-protocol.md

@@ -98,13 +98,13 @@ spring:
 > `HUNTER_HARNESS_SENSITIVE_SCAN=block` 才恢复阻断、`=off` 完全关闭。
 > 门禁放行不等于内容可以带明文凭据——本节的要求始终成立。
 
-profile `build-profile.json`、规则文档、Skill Markdown **不得包含凭据明文值**（spec §3.4 凭据边界：配置只含 env key、cache path、角色，不含值）。发布前用 `harness-test/scripts/runtime-helpers.mjs` 的 `findCredentialValues(text)` 扫描：
+profile `build-profile.json`、规则文档、Skill Markdown **不得包含凭据明文值**（spec §3.4 凭据边界：配置只含 env key、cache path、角色，不含值）。发布前用 `harness-execute/scripts/runtime-helpers.mjs` 的 `findCredentialValues(text)` 扫描：
 
 - 命中 `password/token/secret/accessKey/Authorization: Bearer/jdbc password=` 等明文值 → ❌FAIL，必须改为占位符 `<*_REDACTED>` 或 env 引用 `${ENV}` / `$ENV`。
 - 占位符 `<TOKEN_REDACTED>` 与 env 引用 `${TEST_TOKEN}` / `$DB_PASSWORD` 不报（credential 配置允许 env key）。
 
 ```js
-import { findCredentialValues } from '<skills-root>/harness-test/scripts/runtime-helpers.mjs';
+import { findCredentialValues } from '<skills-root>/harness-execute/scripts/runtime-helpers.mjs';
 const findings = findCredentialValues(fs.readFileSync('build-profile.json', 'utf8'));
 if (findings.length > 0) { /* ❌FAIL: 列出 line/code/snippet，改为 env key 或占位符 */ }
 ```

package/harness/bundles/general/claude-code/scripts/harness_deploy.py

@@ -479,10 +479,10 @@ def copy_overlay_extras(overlay_dir: Path, out_dir: Path) -> list[str]:
     # it must NOT be installed to runtime. Only pitfalls-java.md is runtime.
     pitfalls = overlay_dir / "pitfalls-java.md"
     if pitfalls.is_file():
-        test_pit = out_dir / "harness-test" / "pitfalls-java.md"
+        test_pit = out_dir / "harness-execute" / "testing-pitfalls-java.md"
         test_pit.parent.mkdir(parents=True, exist_ok=True)
         shutil.copy2(pitfalls, test_pit)
-        extras.append("harness-test/pitfalls-java.md")
+        extras.append("harness-execute/testing-pitfalls-java.md")
     return extras
 
 

package/harness/bundles/general/claude-code/scripts/harness_gate.py

@@ -2220,7 +2220,7 @@ def _validate_scenario_coverage(
     is due by that phase are required to carry passing receipts. Scenarios
     owned by a later phase (e.g. `ownerPhase=test` at `run` close) are
     reported under `deferred` instead of blocking the close — this matches the
-    documented hand-off rule in harness-run/SKILL.md ("ownerPhase=test 按计划移交").
+    documented hand-off rule in harness-execute/SKILL.md ("ownerPhase=test 按计划移交").
     """
     manifest_path = change_dir / "meta" / "scenario-manifest.json"
     if not manifest_path.is_file():

package/harness/bundles/general/claude-code/scripts/harness_profile.py

@@ -854,13 +854,13 @@ def _node_commands(project: Path) -> dict[str, Any]:
         "apps/*/tests/**/*.tsx",
     ]
     # harness dogfood: canonical Python + .mjs sources feed npm run check (vitest
-    # imports harness-test/scripts; smoke:pack runs sync-harness.mjs).
+    # imports harness-execute/scripts; smoke:pack runs sync-harness.mjs).
     if (project / "harness").is_dir():
         inputs.extend(
             [
                 "harness/scripts/*.py",
-                "harness/harness-test/scripts/*.mjs",
-                "harness/harness-test/scripts/tests/*.mjs",
+                "harness/harness-execute/scripts/*.mjs",
+                "harness/harness-execute/scripts/tests/*.mjs",
                 "scripts/*.mjs",
             ]
         )

package/harness/bundles/general/codebuddy/.harness-build.json

@@ -2,5 +2,5 @@
   "schemaVersion": 1,
   "overlay": "none",
   "agent": "codebuddy",
-  "coreHash": "3c6eec08da6f5a5c"
+  "coreHash": "8aa1d6994e1d3d22"
 }

package/harness/bundles/general/codebuddy/CONTEXT.md

@@ -17,7 +17,7 @@ _Avoid_: 外部依赖, 必需插件
 _Avoid_: 运行时增强, 降级分支, 硬依赖
 
 **变更簇**:
-围绕同一业务行为或同一验证目标的一组任务。变更簇是 `/harness-run` 执行 RED→GREEN→REFACTOR 的基本单位。
+围绕同一业务行为或同一验证目标的一组任务。变更簇是 `/harness-execute` 执行 RED→GREEN→REFACTOR 的基本单位。
 _Avoid_: 小任务, 单步任务
 
 **自适应执行参考**:

package/harness/bundles/general/codebuddy/README.md

@@ -4,7 +4,7 @@
 
 本包为通用 harness-skills，技术栈无关：构建/测试/打包命令按目标项目技术栈解析（Java=Maven、前端=npm、Python=pytest 等，详见项目 CLAUDE.md 或 `.harness/config/`）。文中 Java/Maven、Mapper/Controller/VO、Spring Boot、jar/war 等措辞仅为示例，不影响流程骨架的通用性。
 
-环境、CodeGraph 等外部增强检查应在 `npx hunter-harness` 初始化阶段完成。Superpowers / grill-me 等外部技能只作为方法论来源与人工参考；`harness-plan`、`harness-run`、`harness-review` 已内化关键能力，不再运行时依赖外部 skill。
+环境、CodeGraph 等外部增强检查应在 `npx hunter-harness` 初始化阶段完成。Superpowers / grill-me 等外部技能只作为方法论来源与人工参考；`harness-plan`、`harness-execute`、`harness-review` 已内化关键能力，不再运行时依赖外部 skill。
 
 
 > 一套完整的 AI 辅助开发 Skill，覆盖从上下文同步到代码提交的全流程。
@@ -49,10 +49,9 @@
 | Skill | allowed-tools | disallowed-tools |
 |-------|---------------|------------------|
 | harness-plan | `[Read, Glob, Grep, Edit, Write, Agent, Bash(powershell.exe:*)]` | `Bash(git *)`, `Bash(mvn *)`, 等 14 项普通 Bash 命令 |
-| harness-run | `[Read, Edit, Write, Glob, Grep, Bash(powershell.exe:*)]` | 同上 |
+| harness-execute | `[Read, Edit, Write, Glob, Grep, Agent, Bash(powershell.exe:*)]` | 同上 + `Bash(node *)` |
 | harness-submit | `[Bash(powershell.exe:*), Read, Write, Edit, Glob, Grep]` | 同上 |
 | harness-archive | `[Read, Edit, Write, Glob, Grep, Bash(powershell.exe:*)]` | 同上 |
-| harness-test | `[Read, Glob, Grep, Write, Edit, Agent, Bash(powershell.exe:*)]` | 同上 + `Bash(node *)` |
 | harness-review | `[Read, Write, Edit, Glob, Grep, Agent, Bash(powershell.exe:*)]` | 同上 |
 | harness-sync | `[Read, Glob, Grep, Edit, Write, Bash(powershell.exe:*)]` | 同上 |
 | harness-codebase-map | `[Read, Glob, Grep, Write, Edit, Agent, Bash(powershell.exe:*)]` | 同上 |
@@ -103,18 +102,18 @@
 │   │   └── <change-name>-test-scenarios.md    # 测试场景表（4维度覆盖）
 │   ├── evidence/                    # 验证证据
 │   │   ├── verification-ledger.json # 验证账本（compile/unit/api 可复用结果）
-│   │   └── run-task-status.md       # 任务执行状态（harness-run 持久化产出）
+│   │   └── run-task-status.md       # 任务执行状态（harness-execute 持久化产出）
 │   ├── reports/                     # 报告
 │   │   ├── test/
-│   │   │   └── test-report-YYYYMMDD-HHmm.md  # harness-test 产出（时间戳区分多次运行）
+│   │   │   └── test-report-YYYYMMDD-HHmm.md  # harness-execute 产出（时间戳区分多次运行）
 │   │   └── review/
 │   │       ├── review-report-YYYYMMDD-HHmm.md  # harness-review 产出（时间戳区分多次运行）
 │   │       └── fixback-YYYYMMDD-HHmm.md        # RED/YELLOW 修复反馈（按需）
 │   ├── sqls/
-│   │   └── V<version>__<desc>.sql   # 数据库迁移脚本（harness-run 产出）
+│   │   └── V<version>__<desc>.sql   # 数据库迁移脚本（harness-execute 产出）
 │   ├── scripts/                     # 固定脚本和本次运行脚本
 │   ├── runtime/                     # 运行时临时文件（不提交）
-│   │   ├── api-test-runner.mjs      # 接口测试执行器脚本（harness-test 产出）
+│   │   ├── api-test-runner.mjs      # 接口测试执行器脚本（harness-execute 产出）
 │   │   ├── api-test-results.json    # runner 输出的结构化结果
 │   │   └── credential-cache.json    # 认证凭证缓存（旧名 token-cache.json 兼容读取）
 │   └── backups/
@@ -186,16 +185,16 @@ harness-skills/
 │   ├── checklist.md            # 阶段检查清单
 │   ├── protocols.md            # 原生澄清/有限盘问/任务拆分协议
 │   └── reference.md            # 详细模板和规则
-├── harness-run/
-│   ├── SKILL.md                # TDD 编码循环
-│   ├── checklist.md            # 编码步骤检查清单
+├── harness-execute/
+│   ├── SKILL.md                # execute 阶段：编码（变更簇 TDD）+ 验证（单元/接口/兼容）
 │   ├── protocols.md            # 原生 TDD / 变更簇审查协议
-│   └── reference.md            # 编译失败策略 + TDD 降级 + 编码约束
-├── harness-test/
-│   ├── SKILL.md                # 测试执行 + 避坑规则索引
-│   ├── checklist.md            # Phase 0 环境准备 7 项检查
-│   ├── reference.md            # API 测试细节 + 响应验证
-│   └── pitfalls.md             # 30 条避坑规则（详细说明）
+│   ├── coding-reference.md     # 编译失败策略 + TDD 降级 + 编码约束
+│   ├── coding-checklist.md     # 编码步骤检查清单
+│   ├── testing-reference.md    # API 测试细节 + 响应验证 + 执行器模板
+│   ├── testing-checklist.md    # Phase 0 环境准备 7 项检查
+│   ├── testing-pitfalls.md     # 30 条避坑规则（详细说明）
+│   ├── testing-pitfalls-java.md # Java 专项避坑（java profile 由 overlay 覆盖）
+│   └── scripts/                # runtime-helpers.mjs（BOM-safe JSON 等运行时辅助）
 ├── harness-review/
 │   ├── SKILL.md                # 6 维度代码审查
 │   ├── checklist.md            # 6 维度详细检查项
@@ -220,15 +219,14 @@ harness-skills/
 | harness-sync | `/harness-sync` | 10 项元数据检查（7 核心 + 3 辅助） | 初始化检查 | ✅ | 控制台报告 + 自动更新 |
 | harness-codebase-map | `/harness-codebase-map` | 生成代码库地图（7 类文档 + summary + manifest） | `sync`/独立 | ✅ | `.harness/codebase/map/` |
 | harness-plan | `/harness-plan` | 需求→设计→任务拆分→**测试场景表** + 自动命名变更名 | `sync` | 手动 | `.harness/changes/<cn>/plans/` |
-| harness-run | `/harness-run` | TDD 循环 变更簇编码 | `plan` | 手动 | `.harness/changes/<cn>/sqls/` |
-| harness-test | `/harness-test` | 单元测试+接口测试+30条避坑 | `run` | 手动 | `.harness/changes/<cn>/reports/test/` |
-| harness-review | `/harness-review` | 6维度参考性审查（不阻塞后续流程） | `test` | 手动 | `.harness/changes/<cn>/reports/review/` |
+| harness-execute | `/harness-execute` | 变更簇 TDD 编码 + 单元/接口测试 + 数据兼容验证 | `plan` | 手动 | `.harness/changes/<cn>/sqls/`、`reports/test/` |
+| harness-review | `/harness-review` | 6维度参考性审查（不阻塞后续流程） | `execute` | 手动 | `.harness/changes/<cn>/reports/review/` |
 | harness-submit | `/harness-submit` 或 `/harness-merge`（别名） | commit+push（主目录）/ worktree：本地 commit→--no-ff 合并→push 主分支 | `review` | 手动 | ledger `mergeFinalHash` + 控制台报告 |
 | harness-archive | `/harness-archive` | 归档产出到 archive/YYYY-MM-DD-<cn>，释放工作区 | `submit` | 手动 | `.harness/archive/YYYY-MM-DD-<cn>/` |
 | harness-knowledge-query | `/harness-knowledge-query` | 只查询平台语义知识；无本地索引或离线回退 | 独立 | ✅ | CLI JSON（不落本地知识文件） |
 | harness-knowledge-ingest | `/harness-knowledge-ingest` | 确认归档 ZIP 已由平台保存、解包并 ingest | `archive` | ✅ | 服务端 package/knowledge 收据 |
 
-> 生命周期 skill（plan → run → test → review → submit → archive）为**手动触发**：单阶段结束后停止，不自动接续下一阶段（已设 `disable-model-invocation`）。sync / codebase-map / knowledge 等辅助 skill 仍可按需被调用。`harness-run`、`harness-submit`、`harness-archive` 涉及 git 写操作、文件移动或归档，调用前必须确保前置条件已满足。
+> 生命周期 skill（plan → execute → review → submit → archive）为**手动触发**：单阶段结束后停止，不自动接续下一阶段（已设 `disable-model-invocation`）。2026-08 起 run+test 合并为 execute，0.4.9（workflow-harness）起 `/harness-run`、`/harness-test` 入口移除。sync / codebase-map / knowledge 等辅助 skill 仍可按需被调用。`harness-execute`、`harness-submit`、`harness-archive` 涉及 git 写操作、文件移动或归档，调用前必须确保前置条件已满足。
 > `<cn>` = change-name，由 harness-plan 阶段7确定。其他 skill 自动扫描未归档变更定位。
 > 门禁默认 `gate_severity_mode=lenient`（可再生 soft site → WARN）；发布阶段与 3 类硬不变量仍 fail-closed。可用 `HUNTER_HARNESS_GATE_MODE` 或 `gate-policy.json` 的 `severityMode` 强制 `strict`。
 
@@ -262,13 +260,13 @@ harness-skills/
 | **plan 阶段 3** | 默认主会话 CodeGraph/Read inline 探索；仅高复杂度且准备委派固定 agent 时单次预检，失败或无效返回立即 inline，不 retry |
 | **plan 阶段 4/6** | 原生规划协议必须记录风险/复用/替代方案/推荐方案/关键决策，以及任务拆分摘要 |
 | **plan 阶段 5** | 设计文档自审结果必须展示给用户；测试场景表未覆盖维度必须标记为 ⚠️ 缺口，不得全部 ✅ |
-| **run 步骤 0** | 任何代码修改前必须先向 `events.ndjson` 追加 `phase.start`；执行日志由阶段结束事件自动渲染 |
-| **run 轻量验证** | `/harness-run` 默认只做开发反馈：TDD RED/GREEN + REFACTOR + 构建命令增量编译（Java 的 `mvn compile -pl <module>` 等）+ 关门检查 + 写 verification-ledger；除非改了公共模块/数据访问层/sql/权限认证/接口层/数据契约 或用户要求 full-run-validation 或不打算继续 `/harness-test`，否则不默认跑全量测试命令（Java 的 `mvn test` 等）。若跑了全量测试必须写入 ledger 供 test/submit 复用 |
-| **run TDD 降级** | 输出必须写"🟡 静态逻辑验证通过，未执行真实单元测试"，**禁止写"测试全部通过"**；降级标注写在执行日志和覆盖报告中，**不污染业务代码注释**；记录三项：降级原因、静态验证场景列表、待部署后验证场景列表 |
-| **test ledger 复用** | Phase 1 单元测试前先读 `verification-ledger.json`：若 run 阶段已对同一 diffHash/module/profile 跑过单元测试命令（Java 的 `mvn test` 等）且测试通过（Java 的 `Tests run: N, Failures: 0, Errors: 0` / 前端 N passing），可跳过重跑并标记"✅ 复用 harness-run 单元测试结果"；diffHash 不一致 / profile 不一致 / 命令范围更窄 / run 后有行为性修改则不得复用 |
-| **test 批量 runner** | 默认使用 **PowerShell 接口测试执行器**：生成 `.harness/changes/<cn>/runtime/api-test-runner.mjs`，通过一次 PowerShell + node 执行全部场景，输出 `api-test-results.json`，主会话只读 JSON 生成摘要。Playwright MCP `browser_evaluate` 仅作 fallback，报告必须区分执行器：PowerShell 接口测试执行器 ✅使用 / PowerShell batch 🟡fallback / Playwright MCP 🟡fallback / curl 🟡fallback |
-| **test token 策略** | 先读 `.harness/changes/<cn>/runtime/credential-cache.json`（旧名 `token-cache.json` 兼容），本地轻量接口验证通过则复用，失败才访问远程 SSO；接口测试执行器必须用 request context / node fetch 直接请求本地 baseURL，**不得依赖浏览器当前页面 origin** |
-| **post-test 变更分类** | test 之后发生代码变更时，submit/archive 必须按 7 类分类（NON_BEHAVIORAL_CLEANUP / COMMENT_ONLY / TEST_ONLY / BEHAVIORAL_SERVICE_CHANGE / API_CONTRACT_CHANGE / SQL_OR_MAPPER_CHANGE / SECURITY_OR_PERMISSION_CHANGE）写入 ledger 的 `postTestClassification`；非行为性清理可复用 API 测试结果但须记录依据，行为性变更必须重跑相关场景 |
+| **execute 编码侧步骤 0** | 任何代码修改前必须先向 `events.ndjson` 追加 `phase.start`；执行日志由阶段结束事件自动渲染 |
+| **execute 轻量验证** | `/harness-execute` 编码侧默认只做开发反馈：TDD RED/GREEN + REFACTOR + 构建命令增量编译（Java 的 `mvn compile -pl <module>` 等）+ 关门检查 + 写 verification-ledger；除非改了公共模块/数据访问层/sql/权限认证/接口层/数据契约 或用户要求 full-run-validation，否则不默认跑全量测试命令（Java 的 `mvn test` 等）。若跑了全量测试必须写入 ledger 供验证侧/submit 复用 |
+| **execute TDD 降级** | 输出必须写"🟡 静态逻辑验证通过，未执行真实单元测试"，**禁止写"测试全部通过"**；降级标注写在执行日志和覆盖报告中，**不污染业务代码注释**；记录三项：降级原因、静态验证场景列表、待部署后验证场景列表 |
+| **execute ledger 复用** | 验证侧执行单元测试前先读 `verification-ledger.json`：若编码侧已对同一 diffHash/module/profile 跑过单元测试命令（Java 的 `mvn test` 等）且测试通过（Java 的 `Tests run: N, Failures: 0, Errors: 0` / 前端 N passing），可跳过重跑并标记"✅ 复用编码侧单元测试结果"；diffHash 不一致 / profile 不一致 / 命令范围更窄 / 编码侧之后有行为性修改则不得复用 |
+| **execute 批量 runner** | 默认使用 **PowerShell 接口测试执行器**：生成 `.harness/changes/<cn>/runtime/api-test-runner.mjs`，通过一次 PowerShell + node 执行全部场景，输出 `api-test-results.json`，主会话只读 JSON 生成摘要。Playwright MCP `browser_evaluate` 仅作 fallback，报告必须区分执行器：PowerShell 接口测试执行器 ✅使用 / PowerShell batch 🟡fallback / Playwright MCP 🟡fallback / curl 🟡fallback |
+| **execute token 策略** | 先读 `.harness/changes/<cn>/runtime/credential-cache.json`（旧名 `token-cache.json` 兼容），本地轻量接口验证通过则复用，失败才访问远程 SSO；接口测试执行器必须用 request context / node fetch 直接请求本地 baseURL，**不得依赖浏览器当前页面 origin** |
+| **execute 后变更分类** | 验证完成后发生代码变更时，submit/archive 必须按 7 类分类（NON_BEHAVIORAL_CLEANUP / COMMENT_ONLY / TEST_ONLY / BEHAVIORAL_SERVICE_CHANGE / API_CONTRACT_CHANGE / SQL_OR_MAPPER_CHANGE / SECURITY_OR_PERMISSION_CHANGE）写入 ledger 的 `postTestClassification`；非行为性清理可复用 API 测试结果但须记录依据，行为性变更必须重跑相关场景 |
 | **submit 时序** | `/harness-submit` 完成后：主目录模式可直接 `/harness-archive`；worktree 模式在同一 skill 内自动完成合并后再 archive |
 | **submit ledger 复用** | 验证前先读 `verification-ledger.json`：若当前 diffHash 已通过 test 完整验证且无行为性 post-test 修改，submit 不默认重跑构建命令/测试命令（Java 的 `mvn compile`/`mvn test` 等）；只在远端有新提交 / staged diff 与 ledger 不一致 / 行为性 post-test 修改 / test 报告缺失或失败 / 用户要求 submit-full-verify 时重跑，重跑结果写回 ledger |
 | **submit commit message** | subject 只根据当前 `git diff --cached` 或本次变更名生成，**不得混入历史任务上下文** |
@@ -309,7 +307,7 @@ harness-skills/
                     └──────┬───────┘
                            │
                     ┌──────▼───────┐
-                    │ harness-test │  "测试验证" — 单元+接口+数据兼容
+                    │ harness-execute │  "测试验证" — 单元+接口+数据兼容
                     └──────┬───────┘
                            │
                     ┌──────▼───────┐
@@ -335,22 +333,22 @@ harness-skills/
      └─────────────────────────────────────────────────┘
 ```
 
-> **harness-review 是参考性审查阶段**：默认只生成参考性审查报告和按需 fixback，不影响后续 submit、archive。如果用户选择处理 fixback，回到 `/harness-run --fixback`，再执行 `/harness-test` 和 `/harness-review`；如果团队希望 review RED 阻塞提交，可在 `.harness/config/harness-test-config.md` 中设置 `review.strict-review-gate: true`。
+> **harness-review 是参考性审查阶段**：默认只生成参考性审查报告和按需 fixback，不影响后续 submit、archive。如果用户选择处理 fixback，回到 `/harness-execute --fixback`，再执行 `/harness-execute` 和 `/harness-review`；如果团队希望 review RED 阻塞提交，可在 `.harness/config/harness-test-config.md` 中设置 `review.strict-review-gate: true`。
 
-> **阶段顺序以计划为准**：Plan 会把本次 `plannedPhases` 写入上下文，后续阶段只消费该计划，不再假定 test、review、submit 或 merge 必经。快速流程默认可用 `plan → run → archive`；需要完整验证、评审或提交时再把对应阶段加入计划。无 Git、无 upstream、仅本地提交或主动跳过 submit 都不妨碍事实封存；只有“发布候选”需要额外满足发布策略。
+> **阶段顺序以计划为准**：Plan 会把本次 `plannedPhases` 写入上下文，后续阶段只消费该计划，不再假定 test、review、submit 或 merge 必经。快速流程默认可用 `plan → execute → archive`；需要完整验证、评审或提交时再把对应阶段加入计划。无 Git、无 upstream、仅本地提交或主动跳过 submit 都不妨碍事实封存；只有“发布候选”需要额外满足发布策略。
 
 > **verification-ledger 驱动跨阶段复用**：先通过共享状态目录解析器定位变更，再读写其 `evidence/verification-ledger.json`，其中记录 compile/unitTest/apiTest 的结果、证据、diffHash 和作用范围。run/test/submit 执行验证前先读 ledger，满足复用条件（diffHash 一致、module/profile 一致、范围更严格、有证据、无行为性 post-test 修改）则跳过重跑并标记 🔁REUSED；post-test 小改动按 7 类分类，非行为性清理可复用 API 测试。详见 `protocols/ledger-protocol.md`。
 
 ## 外部方法论吸收（已内化）
 
-`harness-plan`、`harness-run`、`harness-review` 已将外部 skill 的有效方法内化为原生协议，不再运行时调用 Superpowers、grill-me 或 `receiving-code-review`，也不检查、降级或同步 `docs/superpowers/` 草稿。
+`harness-plan`、`harness-execute`、`harness-review` 已将外部 skill 的有效方法内化为原生协议，不再运行时调用 Superpowers、grill-me 或 `receiving-code-review`，也不检查、降级或同步 `docs/superpowers/` 草稿。
 
 | 方法论来源 | harness 落点 | 当前关系 |
 |------------|--------------|----------|
 | brainstorming | `harness-plan/protocols.md` 的 clarification-protocol | 已内化：风险、复用机会、替代方案、推荐方案 |
 | grill-me | `harness-plan/protocols.md` 的 decision-grilling-protocol | 已内化：有限问题预算、一次一问、每问推荐答案 |
 | writing-plans | `harness-plan/protocols.md` 的 implementation-planning-protocol | 已内化：任务简表、自适应执行参考、无占位符自检 |
-| Superpowers TDD / subagent-driven-dev | `harness-run/protocols.md` 的 run-tdd-protocol / change-cluster-review-protocol | 已内化：RED 类型、GREEN 最小实现、风险触发审查 |
+| Superpowers TDD / subagent-driven-dev | `harness-execute/protocols.md` 的 run-tdd-protocol / change-cluster-review-protocol | 已内化：RED 类型、GREEN 最小实现、风险触发审查 |
 | receiving-code-review | `harness-review/protocols.md` 的 review-fixback-protocol | 已内化：RED/YELLOW 转结构化 fixback |
 
 > **状态说明**：Superpowers / grill-me 可作为人工参考或后续方法论对标来源，但不是 harness 正式流程的运行时依赖；缺失时不触发降级记录。
@@ -397,7 +395,7 @@ powershell.exe -Command "Copy-Item -Path 'harness-skills/harness-*' -Destination
 或者只复制需要的 skill：
 
 ```powershell
-powershell.exe -Command "Copy-Item -Path 'harness-skills/harness-test' -Destination '<目标项目>/.claude/skills/' -Recurse -Force"
+powershell.exe -Command "Copy-Item -Path 'harness-skills/harness-execute' -Destination '<目标项目>/.claude/skills/' -Recurse -Force"
 ```
 
 Claude Code/CodeBuddy 可选复制 3 个隔离角色：`harness-explorer` 仅高复杂度探索、`harness-evaluator` 仅 `--adversarial`/高风险规划、`harness-reviewer` 仅发布候选/高风险审查。Codex/Cursor 默认使用主会话或宿主临时隔离任务，不安装固定角色，也不执行固定 agent 预检：
@@ -420,8 +418,8 @@ npx hunter-harness   # 初始化阶段检查环境/CodeGraph/基础状态（非
 /harness-sync         # 10 项元数据检查（7 核心 + 3 辅助）
 /harness-codebase-map  # 生成代码库地图（7 类文档）
 /harness-plan         # 需求规划（生成测试场景表 + 自动命名变更名）
-/harness-run          # TDD 编码
-/harness-test         # 运行测试（30条避坑规则）
+/harness-execute          # TDD 编码
+/harness-execute         # 运行测试（30条避坑规则）
 /harness-review       # 代码审查
 /harness-submit       # 提交代码（worktree 模式含合并；/harness-merge 为别名）
 /harness-archive      # 归档产出（harness_archive.py execute），释放工作区
@@ -429,7 +427,7 @@ npx hunter-harness   # 初始化阶段检查环境/CodeGraph/基础状态（非
 
 ## 避坑知识来源
 
-`harness-test/pitfalls.md` 中的 30 条避坑规则来自真实对话日志（2026-06-12 ~ 06-24）。
+`harness-execute/testing-pitfalls.md` 中的 30 条避坑规则来自真实对话日志（2026-06-12 ~ 06-24）。
 
 ---
 ← 返回 [[AI开发工作流|工作流主页]]
@@ -439,9 +437,9 @@ npx hunter-harness   # 初始化阶段检查环境/CodeGraph/基础状态（非
 
 ### Worktree 决策状态
 
-`harness-plan` 阶段 2 用户选择后，必须写入 `.harness/changes/<change-name>/meta/worktree.json`。`harness-run` 负责读取该文件并创建/切换 worktree。
+`harness-plan` 阶段 2 用户选择后，必须写入 `.harness/changes/<change-name>/meta/worktree.json`。`harness-execute` 负责读取该文件并创建/切换 worktree。
 
-硬规则：如果 `worktree.json` 中 `requested=true`，而 worktree 不存在，`harness-run` 必须创建 worktree 或停止，不得静默回到主目录执行。
+硬规则：如果 `worktree.json` 中 `requested=true`，而 worktree 不存在，`harness-execute` 必须创建 worktree 或停止，不得静默回到主目录执行。
 
 
 ## Cross-skill Protocols

package/harness/bundles/general/codebuddy/contracts/workflow-policy.json

@@ -132,56 +132,6 @@
         "risk-classify-plan"
       ]
     },
-    "harness-run": {
-      "phase": "execute",
-      "inputs": [
-        "implementation-detail",
-        "state-snapshot"
-      ],
-      "artifacts": [
-        "code",
-        "verification-ledger"
-      ],
-      "events": [
-        "phase.start",
-        "phase.end",
-        "command",
-        "verification"
-      ],
-      "allowedInteractions": [],
-      "capabilities": [
-        "gate-begin",
-        "gate-close",
-        "ledger-record"
-      ]
-    },
-    "harness-test": {
-      "phase": "execute",
-      "inputs": [
-        "test-scenarios",
-        "verification-ledger"
-      ],
-      "artifacts": [
-        "test-reports",
-        "verification-ledger"
-      ],
-      "events": [
-        "phase.start",
-        "phase.end",
-        "command",
-        "verification"
-      ],
-      "allowedInteractions": [
-        "resource-intensive-test-confirmation"
-      ],
-      "capabilities": [
-        "gate-begin",
-        "gate-close",
-        "test-guard",
-        "ledger-record",
-        "resource-safe-test-runner"
-      ]
-    },
     "harness-review": {
       "phase": "review",
       "inputs": [

package/harness/bundles/general/codebuddy/harness-archive/SKILL.md

@@ -3,7 +3,7 @@ name: harness-archive
 description: 归档所有变更产出（计划/测试报告/审查/SQL/API文档）到 .harness/archive/，含归档元数据。仅当用户显式调用
   /harness-archive 时使用；不得被其他阶段 skill 自动接续触发。
 ---
-<!-- generated by harness_deploy.py; core=3c6eec08da6f5a5c; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=8aa1d6994e1d3d22; overlay=none; agent=codebuddy; do not edit -->
 # harness-archive — 变更归档
 
 ## Purpose

package/harness/bundles/general/codebuddy/harness-codebase-map/SKILL.md

@@ -3,7 +3,7 @@ name: harness-codebase-map
 description: 分析现有代码库并生成 .harness/codebase/map/
   下的结构化代码库地图。用于陌生项目理解、重大改造前梳理、harness-sync 提示 map 过期后的人工刷新。
 ---
-<!-- generated by harness_deploy.py; core=3c6eec08da6f5a5c; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=8aa1d6994e1d3d22; overlay=none; agent=codebuddy; do not edit -->
 # harness-codebase-map — 代码库地图
 
 ## Purpose

package/harness/bundles/general/codebuddy/harness-codebase-map/templates/TESTING.md

@@ -61,4 +61,4 @@ status: active
 
 ## Notes for AI Agents
 
-- <how harness-test should use this map>
+- <how harness-execute should use this map>

package/harness/bundles/general/codebuddy/harness-execute/SKILL.md

@@ -4,11 +4,11 @@ description: 执行阶段：按变更簇执行 TDD
   编码循环（RED→GREEN→REFACTOR→编译验证），随后完成单元/接口/数据兼容验证并输出测试报告。仅当用户显式调用
   /harness-execute 时使用；不得因用户提到编码/实现/测试就自动触发，也不得被其他阶段 skill 自动接续。
 ---
-<!-- generated by harness_deploy.py; core=3c6eec08da6f5a5c; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=8aa1d6994e1d3d22; overlay=none; agent=codebuddy; do not edit -->
 # harness-execute — 执行（编码 + 验证）
 
-> 2026-08 阶段合并：原 `run`（编码）与 `test`（验证）合并为单一 `execute` 阶段。
-> `/harness-run` 与 `/harness-test` 保留为别名入口，语义与本 skill 相同。
+> 2026-08 阶段合并：原 `run`（编码）与 `test`（验证）合并为单一 `execute` 阶段；
+> 0.4.9（workflow-harness）起 `/harness-run`、`/harness-test` 入口移除，统一由本 skill 承担。
 
 ## Purpose
 
@@ -16,7 +16,7 @@ description: 执行阶段：按变更簇执行 TDD
 
 ## When to Use
 
-仅当用户显式调用 `/harness-execute`（或别名 `/harness-run`、`/harness-test`）时执行；plan 完成后**不自动**进入本阶段。参数：`--subagent` 强制 Subagent-Driven；`--inline` 等同默认；`--fixback` 读最新 review fixback。**默认 Inline，不询问执行模式**。
+仅当用户显式调用 `/harness-execute` 时执行；plan 完成后**不自动**进入本阶段。参数：`--subagent` 强制 Subagent-Driven；`--inline` 等同默认；`--fixback` 读最新 review fixback。**默认 Inline，不询问执行模式**。
 
 **单阶段原则**：execute 关门后必须停止并交还用户，仅提示 `plannedPhases` 中的真实下一阶段；禁止自动开始其他阶段。
 
@@ -41,7 +41,7 @@ description: 执行阶段：按变更簇执行 TDD
 **状态与代码分离**：代码/编译/测试在 `worktreeRoot`；`stateDir`（logs/events/ledger/reports）写回 `.harness/changes/<change-name>/`。
 
 创建命令与 JSON 模板 → 各 skill `reference.md`（plan 写决策，run 创建/更新）。
-> 片段：worktree-gate · 创建命令 → `harness-run/reference.md`
+> 片段：worktree-gate · 创建命令 → `coding-reference.md`
 
 ## 统一读取协议
 
@@ -62,10 +62,10 @@ description: 执行阶段：按变更簇执行 TDD
 ## Workflow 概要
 
 0. 加载上下文：先 `harness_context.py prepare --project . --change <id> --phase execute --executor <tool> --json`（`--project` 必填），再 `harness_context.py begin --project . --change <id> --phase execute --executor <tool> --json` 校验交接，最后运行 **`harness_gate.py begin --phase execute --change <id>`**。旧名 `--phase run` / `--phase test` 仍被接受并归一为 execute。<br>**交接凭证不必手工补**：v2 计划的 `plan finalize` 不写 context 事务，`prepare` 会在检测到 committed 的 `meta/publication-journals/*.json` 时自动补录 `plan → execute` 凭证（凭证带 `bootstrapSource=plan_publication_journal` 留痕）。仍报 `HANDOFF_REQUIRED`/`LEGACY_BOOTSTRAP_REQUIRED` 说明**没有**这份发布证据——回到 plan 阶段确认发布是否真的完成，**不得**自己拼 `classify + configure-plan + close` 造凭证。<br>**Fixback** 不得拼装底层步骤，必须只调用一次 `harness_fixback.py launch-review --project . --change <id> --change-dir <change-dir> --executor <tool> --skills-root <skills-root> --product-identity <当前产品身份> --json`；返回 `FIXBACK_NOTHING_TO_APPLY` 时直接报告并停止。禁止手写 `events.ndjson` / `phase.end`。
-0.5. **测试基础设施探测**与**命令执行模式 preflight** → `harness-test/reference.md`「命令执行模式 preflight」；测试基线已由 gate begin 内部建立，不得再次执行 guard begin
-1. **变更簇 TDD** — `harness-run/protocols.md` `run-tdd-protocol`；批量 RED/GREEN；按需 `change-cluster-review-protocol`
+0.5. **测试基础设施探测**与**命令执行模式 preflight** → `testing-reference.md`「命令执行模式 preflight」；测试基线已由 gate begin 内部建立，不得再次执行 guard begin
+1. **变更簇 TDD** — `protocols.md` `run-tdd-protocol`；批量 RED/GREEN；按需 `change-cluster-review-protocol`
 2. 构建验证 + **仅**通过 `harness_ledger.py record` 写 ledger（禁止 Write/Edit `verification-ledger.json`）；profile 缺失或陈旧时先 `harness_preflight.py detect --project . --json`；`record --project . --profile-input <key>` 从同一 target 推导 scope、coverage、规范命令与输入闭包
-3. **验证执行**：单元测试可复用则跳过（`harness_ledger.py can-reuse`）；接口测试**强制批量执行器**一次跑完全部场景；数据兼容验证按场景表执行 → `harness-test/reference.md`
+3. **验证执行**：单元测试可复用则跳过（`harness_ledger.py can-reuse`）；接口测试**强制批量执行器**一次跑完全部场景；数据兼容验证按场景表执行 → `testing-reference.md`
 4. **场景覆盖检查**（场景表映射，禁止用用例数冒充场景数）
 5. **关门检查**（10 项）→ 只执行一次 `harness_gate.py close`；`--to-phase` 可省略——计划后继唯一（排除 fixback 自环）时自动派生并交接（输出含 `derivedToPhase`）。仅 fixback 回环时显式传 `--to-phase execute`。该命令内部关闭 test guard、写 `phase.end`、释放租约、写 handoff 并补传事件；不得再单独调用 test-guard/context close。失败时按结构化 `recoveryAction` 原样重试，已完成步骤幂等复用。
 
@@ -79,13 +79,13 @@ description: 执行阶段：按变更簇执行 TDD
 python <skills-root>/scripts/harness_test_runner.py exec --project . --timeout-seconds <预估上限> -- <构建命令及参数>
 ```
 
-资源档位是硬合同（`safe` 默认；`system`/`full` 需用户明确授权或 `--confirm-resource-intensive`）；Python `unittest` 必须逐模块隔离模式（`harness_test_runner.py unittest --profile safe --tests-dir <目录>`）。返回 `TEST_RUN_ALREADY_ACTIVE` 说明已有构建在跑：等待或查明持有者，不得绕开锁另起并行构建。完整约束 → `harness-test/checklist.md`「0.0-A 资源安全档位」。
+资源档位是硬合同（`safe` 默认；`system`/`full` 需用户明确授权或 `--confirm-resource-intensive`）；Python `unittest` 必须逐模块隔离模式（`harness_test_runner.py unittest --profile safe --tests-dir <目录>`），并发上限由 runner 注入的 `HARNESS_TEST_MAX_WORKERS` 决定，不得自行提升。返回 `TEST_RUN_ALREADY_ACTIVE` 说明已有构建在跑：等待或查明持有者，不得绕开锁另起并行构建。完整约束 → `testing-checklist.md`「0.0-A 资源安全档位」。
 
 **长阶段租约**：`gate begin` 的租约默认 TTL 3600 秒，execute 阶段常常跑得更久。租约过期不会中断执行，**也不再阻断收尾**：`gate close` 发现租约过期而 run-id 仍是本阶段的，会自动用原 run-id 重取并照常关门，只在返回体的 `leaseLapsed` 里记录。不需要定期续租；报 `LEASE_ABSENT`/`LEASE_INVALID` 时先确认 begin 真的跑过，**不要**重跑 `gate begin`。
 
 **关门重试是幂等续跑**（0.4.5 workflow 起）：租约释放是 close 的最后一个可失败步骤，handoff/monitor/清草稿任一失败时租约仍持有，原样重跑同一命令即可（已完成步骤由 closeTransaction journal 幂等跳过）。万一处于「phase.end 已写 + 租约已放 + 交接未完成」的历史中间态，重跑 close 会自动识别并补跑剩余步骤（`PHASE_CLOSE_RESUMED`）：未带 `--to-phase` 时从 plannedPhases 派生唯一后继，后继不唯一才报 `PHASE_HANDOFF_PENDING` 并列出候选。**都不需要手工 `harness_change.py claim`**——LEASE_ABSENT 只在 begin 从未跑过时才该出现。
 
-**接口测试执行器优先级**：接口测试执行器（默认首选）> PowerShell batch `.ps1` > Playwright MCP `browser_evaluate`（仅前两者不可用或用户明确选择）> curl + UTF-8 JSON body file（兜底）。执行器在 PowerShell 可用时**禁止**用 Playwright MCP 逐条执行。→ `harness-test/reference.md`「接口测试工具优先级」
+**接口测试执行器优先级**：接口测试执行器（默认首选）> PowerShell batch `.ps1` > Playwright MCP `browser_evaluate`（仅前两者不可用或用户明确选择）> curl + UTF-8 JSON body file（兜底）。执行器在 PowerShell 可用时**禁止**用 Playwright MCP 逐条执行。→ `testing-reference.md`「接口测试工具优先级」
 
 **陈旧测试安全修复**：只有当前生产代码、已批准计划或可验证历史能唯一确定新契约时，才允许仅修改测试并立即重跑，然后记录：
 
@@ -111,7 +111,7 @@ python <skills-root>/scripts/harness_test_guard.py record --project . --change-d
 
 ## 关键规则（硬门禁速查）
 
-> 编码侧细则 → `harness-run/reference.md`、`harness-run/protocols.md`；验证侧细则 → `harness-test/reference.md`、`harness-test/checklist.md`、`harness-test/pitfalls.md`
+> 编码侧细则 → `coding-reference.md`、`protocols.md`；验证侧细则 → `testing-reference.md`、`testing-checklist.md`、`testing-pitfalls.md`
 
 | 域 | 要点 |
 |----|------|
@@ -132,11 +132,11 @@ python <skills-root>/scripts/harness_test_guard.py record --project . --change-d
 
 ## 渐进披露
 
-- **Read `harness-run/protocols.md`** — run-tdd + change-cluster-review
-- **Read `harness-run/reference.md`** — Step 0–5 细节、TDD/RED/ledger/迁移/安全矩阵
-- **Read `harness-test/checklist.md`** — 验证前各项强制检查、preflight、服务生命周期清单
-- **Read `harness-test/reference.md`** — API 测试执行方法、执行器模板、运行时配置叠加
-- **Read `harness-test/pitfalls.md`** — 测试踩坑规则
+- **Read `protocols.md`** — run-tdd + change-cluster-review
+- **Read `coding-reference.md`** — Step 0–5 细节、TDD/RED/ledger/迁移/安全矩阵
+- **Read `testing-checklist.md`** — 验证前各项强制检查、preflight、服务生命周期清单
+- **Read `testing-reference.md`** — API 测试执行方法、执行器模板、运行时配置叠加
+- **Read `testing-pitfalls.md`** — 测试踩坑规则
 
 ## 交互白名单