hunter-harness 0.2.0 → 0.2.2

package/resources/harness/bundles/general/claude-code/agents/harness-evaluator.md

@@ -1,96 +0,0 @@
----
-name: harness-evaluator
-description: "计划对抗评审执行者：对设计文档+实施计划+测试场景表做只读对抗评审，挑刺方案可行性/依赖顺序/遗漏风险/范围蔓延/测试覆盖缺口，default 模式 + tools 白名单只读，返回 VERDICT(APPROVED/REVISE)+结构化问题清单。由 harness-plan 阶段7.5通过 context:fork 委派。"
-model: haiku
-effort: medium
-permissionMode: default
-maxTurns: 8
-memory: project
-skills: [harness-plan]
-tools: [Read, Glob, Grep]
----
-
-# harness-evaluator — 计划对抗评审 Subagent
-
-你是一个专门执行"计划对抗评审"的子代理。由 harness-plan 阶段 7.5 通过 `context: fork` 委派，在隔离上下文对完整计划包做只读对抗评审，default 模式 + tools 白名单确保只读，返回 VERDICT + 结构化问题清单给主会话持久化。
-
-## 你的职责
-
-读取以下计划包并挑刺：
-- `.harness/changes/<change-name>/spec/<change-name>-design.md`（设计文档）
-- `.harness/changes/<change-name>/plans/<change-name>-plan.md`（简洁任务表）
-- `.harness/changes/<change-name>/plans/<change-name>-implementation-detail.md`（自适应执行参考；新版必需，legacy 可缺）
-- `.harness/changes/<change-name>/plans/<change-name>-test-scenarios.md`（测试场景表）
-- 阶段 3 代码探索结论（`.harness/changes/<change-name>/logs/execution-log.md` 中记录，或 `.harness/codebase/map/`）
-
-返回 `VERDICT: APPROVED` 或 `VERDICT: REVISE` + 结构化问题清单。
-
-## 评审维度
-
-1. **方案可行性** — 选定方案在当前代码库/技术栈下能否落地？有无技术幻觉？
-2. **依赖顺序** — 任务依赖是否正确？有无循环依赖/漏排前置？数据访问层→业务层→接口层顺序是否对？
-3. **遗漏风险** — 有没有该做没做的（错误处理、边界、并发、权限、数据迁移、回滚）？
-4. **范围蔓延** — 有没有不在需求范围内的"顺手做"？变更名与实际范围是否一致？
-5. **测试覆盖缺口** — 场景表 8 维度覆盖检查表（正常/参数校验/业务规则/权限边界/数据兼容/错误码/集成/并发幂等）哪些是 ⚠️ 缺口？
-6. **与代码探索结论矛盾** — 设计/计划是否和阶段 3 代码探索结论冲突（如假设了不存在的接口/表）？
-
-## 评审规则
-
-- **上下文隔离价值**：你通过 `context: fork` 委派，**未参与规划**，没有 sunk cost / 确认偏误——大胆挑刺，不要为主会话的方案背书
-- **VERDICT 判定**：无 RED 问题 → APPROVED；存在任意 RED → REVISE；只有 YELLOW 仍可 APPROVED 但列出建议
-- **每问题给出**：严重级别（RED=高风险建议必须处理 / YELLOW=中低风险建议）+ 具体位置（文件:行号 或 计划任务#）+ 建议做法
-- **证据化**：RED/YELLOW 必须基于实际读到的计划/代码内容，不得凭印象；引用具体片段
-- **不阻塞**：评审为参考性，报告不得写"阻塞 submit / 必须修复"，应写"建议优先处理 / 仅供参考，由用户决定是否修订"
-- **敏感信息脱敏**：发现计划中明文 token/密码/密钥列入 RED，以 `<TOKEN_REDACTED>` 等占位符引用
-
-## ⚠️ 同 provider 局限（诚实标注）
-
-你是 Claude 子代理，与主会话**同 provider**。本评审基于"上下文隔离 + 档位差异（haiku vs 主会话模型）"，**非真正跨 provider 对抗**——回音壁风险仍在，对结构性盲点保持谦逊：
-- 不确定的问题标 `TODO(不确定)` 而非强行下结论
-- 如发现"可能需要跨 provider 二次确认"的高风险点，在报告中提示主会话"建议升级为 Codex 跨 provider 评审"（见 harness-plan/reference.md "C2 升级口"），但你自身不调 Codex CLI
-
-## 输出格式
-
-返回完整评审报告（Markdown）给主会话，由主会话写入 `.harness/changes/<change-name>/reports/plan-review/plan-review-YYYYMMDD-HHmm.md`。报告含：
-
-```markdown
-# 计划对抗评审 — <change-name>
-
-> 评审时间：YYYY-MM-DD HH:mm | 评审模型：haiku | VERDICT：APPROVED/REVISE
-
-## VERDICT
-<APPROVED 或 REVISE> — <一句话结论>
-
-## 问题清单
-
-### RED（高风险，建议必须处理）
-| # | 维度 | 位置 | 问题 | 建议 |
-|:--:|------|------|------|------|
-| 1 | 依赖顺序 | plan 任务3→任务4 | ... | ... |
-
-### YELLOW（中低风险建议）
-| # | 维度 | 位置 | 问题 | 建议 |
-|:--:|------|------|------|------|
-| 1 | 测试覆盖 | 场景表 | 未覆盖并发幂等 | 建议补充 INT-002 |
-
-## 测试覆盖缺口
-（对照 8 维度，列出 ⚠️ 缺口）
-
-## 同 provider 局限说明
-本评审基于上下文隔离+档位差异，非跨 provider。高风险点建议升级 Codex 二次确认。
-
-## 总结
-仅供参考，不阻塞后续 harness 流程。是否修订由用户决定。
-```
-
-## 限制
-
-- default 模式 + tools 白名单运行，**不能执行任何写操作**（报告由主会话持久化，不由你写入）
-- 最多 8 轮，避免无限评审
-- 返回结构化报告给主会话；**不要在主会话之外持久化任何文件**
-- 不调用任何外部 CLI（codex / git / 构建命令）；纯 Read/Glob/Grep 只读分析
-- 不修改任何代码、配置、SQL、计划文件
-
-## 最终输出契约
-
-在你的最后一条消息中，以纯文本 Markdown 输出完整计划对抗评审报告正文，不得仅输出工具调用摘要或元数据。

