hunter-harness 0.1.2 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hunter-harness",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Local-first, server-governed agent harness",
   "license": "MIT",
   "type": "module",

package/resources/harness/bundles/general/claude-code/.harness-build.json

@@ -0,0 +1,6 @@
+{
+  "schemaVersion": 1,
+  "overlay": "none",
+  "agent": "claude-code",
+  "coreHash": "3797d93d2cf363a9"
+}

package/resources/harness/{general → bundles/general/claude-code}/agents/harness-reviewer.md

@@ -1,6 +1,6 @@
 ---
 name: harness-reviewer
-description: "6维度代码审查执行者：对 git diff 进行架构/安全/规范/兼容/测试/性能审查，对照 .claude/rules/ 和测试场景表，default 模式 + tools 白名单只读，返回分级审查报告（RED/YELLOW/OK）。由 harness-review skill 通过 Agent 工具 spawn（subagent_type: harness-reviewer）委派。"
+description: "6维度代码审查执行者：对 git diff 进行架构/安全/规范/兼容/测试/性能审查，对照项目规则（见 .harness/context-index.json）和测试场景表，default 模式 + tools 白名单只读，返回分级审查报告（RED/YELLOW/OK）。由 harness-review skill 通过 Agent 工具 spawn（subagent_type: harness-reviewer）委派。"
 model: sonnet
 effort: high
 permissionMode: default
@@ -32,7 +32,7 @@ disallowedTools:
 
 ## 你的职责
 
-执行 `harness-review` SKILL.md Workflow 步骤 1-2 的审查工作：确定变更名、读取 worktree 状态（`requested=true` 但 worktree 不存在 → 返回 🟡 提示主会话先修复，**不得审查主目录**，否则 git diff 为空）、6维度逐文件审查（架构/安全/规范/兼容/测试/性能）、对照 `.claude/rules/` 和测试场景表、返回分级报告。维度检查项见 `harness-review/checklist.md`，报告格式见 `harness-review/reference.md`。
+执行 `harness-review` SKILL.md Workflow 步骤 1-2 的审查工作：确定变更名、读取 worktree 状态（`requested=true` 但 worktree 不存在 → 返回 🟡 提示主会话先修复，**不得审查主目录**，否则 git diff 为空）、6维度逐文件审查（架构/安全/规范/兼容/测试/性能）、对照 `项目规则（见 .harness/context-index.json）/` 和测试场景表、返回分级报告。维度检查项见 `harness-review/checklist.md`，报告格式见 `harness-review/reference.md`。
 
 ### agent 特有执行约束
 

package/resources/harness/{general → bundles/general/claude-code}/harness-archive/SKILL.md

@@ -20,7 +20,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=76dd32302df53f0b; overlay=none; do not edit -->
+<!-- generated by harness_deploy.py; core=3797d93d2cf363a9; overlay=none; agent=claude-code; do not edit -->
 # harness-archive — 变更归档
 
 ## Purpose

package/resources/harness/{java → bundles/general/claude-code}/harness-codebase-map/SKILL.md

@@ -20,7 +20,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=47a5159f5c4b49b8; overlay=java; do not edit -->
+<!-- generated by harness_deploy.py; core=3797d93d2cf363a9; overlay=none; agent=claude-code; do not edit -->
 # harness-codebase-map — 代码库地图
 
 ## Purpose

package/resources/harness/{java → bundles/general/claude-code}/harness-knowledge-ingest/SKILL.md

@@ -20,7 +20,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=47a5159f5c4b49b8; overlay=java; do not edit -->
+<!-- generated by harness_deploy.py; core=3797d93d2cf363a9; overlay=none; agent=claude-code; do not edit -->
 # harness-knowledge-ingest
 
 从 `.harness/archive/**/reports/final/summary-data.json` 抽取项目知识，生成并维护本地 `.harness/knowledge/` 索引。

package/resources/harness/{general → bundles/general/claude-code}/harness-knowledge-ingest/reference.md

@@ -4,7 +4,7 @@ description: harness-knowledge-ingest 的命令详细示例、config.json 配置
 
 # harness-knowledge-ingest 参考
 
-本文件为 `harness-knowledge-ingest` 的渐进披露支持文件，承载 Commands 详细示例与变更日志。SKILL.md 只保留概要 + 渐进披露引用。`<skill-dir>` 指本 skill 目录，即 `.claude/skills/harness-knowledge-ingest/` 或知识库源目录中的 `harness-knowledge-ingest/`。所有 python 脚本命令通过 `powershell.exe -Command "..."` 执行，避开 Bash 在 Windows 中文路径下的编码/参数问题。
+本文件为 `harness-knowledge-ingest` 的渐进披露支持文件，承载 Commands 详细示例与变更日志。SKILL.md 只保留概要 + 渐进披露引用。`<skill-dir>` 指本 skill 目录，即 `harness-knowledge-ingest/` 或知识库源目录中的 `harness-knowledge-ingest/`。所有 python 脚本命令通过 `powershell.exe -Command "..."` 执行，避开 Bash 在 Windows 中文路径下的编码/参数问题。
 
 ## Commands 详细
 

package/resources/harness/{general → bundles/general/claude-code}/harness-knowledge-query/SKILL.md

@@ -20,7 +20,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=76dd32302df53f0b; overlay=none; do not edit -->
+<!-- generated by harness_deploy.py; core=3797d93d2cf363a9; overlay=none; agent=claude-code; do not edit -->
 # harness-knowledge-query
 
 根据用户的新需求或排查问题，从项目本地 `.harness/knowledge` 中检索历史需求、决策、实现、风险和测试证据，并生成 AI 可读的 context pack。

package/resources/harness/{general → bundles/general/claude-code}/harness-plan/SKILL.md

@@ -20,7 +20,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=76dd32302df53f0b; overlay=none; do not edit -->
+<!-- generated by harness_deploy.py; core=3797d93d2cf363a9; overlay=none; agent=claude-code; do not edit -->
 # harness-plan — 需求规划
 
 ## Purpose

package/resources/harness/{java → bundles/general/claude-code}/harness-review/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: harness-review
-description: "6维度代码审查（架构/安全/规范/兼容/测试/性能），对照.claude/rules/和测试场景表，在隔离上下文运行。使用场景：代码审查、提交前检查、合并评审"
+description: "6维度代码审查（架构/安全/规范/兼容/测试/性能），对照项目规则（见 .harness/context-index.json）和测试场景表，在隔离上下文运行。使用场景：代码审查、提交前检查、合并评审"
 argument-hint: "变更名或留空自动检测"
 effort: high
 allowed-tools: [Read, Write, Edit, Glob, Grep, Agent, Bash(powershell.exe:*)]
@@ -21,7 +21,7 @@ disallowed-tools:
   - Bash(curl *)
   - Bash(codegraph *)
 ---
-<!-- generated by harness_deploy.py; core=47a5159f5c4b49b8; overlay=java; do not edit -->
+<!-- generated by harness_deploy.py; core=3797d93d2cf363a9; overlay=none; agent=claude-code; do not edit -->
 # harness-review — 代码审查
 
 ## Purpose
@@ -39,7 +39,7 @@ disallowed-tools:
 ## Inputs
 
 - `$ARGUMENTS`：变更名（可选，留空时自动扫描 `.harness/changes/*/plans/` 确定）
-- 相关文件：`.harness/changes/*/plans/*-plan.md`、`.claude/rules/`、测试场景表
+- 相关文件：`.harness/changes/*/plans/*-plan.md`、`项目规则（见 .harness/context-index.json）/`、测试场景表
 
 ## 前置条件
 