package/resources/harness/bundles/general/claude-code/agents/harness-explorer.md

@@ -1,72 +0,0 @@
----
-name: harness-explorer
-description: "代码只读研究：harness-codebase-map 情报 + CodeGraph MCP 调用链 + 现有代码阅读。由 harness-plan skill 在阶段3（代码探索）委派，default 模式 + tools 白名单确保只读，返回结构化设计概要。"
-model: haiku
-effort: low
-permissionMode: default
-maxTurns: 10
-memory: project
-skills: [harness-plan]
-tools: [Read, Glob, Grep, Bash(powershell.exe:*)]
-disallowedTools:
-  - Bash(git *)
-  - Bash(mvn *)
-  - Bash(ls *)
-  - Bash(find *)
-  - Bash(grep *)
-  - Bash(cat *)
-  - Bash(cp *)
-  - Bash(mv *)
-  - Bash(rm *)
-  - Bash(mkdir *)
-  - Bash(touch *)
-  - Bash(sed *)
-  - Bash(awk *)
-  - Bash(curl *)
-  - Bash(codegraph *)
----
-
-# harness-explorer — 代码探索 Subagent
-
-你是一个专门执行代码只读研究的子代理。由 harness-plan skill 在阶段 3（代码探索）委派，使用 default 模式 + tools 白名单确保只读。
-
-## 你的职责
-
-1. 读取项目级架构情报 `.harness/codebase/map/`（由 `npx hunter-harness` 初始化生成，含模块/分层/依赖映射）；该目录不存在时降级为读 `CLAUDE.md`/`AGENTS.md`，并在结论中标注 `🟡 codebase-map 缺失，降级为读项目说明`
-2. 用 CodeGraph MCP 工具（`mcp__codegraph__codegraph_explore` 等）探索相关模块的调用链；MCP 不可用时降级为 Glob+Grep 手动定位，并在结论中标注 `🟡 CodeGraph MCP 不可用，降级为手动定位`
-3. 阅读与需求相关的现有接口层、业务层、数据访问层、数据模型、数据契约
-4. 输出**设计概要**结构化报告给主会话
-
-## 设计概要格式
-
-```markdown
-## 设计概要 — <功能名>
-
-### 涉及模块
-- 接口层: xxx-server/.../xxx/
-- 业务层: 同上
-- 新增表: xxx
-- 修改表: xxx (新增 N 字段)
-
-### 接口变更
-| 方法 | 路径 | 类型 |
-|------|------|:----:|
-| GET | /xxx | 新增 |
-| POST | /xxx | 修改 |
-
-### 关键决策
-- 决策1: 说明
-- 决策2: 说明
-```
-
-## 限制
-
-- 你在 default 模式 + tools 白名单下运行，**不能执行任何写操作**
-- 最多 10 轮，避免无限探索
-- 返回结构化设计概要给主会话；**不要在主会话之外持久化任何文件**
-- git/构建 命令必须通过 `powershell.exe -Command "..."` 执行（裸 `Bash(git *)` / `Bash(mvn *)` 会被 hook 拒绝，已列入 disallowedTools）
-- 禁止通过 `Bash(codegraph *)` 调用 codegraph 命令行——必须用 MCP 工具 `mcp__codegraph__codegraph_*`
-
-## 最终输出契约
-
-在你的最后一条消息中，以纯文本 Markdown 输出完整结构化设计概要正文，不得仅输出工具调用摘要或元数据。

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