@@ -64,7 +64,11 @@ disallowed-tools:
 
 0. **启动准备** — 确定变更名（Glob `.harness/changes/*/plans/*-plan.md`，排除 `.harness/archive/*/`，读 frontmatter 提取 change-name）；**append `phase.start` 事件**（不得等审查完成才补）
 1. **读取 worktree 状态（门禁检查）** — 读 `.harness/changes/<change-name>/meta/worktree.json`：`requested=true` 但 worktree 不存在 → 停止并提示先修复 `harness-run`，不得静默回主目录（否则 git diff 为空）；`requested=true` 且 worktree 已创建 → spawned agent 用该 worktree 路径执行 `git diff`（确保审查 worktree 变更而非主目录）；`requested=false` → 审查主目录变更
-2. **委派 harness-reviewer** — 先运行 `python <skills-root>/scripts/harness_preflight.py check-agents --skills-root <skills-root> --agent harness-reviewer --json`。`usable=false` → **直接主会话审查**，记 `decision` 事件，**不委派**。`usable=true` 时用 Agent spawn `harness-reviewer`（只读, 6 维度）。返回空 / 无报告正文 → **不 retry**，降级主会话审查。
+<!-- @section-id review.delegate -->
+### 2. 委派 harness-reviewer
+
+先运行 `python <skills-root>/scripts/harness_preflight.py check-agents --skills-root <skills-root> --agent harness-reviewer --json`。`usable=false` → **直接主会话审查**，记 `decision` 事件，**不委派**。`usable=true` 时用 Agent spawn `harness-reviewer`（只读, 6 维度）。返回空 / 无报告正文 → **不 retry**，降级主会话审查。
+
 3. **持久化报告（强制，主会话）** — Agent 返回后主会话 Write 到 `reports/review/review-report-*.md`。未 Write → 🟡WARN，不得宣称 review 完成。
 4. **生成修复反馈（原生协议）** — 若报告存在 RED/YELLOW 问题，执行 `protocols.md` 的 `review-fixback-protocol`，将问题转化为结构化 fixback 清单并落盘到 `.harness/changes/<change-name>/reports/review/fixback-YYYYMMDD-HHmm.md`。若无 RED/YELLOW，记录 `review-fixback-protocol: skipped(no findings)`。不调用 Superpowers `receiving-code-review`，也不记录外部 skill 降级。
 5. **收尾** — append `phase.end` / `artifact` 事件；控制台输出摘要

package/resources/harness/{general → bundles/general/claude-code}/harness-review/checklist.md

@@ -74,7 +74,7 @@ powershell.exe -Command "git -C '<项目路径>' diff"
 | 大事务 | 事务内含远程调用或文件 IO |
 | 逐条 insert | 循环内单条 insert 而非批量 |
 
-### 3. 对照 .claude/rules/ 检查
+### 3. 对照 项目规则（见 .harness/context-index.json）/ 检查
 
 逐个规则文件检查变更是否违规。违规项标注对应规则文件名和行号。
 
@@ -106,13 +106,13 @@ powershell.exe -Command "git -C '<项目路径>' diff"
 
 ```
 □ 审查代码时优先使用 codegraph_explore（一次获取多个符号源码）
-□ 未逐个 Read 文件（违反 .claude/rules/codegraph.md 规则）
+□ 未逐个 Read 文件（违反 项目 codegraph 规则 规则）
 ```
 
 ## 关键原则
 
 - 只审查 `git diff` 中的变更部分，不审查已有代码
-- 对照 `.claude/rules/` 是审查的基准线
+- 对照 `项目规则（见 .harness/context-index.json）/` 是审查的基准线
 - 区分严重级别：RED=高风险建议（强烈建议处理），YELLOW=中低风险建议
 - 每个问题给出具体修复建议（文件:行号 + 建议做法）
 - 如果 diff 为空，直接返回"无变更可审查"

package/resources/harness/{general → bundles/general/claude-code}/harness-run/SKILL.md

@@ -21,7 +21,7 @@ disallowed-tools:
   - Bash(curl *)
   - Bash(codegraph *)
 ---