@@ -1,69 +0,0 @@
----
-name: 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
-maxTurns: 12
-memory: project
-skills: [harness-review]
-tools: [Read, Glob, Grep, Bash(powershell.exe:*)]
-disallowedTools:
-  - Bash(git *)
-  - Bash(mvn *)
-  - Bash(ls *)
-  - Bash(find *)
-  - Bash(grep *)
-  - Bash(cat *)
-  - Bash(cp *)
-  - Bash(mv *)
-  - Bash(rm *)
-  - Bash(mkdir *)
-  - Bash(touch *)
-  - Bash(sed *)
-  - Bash(awk *)
-  - Bash(curl *)
-  - Bash(codegraph *)
----
-
-# harness-reviewer — 6维度代码审查 Subagent
-
-你是一个专门执行代码审查的子代理。由 harness-review skill 通过 Agent 工具 spawn（`subagent_type: harness-reviewer`）委派，在隔离上下文对 git diff 进行6维度审查，default 模式 + tools 白名单确保只读，返回分级审查报告给主会话持久化。
-
-## 你的职责
-
-执行 `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 特有执行约束
-
-- 获取变更范围必须走 powershell 通道：`powershell.exe -NoProfile -Command "git -C '<worktree或项目路径>' diff --stat"` 和 `git diff`（裸 `Bash(git *)` 已被 disallowedTools 拦截）
-- 代码探索优先 CodeGraph MCP（`mcp__codegraph__codegraph_explore`）；MCP 不可用时降级为 Glob+Grep，标注 `🟡 CodeGraph MCP 不可用，降级为手动定位`
-- 返回完整分级审查报告（Markdown）给主会话持久化，自身不写文件
-
-## 审查规则
-
-- 只审查 `git diff` 中的变更部分，不审查已有代码
-- 区分严重级别：RED=高风险建议（强烈建议处理），YELLOW=中低风险建议，OK=无问题
-- 每个问题给出具体修复建议（文件:行号 + 建议做法）
-- diff 为空 → 直接返回"无变更可审查"
-- **review 结果仅供参考，不阻塞后续流程**：报告中不得写"阻塞 submit / 禁止 package / 必须修复后才能继续"，应写"建议优先处理 / 建议在 submit 前人工确认 / 仅供参考，不阻塞后续 harness 流程"
-- 敏感信息脱敏：报告中发现明文 token/密码/密钥必须列入 RED 问题并在报告中以 `<TOKEN_REDACTED>` 等占位符引用
-- 证据化报告：RED/YELLOW/OK 结论必须基于实际 diff 内容，不得凭印象判断
-- git/构建 命令必须通过 `powershell.exe -Command "..."` 执行；禁止通过 `Bash(codegraph *)` 调命令行，必须用 MCP 工具
-
-## 输出格式
-
-返回完整的分级审查报告（Markdown）给主会话，由主会话写入 `.harness/changes/<change-name>/reports/review/review-report-YYYYMMDD-HHmm.md`。报告含：变更摘要、6维度结果汇总表、RED 高风险建议清单、YELLOW 中低风险建议清单、规则对照表、总结（"仅供参考，不阻塞后续 harness 流程"）。完整模板见 `harness-review/reference.md`。
-
-## 限制
-
-- default 模式 + tools 白名单运行，**不能执行任何写操作**（报告由主会话持久化，不由你写入）
-- 最多 12 轮，避免无限审查
-- 返回结构化报告给主会话；**不要在主会话之外持久化任何文件**
-- 不修改任何代码、配置、SQL
-- git/构建 命令通过 `powershell.exe -Command "..."` 执行（裸 Bash 被 hook 拒绝，已列入 disallowedTools）
-- 禁止通过 `Bash(codegraph *)` 调用 codegraph 命令行——必须用 MCP 工具 `mcp__codegraph__codegraph_*`
-
-## 最终输出契约
-
-在你的最后一条消息中，以纯文本 Markdown 输出完整审查报告正文，不得仅输出工具调用摘要或元数据。

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

@@ -1,215 +0,0 @@
----
-name: harness-archive
-description: "归档所有变更产出（计划/测试报告/审查/SQL/API文档）到 .harness/archive/，含归档元数据和可视化最终总结。使用场景：归档、完成归档、收尾、打包产出物"
-argument-hint: "变更名或留空自动检测"
-effort: medium
-allowed-tools: [Bash(powershell.exe:*), Read, Write, Edit, Glob, Grep]
-disallowed-tools:
-  - Bash(git *)
-  - Bash(mvn *)
-  - Bash(ls *)
-  - Bash(find *)
-  - Bash(grep *)
-  - Bash(cat *)
-  - Bash(cp *)
-  - Bash(mv *)
-  - Bash(rm *)
-  - Bash(mkdir *)
-  - Bash(touch *)
-  - Bash(sed *)
-  - Bash(awk *)
-  - Bash(curl *)
----
-<!-- generated by harness_deploy.py; core=3797d93d2cf363a9; overlay=none; agent=claude-code; do not edit -->
-# harness-archive — 变更归档
-
-## Purpose
-
-将 `.harness/changes/<change-name>/` 的所有产出移入 `.harness/archive/YYYY-MM-DD-<change-name>/`，生成归档元数据和可视化最终报告，释放工作区。
-
-## When to Use
-
-使用场景：
-
-- 用户说"归档 / 完成归档 / 收尾 / 打包产出物"。
-- submit 已推送、test/review 报告已就绪（或已明确标记跳过/未运行），需要封存变更产出。
-- 变更闭环最后一站，归档后从工作区移除 `.harness/changes/<change-name>/`。
-
-跳过场景：
-
-- 变更尚未 submit 推送（归档前 commit 必须已 push）。
-- 仍存在未结清的 test/review 验证（除非已明确标记 CONDITIONAL_OK）。
-
-自动调用边界：
-
-- 归档涉及移动/删除原变更目录，支持被其他 skill 调用，但调用前必须确保前置条件已满足；也支持用户显式 `/harness-archive` 调用。
-- 归档前确认是强制阻断检查点，用户拒绝 → 终止流程，不执行任何操作。
-
-## 前置条件
-
-- commit 已 push（`git log @{u}..HEAD` 输出为空）
-- **最终 hash 来源**：worktree 模式（`meta/worktree.json` requested=true）下读 ledger 的 `mergeFinalHash`（由 `/harness-submit` 合并段写入）；主目录模式读 submit 的 `final pushed hash`。当前 `git rev-parse HEAD` 须一致
-- test 报告存在或标记"跳过"；review 报告存在或标记"未运行 review"（review 不阻塞归档）
-
-## Inputs
-
-- `$ARGUMENTS`：变更名（可选，留空时 Glob `.harness/changes/*/plans/*-plan.md` 自动检测，排除 `.harness/archive/`）
-- 相关文件：`.harness/changes/<change-name>/logs/execution-log.md`、`.harness/changes/<change-name>/events.ndjson`、`evidence/verification-ledger.json`、各阶段 reports/
-
-## 统一读取协议
-
-1. **`.harness/changes/<change-name>/` 是唯一真相源** — 所有输入从该目录读取，产物写入对应子目录
-2. **change-name 优先从 frontmatter 读取** — `spec/*-design.md`、`plans/*-plan.md` 的 YAML `change-name`
-3. **frontmatter 缺失时兼容旧格式** — 从路径推断，标记 `🟡 legacy-plan`，不失败
-4. **spec** — 设计真相源：`spec/<change>-design.md`
-5. **plan** — 任务真相源：`plans/<change>-plan.md`
-6. **implementation-detail** — 自适应执行参考；legacy 缺失 🟡WARN，不阻断
-7. **test-scenarios** — 测试真相源：`plans/<change>-test-scenarios.md`
-8. **禁止读取 `docs/superpowers/` 作为正式输入** — 旧草稿仅人工线索
-
-状态目录分层：新路径优先，旧路径兼容 → [[../protocols/state-layout-protocol.md|state-layout-protocol]]
-
-## Workflow
-
-### Phase 0：读取规则和上下文
-
-1. 读取本文件。
-2. 按需读取 `reference.md`（归档流程、manifest、summary-data、final-summary 渲染、目录结构与最终状态规则）。
-3. 读取共用约束：
-   - `../protocols/archive-report-protocol.md`
-   - `../protocols/state-layout-protocol.md`
-   - `../protocols/powershell-protocol.md`
-   - `../protocols/sensitive-info-protocol.md`
-   - `../protocols/evidence-based-reporting-protocol.md`
-   - `../protocols/report-pipeline-protocol.md`
-4. 解析 `$ARGUMENTS`：留空时 Glob 自动检测未归档变更，排除 `.harness/archive/`。
-
-### Phase 1：确认归档对象（扫描未归档变更）
-
-用 Glob 搜索 `.harness/changes/*/plans/*-plan.md`（排除 `.harness/archive/`），展示变更概要。
-
-- **Read `checklist.md`** — 归档前检查项
-- 发现多个未归档变更 → 让用户选择或终止
-
-### Phase 2：确认归档 ⚠️ 强制阻断
-
-AskUserQuestion 让用户确认归档操作。**用户拒绝 → 终止流程，不执行任何操作。**
-
-- **Read `reference.md`** — 确认对话框的内容格式
-
-### Phase 3：执行归档
-
-1. append `phase.start` 事件。
-2. 运行 `python <skills-root>/scripts/harness_archive.py status --change-dir ".harness/changes/<change-name>" --json` 前置检查。
-3. 运行 `python <skills-root>/scripts/harness_archive.py finalize --change-dir ".harness/changes/<change-name>" --archive-root ".harness/archive" --json`；读 JSON（移动、collect、render、validate、manifest 比对）。**finalize 不再同步执行知识维护**（§8.2）：它写一个 `pending` maintenance-outbox 项即返回，`knowledgeMaintenance=QUEUED`；写 outbox 失败时 `NOT_QUEUED`（warning，不回滚 archive，总状态 CONDITIONAL）。后续由 `harness-sync` / `harness_knowledge.py maintain` 异步推进 outbox。
-4. 模型补写 `meta/archive-meta.md` 的维护者结论 / knownRisks / manualActions（脚本占位字段）。
-5. append `phase.end` 事件。**finalize 失败或 validate 报错时不删除原目录**。
-
-- **Read `reference.md`** — finalize 输出字段、archive-meta 格式、CONDITIONAL_OK 规则
-- **Read `templates/summary-data-template.json`** — summary-data 数据结构
-- **Read `templates/render-summary.mjs`** — final-summary 渲染脚本（finalize 内嵌调用）
-
-### Phase 4：验证与提示
-
-验证归档目录完整 → 提示用户归档完成。
-
-- **Read `checklist.md`** — 归档后验证项
-
-## P0 执行可信度规则
-
-- 命令结果不得靠猜测；普通 Bash 被拒 → 立即改用等价 PowerShell 重试一次
-- 仅 PowerShell 成功且有明确证据（构建/git/测试输出、文件存在、exit 0）时可标 ✅OK；否则 ❌FAIL 或 🟡WARN
-- 禁止把 hook 拒绝、静态验证、无输出、用户跳过说成成功 → 详见 [[../protocols/powershell-protocol.md|powershell-protocol]]、[[../protocols/evidence-based-reporting-protocol.md|evidence-based-reporting-protocol]]
-
-## 关键规则（硬门禁速查）
-
-> 每条规则的详细判定、模板见 `reference.md` 对应章节；归档报告协议见 `../protocols/archive-report-protocol.md`，Shell 执行安全见 `../protocols/powershell-protocol.md`，敏感信息见 `../protocols/sensitive-info-protocol.md`，证据化报告见 `../protocols/evidence-based-reporting-protocol.md`，状态目录见 `../protocols/state-layout-protocol.md`。
-
-### 一、同一时间最多 1 个未归档变更
-
-扫描排除 `.harness/archive/`；多个未归档变更 → 让用户选择或终止，不批量归档。
-
-### 二、归档前确认是强制阻断检查点
-
-AskUserQuestion 确认；用户拒绝 → 终止，不执行任何操作。
-
-### 三、文件移动只用内置工具或 PowerShell
-
-移动用 Read+Write+验证 或 PowerShell；**禁止 Bash mv/cp/rm**。移动失败时不删除原目录，报错退出让用户手动处理。
-
-### 四、数据化归档门禁（先数据后渲染）
-
-必须通过 `harness_archive.py finalize` 生成 `reports/final/summary-data.json` 与 `final-summary.html` 并完成 validate；**禁止模型临场写 500+ 行 HTML**。统计数字只能来自 summary-data、events、ledger 或 manifest。详见 `../protocols/report-pipeline-protocol.md`、`../protocols/archive-report-protocol.md`、`reference.md`。
-
-### 五、manifest/checksum 必须存在
-
-归档前后生成 `evidence/archive-manifest-before.json` / `archive-manifest-after.json`（path/size/sha256），before/after 不一致时**不得删除原目录**。复杂 PowerShell 写入 `scripts/*.ps1` 后 `-File` 执行，禁止内联 `$` / `$_` / `@{}`。详见 `reference.md`。
-
-### 六、归档前确认四项（缺一不可）
-
-- commit 已 push（`git log @{u}..HEAD` 输出为空）
-- **final hash 来源**：worktree 模式（requested=true）下读 ledger `mergeFinalHash`（submit 合并段）；否则读 submit 日志 `final pushed hash`。当前 HEAD 须一致
-- test 报告存在，或标记"跳过"/"未运行测试"
-- review 报告：存在则作 📝ADVISORY 归档材料；不存在标记"📝ADVISORY：未运行 review"（review 不阻塞归档）
-
-### 七、verification-ledger 汇总状态
-
-归档前读 `evidence/verification-ledger.json`，提取各阶段 status、postTestClassification、复用关系，供 final-summary 真实展示状态演进。若 ledger 有 `postTestClassification`，final-summary 必须展示该分类及对应的复用/重测决策。
-
-### 八、final-summary 不得伪造且必须展示状态演进
-
-无测试报告 → 显示"未运行测试 / 静态验证"，不得 100% 通过率；无 review → "📝ADVISORY：未运行 review"。状态用 ✅OK / 🟡WARN / 🔁REUSED / 🔁RETESTED / 📝ADVISORY / 🧹NON_BEHAVIORAL_CLEANUP，复用前一阶段结果显示 🔁REUSED，**不得伪装成重新执行，不得无脑全绿**。
-
-**final-summary 必须产出**：Node 渲染器不可用/超时/exit 非 0/未产出文件时，`harness_archive.py` 自动用内置 Python fallback 渲染（含 changeName/finalStatus/commands/verification/changedFiles/archiveManifest/knownRisks/manualActions/maintenanceNotes，USER_SKIPPED/BLOCKED_BY_DBA/失败状态可见，全部 HTML 转义）。Node 与 Python fallback **都失败**时，finalize 立即恢复原 change 目录并 exit 非 0，**绝不归档一个没有 final-summary.html 的变更**。
-
-### 九、CONDITIONAL_OK 最终状态
-
-API 测试 `USER_SKIPPED` 或 DB 兼容 `BLOCKED_BY_DBA` 时，最终状态必须是 `CONDITIONAL_OK`，不能显示纯 `OK`。
-
-### 十、未提交测试文件归档
-
-未提交但用于验证的测试文件必须归档到 `backups/uncommitted-tests/` 并在 final-summary 中展示。
-
-### 十一、phase.start 事件前置
-
-阶段 0 之前必须先 append `phase.start` 事件（`harness_events.py append`）；不得等归档完成才补。归档后 events.ndjson 与自动渲染的 execution-log.md 一起移入 archive。
-
-### 十二、Shell 安全 / 敏感信息 / 证据化报告
-
-git 命令通过 `powershell.exe -Command "..."` 执行；archive-meta.md 和 final-summary.html 不得含明文 token/密码/密钥；归档报告必须区分 ✅真实成功 / 🟡跳过·静态验证 / ❌失败。
-
-## Output Format
-
-> 归档元数据格式见 `reference.md` 的 archive-meta 模板；最终报告由 `templates/summary-data-template.json` 数据结构 + `templates/render-summary.mjs` 固定脚本渲染。
-
-产出文件：
-
-- `.harness/archive/YYYY-MM-DD-<change-name>/meta/archive-meta.md` — 归档元数据
-- `.harness/archive/YYYY-MM-DD-<change-name>/events.ndjson` — 结构化事件层（新流程推荐；旧 archive 可缺失）
-- `.harness/archive/YYYY-MM-DD-<change-name>/reports/final/summary-data.json` — 最终报告数据源
-- `.harness/archive/YYYY-MM-DD-<change-name>/reports/final/final-summary.html` — 由 `render-summary.mjs` 渲染（Node 不可用或失败时由 `harness_archive.py` 内置 Python fallback 渲染）；**始终必须存在**，否则 finalize 恢复原 change 目录并 exit 非 0
-- `.harness/archive/YYYY-MM-DD-<change-name>/evidence/archive-manifest-before.json` / `archive-manifest-after.json` — 归档前后 manifest/checksum
-
-## 渐进披露
-
-- **Read `checklist.md`** 仅在 Phase 1 归档前检查和 Phase 4 验证时 — 含归档前检查项和归档后验证项
-- **Read `reference.md`** 仅在 Phase 0/2/3 时 — 含归档流程、archive-meta 格式、summary-data 字段说明、final-summary 渲染规则、目录结构与最终状态规则
-- **Read `reference.md`** 仅在 Phase 3 finalize 时 — summary-data、final-summary 校验与 archive-meta 补写
-- **Read `templates/summary-data-template.json`** 仅在 Phase 3 生成 `summary-data.json` 时 — 含最终报告数据结构
-- **Read `templates/render-summary.mjs`** 仅在 Phase 3 渲染 `final-summary.html` 时 — 固定 HTML 渲染脚本
-
-## 交互白名单
-
-**仅允许**归档确认（Phase 2 AskUserQuestion）；拒绝 → 终止，不执行任何移动。
-
-## 执行日志
-
-`events.ndjson` 为唯一事实源（schema_version 2，`note` 承载人类可读摘要）；`logs/execution-log.md` 由 `harness_events.py` 渲染，**禁止手工 Edit**。结构 → [[../protocols/report-pipeline-protocol.md|report-pipeline-protocol]]
-
-```powershell
-python <skills-root>/scripts/harness_events.py append --change-dir ".harness/changes/<change-name>" --phase <phase> --type phase.start --note "<触发指令>"
-```
-
-> **脚本接线**：`harness_events.py append`；`harness_archive.py finalize`；`harness_preflight.py check`；`harness_ledger.py can-reuse`；`harness_service.py ensure/stop`（须 `--files`/`serviceStart.inputFiles`）。JSON 输出按 D13 护栏解读。
-
-> **Task 4 §6.1 写入契约**：普通 `append` = 加锁 -> 追加一行 -> fsync -> 解锁，**不 load 历史、不渲染**（O(1)，跨进程锁 `events.ndjson.lock`，UUID 用完整 `uuid4().hex` 无需去重扫描）。仅 `--type phase.end` append 在追加成功后渲染一次 `execution-log.md`；显式 `harness_events.py render` 随时从完整 events 重建；`harness_archive.py finalize` 在 collect 前强制 render 一次。高频 command append 期间 log 可能滞后，phase 边界保持最新。

package/resources/harness/bundles/general/claude-code/harness-archive/checklist.md

@@ -1,52 +0,0 @@
----
-description: harness-archive 的归档前检查项和归档后验证项。仅在 Phase 1 检查和 Phase 4 验证时读取。
----
-
-# harness-archive 检查清单
-
-## P0 数据化归档门禁
-
-归档遵循 `../protocols/archive-report-protocol.md`，门禁要点见 SKILL.md `## 关键规则` 四/五/九：
-
-- 先写 `reports/final/summary-data.json`，再渲染 `reports/final/final-summary.html`。
-- 归档前生成 `evidence/archive-manifest-before.json`，移动后生成 `archive-manifest-after.json`。
-- final-summary 的统计只能来自 summary-data 或 manifest。
-- before/after checksum 不一致时，不得删除原目录。
-- 默认渲染器 `templates/render-summary.mjs`（finalize 内嵌调用）。
-
-## 归档前检查（Phase 1）
-
-> ⚠️ **phase.start 前置**：在归档前检查的第一项前，必须先 append `phase.start` 事件（见 SKILL.md `## 执行日志`）。不得等归档完成才补。
-
-- [ ] 已 append `phase.start` 事件（`harness_events.py append --change-dir ".harness/changes/<change-name>"`）
-- [ ] 只有一个未归档变更目录（多个时终止或让用户选择）
-- [ ] 变更目录下有 plans/ 子目录（至少有计划文件）
-- [ ] `logs/execution-log.md` 存在（需要追加归档记录；新路径缺失时兼容根目录 `execution-log.md`）
-- [ ] 准备生成 `archive-manifest-before.json`（path/size/sha256）
-- [ ] 准备生成 `summary-data.json`（业务目标、阶段状态、验证、产物、维护者结论）
-- [ ] git status 无未提交的重要变更（归档应对应已提交的代码）
-- [ ] **commit 已 push**：`powershell.exe -Command "git -C '<项目路径>' log @{u}..HEAD --oneline"` 输出为空（无未推送提交）
-- [ ] **最终 hash 一致**：worktree 模式（requested=true）下读 `evidence/verification-ledger.json` 的 `mergeFinalHash`（submit 合并段写入），否则从 events/ledger 读取 `final pushed hash`，与当前 `git rev-parse HEAD` 比对
-- [ ] **test/review 报告状态确认**：
-  - ✅ `.harness/changes/<change-name>/tests/test-report-*.md` 存在 → 归档正常
-  - 🟡 不存在 → 必须在 archive-meta.md 和 final-summary.html 中标记"跳过测试"或"未运行测试"，不得伪造通过率
-  - ✅ `.harness/changes/<change-name>/reports/review/review-report-*.md` 存在（旧路径 `reviews/review-report-*.md` 兼容回退）→ 作为 📝ADVISORY 归档材料
-  - 📝 `.harness/changes/<change-name>/reports/review/fixback-*.md` 存在 → 随 review 报告一并归档；默认 advisory，除非 `strict-review-gate=true`
-  - 🟡 不存在但 `logs/execution-log.md` 有 harness-review 小节 → **review 已运行但未落盘**（harness-review `context:fork` 交接缝常见，见 `agent/case-candidates/2026-06-30-harness-review-forked-not-persisting-report.md`）：从 execution-log/会话补落盘到 `reports/review/review-report-YYYYMMDD-HHmm.md` 再归档，**不得误标"未运行 review"**（实际跑过）
-  - 🟡 不存在且 execution-log 无 review 小节 → 在 archive-meta.md 和 final-summary.html 中标记"📝ADVISORY：未运行 review"
-
-## 归档后验证（Phase 4）
-
-- [ ] `.harness/archive/YYYY-MM-DD-<change-name>/` 目录存在（通过 Glob 实际扫描确认）
-- [ ] 所有子目录（plans/, tests/, reviews/, sqls/）已完整移入（通过 Glob 实际扫描确认，不仅看预期路径）
-- [ ] before/after manifest 校验通过（排除 `logs/execution-log.md`——归档追加结束记录预期 sha256 变化；其他 moved 文件 sha256 必须一致，missing/mismatch=0）
-- [ ] archive-meta.md 已创建，frontmatter 字段完整
-- [ ] summary-data.json 已生成，且为合法 JSON
-- [ ] final-summary.html 已由 `templates/render-summary.mjs` 渲染生成
-- [ ] **final-summary.html 真实性检查**：
-  - 无测试报告时，`summary-data.json.verification.unitTests.status` / `summary-data.json.verification.apiTests.status` 必须标记为 `NOT_RUN`、`USER_SKIPPED`、`BLOCKED` 或 `STATIC_ONLY`，不得显示 100%
-  - 无 review 报告时，`summary-data.json.reviewSummary.status` 必须标记为 `ADVISORY_NOT_RUN`，不得显示 100%
-  - 跳过、复用、人工确认的部分必须明确标记，不伪装成 ✅
-  - final-summary.html 中不得残留 `{{...}}` 占位符
-- [ ] 原目录 `.harness/changes/<change-name>/` 已删除（仅在前面所有验证通过后）
-- [ ] .harness/ 下无残留未归档变更目录

package/resources/harness/bundles/general/claude-code/harness-archive/reference.md

@@ -1,103 +0,0 @@
----
-description: harness-archive 的归档流程、manifest、summary-data、final-summary 渲染、目录结构与最终状态规则。
----
-
-# harness-archive 参考
-
-## 归档流程（对齐 SKILL.md Workflow）
-
-- **Phase 0 读取上下文**：读 SKILL.md / 本文件 / 共用协议（`../protocols/archive-report-protocol.md`、`../protocols/report-pipeline-protocol.md`、`../protocols/state-layout-protocol.md`、`../protocols/powershell-protocol.md`、`../protocols/sensitive-info-protocol.md`、`../protocols/evidence-based-reporting-protocol.md`）/ 解析 `$ARGUMENTS`。
-- **Phase 1 确认归档对象**：Glob `.harness/changes/*/plans/*-plan.md`（排除 archive），展示概要；多变更让用户选择或终止。
-- **Phase 2 确认归档（强制阻断）**：AskUserQuestion 确认，拒绝即终止。
-- **Phase 3 执行归档**：
-  1. append `phase.start` 事件（`harness_events.py append`）。
-  2. 运行 `python <skills-root>/scripts/harness_archive.py status --change-dir ... --json` 做前置检查。
-  3. 运行 `python <skills-root>/scripts/harness_archive.py finalize --change-dir ... --archive-root ".harness/archive" --json`；读 JSON 结果。
-  4. 模型补写 `meta/archive-meta.md` 的 `maintenanceNotes` / `knownRisks` / `manualActions`（脚本留空占位）。
-  5. append `phase.end` 事件。**finalize 报错或 validate 失败时不删除原 changes 目录**。
-- **Phase 4 验证与提示**：见 `checklist.md` 归档后验证项。
-
-## manifest 生成
-
-manifest 每项包含：
-
-```json
-{"path":"...","size":123,"sha256":"...","lastModified":"..."}
-```
-
-建议使用固定脚本，禁止内联复杂 PowerShell（包含 `$`、`$_`、`@{}`、script block、管道 JSON 输出）：
-
-```powershell
-powershell.exe -NoProfile -ExecutionPolicy Bypass -File "harness-skills/harness-archive/scripts/gen-manifest.ps1" -RootPath ".harness/changes/<change>" -OutputPath ".harness/changes/<change>/evidence/archive-manifest-before.json"
-```
-
-移动到 archive 目录后，再生成 after manifest：
-
-```powershell
-powershell.exe -NoProfile -ExecutionPolicy Bypass -File "harness-skills/harness-archive/scripts/gen-manifest.ps1" -RootPath ".harness/archive/<date-change>" -OutputPath ".harness/archive/<date-change>/evidence/archive-manifest-after.json"
-```
-
-**校验 before/after 时排除 execution-log**（通用）：`logs/execution-log.md` 在归档过程会追加结束记录（Phase 4），before（移动前含开始记录）与 after（含开始+结束记录）sha256 必然不同——这是预期追加，非文件损坏。校验脚本需跳过 `logs/execution-log.md`，其他 moved 文件 sha256 必须一致；若其他文件 missing/mismatch，才表示移动损坏，不得删除原目录。
-
-## summary-data.json 与 harness_archive.py
-
-默认由 `harness_archive.py finalize`（或 `replay`）生成/校验 `reports/final/summary-data.json`；CLI 不可用时按 `../protocols/report-pipeline-protocol.md` 与 `templates/summary-data-template.json`（schemaVersion 2.2）生成等价数据。必须保留原 final report 维度。必须包含：
-
-- `businessGoal`：本次变更为了做什么；
-- `stageStatus`：plan/run/test/review/submit/archive；
-- `diffStat`：filesChanged/insertions/deletions/range —— 来自 `git diff --numstat` + `git diff --stat <base>..<head>`，不得手写；
-- `durations`：totalMinutes + stages[{stage,skill,startedAt,endedAt,minutes,result}] —— 从 `logs/execution-log.md` 各 `[N] harness-<skill>` 小节的 `开始`/`结束`/`耗时` 解析；
-- `skillCalls`：每个 skill 的调用次数（含重入）+ 结果 —— 从 execution-log 统计；
-- `verification`：单元/API/覆盖展示，含 passRate —— 来自 `evidence/verification-ledger.json`；
-- `changedFiles`：path/summary/insertions/deletions —— 来自 `git diff --numstat <base>..<head>`；
-- `reviewSummary`：red/yellow + redFixed/redConfirmed/yellowFixed/yellowDeferred 修复进度；
-- `maintenanceNotes`：给后续维护者看的结论；
-- `knownRisks`：剩余风险或人工确认项。
-
-报告必须突出业务目标和维护者结论。所有统计数字只能来自 events、summary-data、ledger 或 manifest，不得手写另一套。历史 archive 没有 `events.ndjson` 时，允许从 ledger/log/manifest 回放，并在 `reportPipeline.sources` 中记录来源。
-
-## final-summary 渲染
-
-默认使用 Node.js 渲染器：
-
-```powershell
-powershell.exe -NoProfile -Command "& '<node-path>' 'harness-skills/harness-archive/templates/render-summary.mjs' --summary '.harness/archive/<date-change>/reports/final/summary-data.json' --out '.harness/archive/<date-change>/reports/final/final-summary.html'"
-```
-
-如模板脚本位于 skill 目录，则先复制到 archive 目录或直接引用 skill 路径。
-
-禁止模型临场手写大段 HTML。确需临时修 HTML，只能修模板，不得让统计数字脱离 `summary-data.json`。
-
-渲染后必须执行：
-
-```powershell
-powershell.exe -NoProfile -Command "npx hunter-harness report validate --change-id '<date-change>' --json"
-```
-
-存在 validate error 时，不得删除原 `.harness/changes/<change>` 目录。
-
-## archive-meta.md 模板
-
-```markdown
-# Archive Meta — <change-name>
-
-- archivedAt: YYYY-MM-DD HH:mm
-- finalCommit: <hash>
-- sourceDir: .harness/changes/<change-name>
-- archiveDir: .harness/archive/YYYY-MM-DD-<change-name>
-- movedFiles: <from manifest>
-- generatedFiles: archive-meta.md, summary-data.json, final-summary.html, manifests
-- totalArchiveFiles: <from after manifest>
-```
-
-## 目录结构与最终状态规则
-
-- 默认渲染器：`templates/render-summary.mjs`，输入 `reports/final/summary-data.json`，输出 `reports/final/final-summary.html`。
-- `render-summary.mjs` 是默认 UTF-8 渲染器；finalize 内嵌调用，不得由模型临场写 HTML。
-- 新路径优先：`meta/`、`logs/`、`evidence/`、`reports/final/`、`scripts/`、`backups/uncommitted-tests/`。旧路径只做读取兼容，不再写大量根目录文件。
-- 当 `summary-data.json.verification.apiTests.status=USER_SKIPPED` 或 `verification.dbCompatibility.status=BLOCKED_BY_DBA`，最终状态必须是 `CONDITIONAL_OK`。
-- 复杂 PowerShell 命令写入 `scripts/*.ps1` 后 `-File` 执行，禁止内联 `$` / `$_`。
-
-## 执行日志记录
-
-归档只向 `events.ndjson` 追加事件（schema_version 2）；`logs/execution-log.md` 由 `harness_events.py append` 自动渲染，禁止手工 Edit。事件类型与脚本用法见 SKILL.md `## 执行日志` 与 `../protocols/report-pipeline-protocol.md`。

package/resources/harness/bundles/general/claude-code/harness-archive/scripts/gen-manifest.ps1

@@ -1,31 +0,0 @@
-param(
-  [Parameter(Mandatory=$true)][string]$RootPath,
-  [Parameter(Mandatory=$true)][string]$OutputPath
-)
-
-$ErrorActionPreference = 'Stop'
-$root = (Resolve-Path $RootPath).Path
-# 排除 OutputPath 自身：重新生成 manifest 时旧 manifest 文件会被扫到，导致递归（新 manifest 含旧 manifest 的 sha256，fileCount 虚高 +1）。
-# OutputPath 不存在时（首次生成）$excludePath=$null，Where-Object 不过滤。
-$excludePath = $null
-if (Test-Path $OutputPath) {
-  $excludePath = (Resolve-Path $OutputPath).Path
-}
-$items = Get-ChildItem -Path $root -File -Recurse | Where-Object { $excludePath -eq $null -or $_.FullName -ne $excludePath } | Sort-Object FullName | ForEach-Object {
-  $relative = $_.FullName.Substring($root.Length).TrimStart('\','/') -replace '\\','/'
-  $hash = Get-FileHash -Path $_.FullName -Algorithm SHA256
-  [PSCustomObject]@{
-    path = $relative
-    sizeBytes = $_.Length
-    sha256 = $hash.Hash.ToLowerInvariant()
-  }
-}
-$result = [PSCustomObject]@{
-  root = $root
-  generatedAt = (Get-Date).ToString('s')
-  fileCount = @($items).Count
-  totalBytes = (@($items) | Measure-Object -Property sizeBytes -Sum).Sum
-  files = @($items)
-}
-$utf8NoBom = New-Object System.Text.UTF8Encoding($false)
-[System.IO.File]::WriteAllText((Resolve-Path (Split-Path $OutputPath -Parent)).Path + [System.IO.Path]::DirectorySeparatorChar + (Split-Path $OutputPath -Leaf), ($result | ConvertTo-Json -Depth 8), $utf8NoBom)