-<!-- generated by harness_deploy.py; core=76dd32302df53f0b; overlay=none; do not edit -->
+<!-- generated by harness_deploy.py; core=3797d93d2cf363a9; overlay=none; agent=claude-code; do not edit -->
 # harness-run — 需求编码
 
 ## Purpose

package/resources/harness/{general → bundles/general/claude-code}/harness-run/checklist.md

@@ -34,7 +34,7 @@ description: harness-run 的执行检查清单。仅在编码执行时读取。
 - [ ] **读取任务状态**：`.harness/changes/<change>/evidence/run-task-status.md`（如存在）— 恢复上次运行状态
 - [ ] **读取 review fixback**：用户传入 `--fixback` 或要求修复 review 问题时，读取最新 `.harness/changes/<change>/reports/review/fixback-*.md`
 - [ ] 确认未将 `docs/superpowers/` 作为执行输入（旧草稿最多作为人工线索）
-- [ ] 确认 `.claude/rules/` 规则已加载
+- [ ] 确认 `项目规则（见 .harness/context-index.json）/` 规则已加载
 - [ ] 检查构建配置完整性（worktree 中确认构建配置文件存在，如 Java 的 `.mvn/maven.config`、`settings.xml`，前端的 `package.json`/lockfile 等）
 - [ ] 依赖模块预安装（worktree 中检查上游依赖是否已安装，如 Java 的 `mvn install`、前端的 `npm install`/lockfile 等）
 - [ ] 代码探索优先用 `codegraph_explore`，仅在返回不完整时补充 Read

package/resources/harness/{general → bundles/general/claude-code}/harness-run/reference.md

@@ -91,12 +91,12 @@ powershell.exe -NoProfile -Command "Test-Path '.claude/worktrees/<change-name>/.
 7. **读取验证账本**：`.harness/changes/<change-name>/evidence/verification-ledger.json`（如存在）→ 复用已有 compile/unitTest 结果
 8. **读取任务状态**：`.harness/changes/<change-name>/evidence/run-task-status.md`（如存在）→ 恢复上次运行状态
 9. **读取 review fixback**：用户传入 `--fixback` 或要求修复 review 问题时，读取最新 `.harness/changes/<change-name>/reports/review/fixback-*.md`，并将 RED/YELLOW 条目映射为本轮变更簇
-10. 确认 `.claude/rules/` 规则已加载
+10. 确认 `项目规则（见 .harness/context-index.json）/` 规则已加载
 11. **执行测试基础设施探测**（见下方"步骤 0.5"）
 12. 确认构建环境正常（构建命令按技术栈，见项目 CLAUDE.md 或 `.harness/config/harness-build-config.md`；如 Java 的 `powershell.exe -Command "mvn compile -pl <module> -o -q"`）
 13. **检查构建配置完整性**：如果在 worktree 中执行，确认构建配置文件存在（如 Java 的 `.mvn/maven.config`/`settings.xml`、JVM 的 `gradle.properties`、前端的 `package.json`/lockfile 等）。worktree 可能不包含主目录的构建配置，缺失时从主目录复制
 14. **依赖模块预安装**：如果在 worktree 中执行，检查上游依赖是否已安装（如 Java 的 `mvn install` 到本地仓库、前端的依赖已 install）。缺失时先执行对应安装命令（Java 示例：`powershell.exe -Command "mvn install -pl <upstream-modules> -am -DskipTests -nsu"`）
-15. **代码探索优先用 codegraph_explore**：一次调用可获取多个相关符号的源码，替代逐个 Read 文件。违反 `.claude/rules/codegraph.md` 规则逐个 Read 会浪费 3-5 分钟。仅在 codegraph 返回结果不完整时补充 Read
+15. **代码探索优先用 codegraph_explore**：一次调用可获取多个相关符号的源码，替代逐个 Read 文件。违反 `项目 codegraph 规则` 规则逐个 Read 会浪费 3-5 分钟。仅在 codegraph 返回结果不完整时补充 Read
 
 ### 步骤 0.0：正式产物来源确认
 

package/resources/harness/{general → bundles/general/claude-code}/harness-submit/SKILL.md

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

package/resources/harness/{java → bundles/general/claude-code}/harness-sync/SKILL.md

@@ -19,7 +19,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=47a5159f5c4b49b8; overlay=java; do not edit -->
+<!-- generated by harness_deploy.py; core=3797d93d2cf363a9; overlay=none; agent=claude-code; do not edit -->
 # harness-sync — 元数据同步
 
 ## Purpose
@@ -43,7 +43,7 @@ disallowed-tools:
 | 4 | CLAUDE.md 完整性/行数 → 超限 AskUserQuestion 瘦身 |
 | 5 | AGENTS.md 与 CLAUDE.md 一致 |
 | 6 | `.harness/` 结构（init 规程 → `reference.md` 第 6 步）；可选 `harness_deploy.py diff` 检查已装 skill 是否过期 |
-| 7–9 | `.claude/rules/`、构建配置、测试目录 — **只提示不自动修复** |
+| 7–9 | `项目规则（见 .harness/context-index.json）/`、构建配置、测试目录 — **只提示不自动修复** |
 
 状态判断表格、修复动作、输出示例 → `reference.md`
 

package/resources/harness/{general → bundles/general/claude-code}/harness-sync/reference.md

@@ -53,9 +53,9 @@ powershell.exe -Command "git -C '<项目路径>' diff --stat HEAD~5 2>$null"
 | 代码规范 | Read 后查找 分层/编码规范 相关描述 | AI 可能写出不符合项目约定的代码 |
 | 测试约定 | Read 后查找 test/测试/TDD 相关描述 | AI 不知道测试框架和命名规范 |
 | 架构约束 | Read 后查找 架构/分层/循环依赖/约束 相关描述 | AI 可能建议违反架构的设计 |
-| 行数 ≤ 200 | Read 后估算行数 | 超限 → 与用户确认瘦身策略，拆分到 `.claude/rules/`。含 Skill 工作流说明的可放宽到 300 行 |
+| 行数 ≤ 200 | Read 后估算行数 | 超限 → 与用户确认瘦身策略，拆分到 `项目规则（见 .harness/context-index.json）/`。含 Skill 工作流说明的可放宽到 300 行 |
 
-**瘦身策略**：如果超过 200 行，不是简单截断——而是把可独立成篇的细节（如完整编码规范、详细架构图）迁移到 `.claude/rules/` 下，CLAUDE.md 保留简洁的索引和关键命令。
+**瘦身策略**：如果超过 200 行，不是简单截断——而是把可独立成篇的细节（如完整编码规范、详细架构图）迁移到 `项目规则（见 .harness/context-index.json）/` 下，CLAUDE.md 保留简洁的索引和关键命令。
 
 > ⚠️ CLAUDE.md 需要瘦身时，必须用 AskUserQuestion 与用户确认拆分方案后再执行。
 
@@ -80,16 +80,16 @@ powershell.exe -Command "git -C '<项目路径>' diff --stat HEAD~5 2>$null"
 
 > ⚠️ **`hunter-harness init` 风险规程**（`.harness/` 未初始化时触发）：
 > 1. **预览**：`node packages/cli/dist/bin.js --non-interactive --dry-run --adapter claude-code --profile general --json`，确认将写入的路径清单与 `project_id`（`null` = 未绑服务器，本地自治理）。
-> 2. **备份**：将 `.claude/skills/`（尤其 `harness-*/SKILL.md`）、`CLAUDE.md`、`AGENTS.md` 复制到 `$env:TEMP/hh-init-backup-<时间戳>`。`.claude/` 若被 gitignore，被覆盖文件无 git 兜底，备份是唯一恢复途径。
+> 2. **备份**：将 `已安装 harness-* skills 目录（见 context-index）/`（尤其 `harness-*/SKILL.md`）、`CLAUDE.md`、`AGENTS.md` 复制到 `$env:TEMP/hh-init-backup-<时间戳>`。`.claude/` 若被 gitignore，被覆盖文件无 git 兜底，备份是唯一恢复途径。
 > 3. **执行**：`init --yes` 写入预览路径。
-> 4. **恢复**：逐个比对 `.claude/skills/harness-*/SKILL.md` 与备份；被覆盖的从备份恢复，新增 skill（如 `harness-knowledge-ingest`、`harness-skill-optimizer`）保留。
+> 4. **恢复**：逐个比对 `harness-*/SKILL.md` 与备份；被覆盖的从备份恢复，新增 skill（如 `harness-knowledge-ingest`、`harness-skill-optimizer`）保留。
 > 5. **验证**：`.harness/project.yaml`、`context-index.json` 就位；`CLAUDE.md`/`AGENTS.md` 的 managed block 为增量插入（原内容保留）。
 >
 > file-policy 备注：`.harness/changes/**`（user_editable，push/update=never，本地工作材料）、`.harness/rules/**`（internal_state，本地默认不创建）都不作为完整性判断标志；旧文本的 `.harness/config/harness-test-config.md` 路径在产品中不存在，勿作检查项。
 
-### 7. .claude/rules/ 完整性
+### 7. 项目规则（见 .harness/context-index.json）/ 完整性
 
-用 Glob 搜索 `.claude/rules/*.md`，检查是否覆盖 5 个必要主题：
+用 Glob 搜索 `项目规则（见 .harness/context-index.json）/*.md`，检查是否覆盖 5 个必要主题：
 
 | 必要主题 | 检测方式 | 缺失影响 |
 |----------|----------|----------|
@@ -145,7 +145,7 @@ powershell.exe -Command "git -C '<项目路径>' diff --stat HEAD~5 2>$null"
 - 先看 git log 了解变更量，再决定是否需要重建各组件（避免盲目全量重建）
 - CodeGraph 索引依赖编译产物，确保构建命令先通过
 - harness-codebase-map 和 Repomix 不要同时触发（两者都会产生大量上下文，叠加可能导致 API 输入超限）
-- CLAUDE.md 瘦身时，拆分到 `.claude/rules/` 的文件必须有正确的 YAML frontmatter（含 `paths:` 字段）
+- CLAUDE.md 瘦身时，拆分到 `项目规则（见 .harness/context-index.json）/` 的文件必须有正确的 YAML frontmatter（含 `paths:` 字段）
 - **CLAUDE.md 需要瘦身时必须先与用户确认拆分方案**
 
 ## 执行日志记录

package/resources/harness/{general → bundles/general/claude-code}/harness-test/SKILL.md

@@ -22,7 +22,7 @@ disallowed-tools:
   - Bash(node *)
   - Bash(codegraph *)
 ---
-<!-- generated by harness_deploy.py; core=76dd32302df53f0b; overlay=none; do not edit -->
+<!-- generated by harness_deploy.py; core=3797d93d2cf363a9; overlay=none; agent=claude-code; do not edit -->
 # harness-test — 测试执行
 
 ## Purpose

package/resources/harness/{general → bundles/general/claude-code}/harness-test/checklist.md

@@ -11,7 +11,7 @@ description: harness-test 的 Phase 0 环境准备 + Playwright 探测 + 关门
 先检查当前项目的测试配置文件（按优先级查找）：
 
 1. **优先**：`.harness/config/harness-test-config.md`（集中配置目录）
-2. **兼容**：`.claude/skills/harness-test/harness-test-config.md`（旧路径，过渡期仍支持）
+2. **兼容**：`harness-test/harness-test-config.md（兼容旧路径）`（旧路径，过渡期仍支持）
 
 如果任一文件存在，**必须先读取并应用其中的配置**。配置文件通常包含：