hunter-harness 0.1.0 → 0.1.2

package/resources/harness/java/harness-codebase-map/SKILL.md

@@ -1,112 +1,112 @@
----
-name: harness-codebase-map
-description: "分析现有代码库并生成 .harness/codebase/map/ 下的结构化代码库地图。用于陌生项目理解、重大改造前梳理、harness-sync 提示 map 过期后的人工刷新。"
-argument-hint: "[--fast] [--focus tech|arch|quality|concerns|tech+arch] [--paths <p1,p2,...>] [--status|--diff|--refresh]"
-effort: high
-allowed-tools: [Read, Glob, Grep, Write, Edit, Agent, Bash(powershell.exe:*)]
-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=8917528f7dfdc5ca; overlay=java; do not edit -->
-# harness-codebase-map — 代码库地图
-
-## Purpose
-
-生成 hunter-harness 自有代码库地图 → `.harness/codebase/map/`（7 类文档）+ `map-summary.md` + `map-manifest.json`。供 plan/run/review 快速理解项目结构。
-
-## 核心边界
-
-- **只写** `.harness/codebase/map/`、`map-summary.md`、`map-manifest.json`、`.harness/reports/codebase-map-*.md`
-- **禁止** `.planning/`、Git 写操作、修改 `.codegraph/`、自动 commit/push
-- `harness-sync` 只**建议**刷新，不自动跑全量 map
-
-## When to Use
-
-首次接入、map 过期（sync 提示）、大型重构前、用户说「刷新 codebase map」。跳过：空项目（<5 源文件）、纯符号查询（用 CodeGraph）。
-
-## Arguments
-
-| 参数 | 含义 |
-|------|------|
-| （无） | 全量 7 文档 |
-| `--fast` | STACK + STRUCTURE + CONCERNS |
-| `--focus *` | tech / arch / quality / concerns / tech+arch |
-| `--paths p1,p2` | 增量路径（非法路径 → WARN，全非法须确认） |
-| `--status` / `--diff` | 只检查，不刷新 |
-| `--refresh` | 显式全量刷新 |
-
-## Workflow（薄编排）
-
-| Phase | 动作 |
-|-------|------|
-| 0 | 读 SKILL + `reference.md` / `checklist.md` / `templates/` + protocols |
-| 1 | 解析 `$ARGUMENTS` → 模式与扫描范围 |
-| 2 | 检查现有 map / manifest → `--status` 可在此结束 |
-| 3 | `New-Item` 确保输出目录（PowerShell，禁止 Bash mkdir） |
-| 4 | Glob/Grep/Read 扫描；git 只读查询经 PowerShell |
-| 5 | 写 7 文档（`templates/` + frontmatter）— 可并行 mapper agents |
-| 6 | 写 summary + manifest（schema → `templates/map-manifest.schema.json`） |
-| 7 | 更新 `.harness/context-index.json` codebase 入口（若存在） |
-| 8 | 控制台 + `.harness/reports/codebase-map-*.md` 报告 |
-
-逐步细节、frontmatter 字段、git 允许列表 → `reference.md` / `checklist.md`
-
-## Mapper Agent 策略
-
-优先并行 mapper（tech/arch/quality/concerns）；Agent 直写文档，主会话汇总。不可用 → 主会话顺序扫描 + 🟡WARN。
-
-## 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]]
-
-## 关键规则
-
-| # | 规则 |
-|---|------|
-| 1 | 唯一输出 `.harness/codebase/map/` |
-| 2 | `generated_reviewable`，不建议手工改 map 正文 |
-| 3 | 不 Git 写操作、不改业务代码 |
-| 4 | 不管理 CodeGraph |
-| 5 | 敏感信息脱敏 → `sensitive-info-protocol` |
-| 6 | 证据化输出 → `evidence-based-reporting-protocol` |
-
-## Output Format
-
-模式、范围、7/7 文档路径与行数、manifest/summary、context-index 状态、WARN/FAIL → `reference.md` 报告模板
-
-## 渐进披露
-
-- **Read `checklist.md`** — 执行前后检查
-- **Read `reference.md`** — manifest、mapper、扫描模式
-- **Read `templates/*`** — 各文档模板
-
-## 交互白名单
-
-**无** AskUserQuestion；参数/默认值 + `decision` 事件
-
-## 执行日志
-
-`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 边界保持最新。
+---
+name: harness-codebase-map
+description: "分析现有代码库并生成 .harness/codebase/map/ 下的结构化代码库地图。用于陌生项目理解、重大改造前梳理、harness-sync 提示 map 过期后的人工刷新。"
+argument-hint: "[--fast] [--focus tech|arch|quality|concerns|tech+arch] [--paths <p1,p2,...>] [--status|--diff|--refresh]"
+effort: high
+allowed-tools: [Read, Glob, Grep, Write, Edit, Agent, Bash(powershell.exe:*)]
+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=47a5159f5c4b49b8; overlay=java; do not edit -->
+# harness-codebase-map — 代码库地图
+
+## Purpose
+
+生成 hunter-harness 自有代码库地图 → `.harness/codebase/map/`（7 类文档）+ `map-summary.md` + `map-manifest.json`。供 plan/run/review 快速理解项目结构。
+
+## 核心边界
+
+- **只写** `.harness/codebase/map/`、`map-summary.md`、`map-manifest.json`、`.harness/reports/codebase-map-*.md`
+- **禁止** `.planning/`、Git 写操作、修改 `.codegraph/`、自动 commit/push
+- `harness-sync` 只**建议**刷新，不自动跑全量 map
+
+## When to Use
+
+首次接入、map 过期（sync 提示）、大型重构前、用户说「刷新 codebase map」。跳过：空项目（<5 源文件）、纯符号查询（用 CodeGraph）。
+
+## Arguments
+
+| 参数 | 含义 |
+|------|------|
+| （无） | 全量 7 文档 |
+| `--fast` | STACK + STRUCTURE + CONCERNS |
+| `--focus *` | tech / arch / quality / concerns / tech+arch |
+| `--paths p1,p2` | 增量路径（非法路径 → WARN，全非法须确认） |
+| `--status` / `--diff` | 只检查，不刷新 |
+| `--refresh` | 显式全量刷新 |
+
+## Workflow（薄编排）
+
+| Phase | 动作 |
+|-------|------|
+| 0 | 读 SKILL + `reference.md` / `checklist.md` / `templates/` + protocols |
+| 1 | 解析 `$ARGUMENTS` → 模式与扫描范围 |
+| 2 | 检查现有 map / manifest → `--status` 可在此结束 |
+| 3 | `New-Item` 确保输出目录（PowerShell，禁止 Bash mkdir） |
+| 4 | Glob/Grep/Read 扫描；git 只读查询经 PowerShell |
+| 5 | 写 7 文档（`templates/` + frontmatter）— 可并行 mapper agents |
+| 6 | 写 summary + manifest（schema → `templates/map-manifest.schema.json`） |
+| 7 | 更新 `.harness/context-index.json` codebase 入口（若存在） |
+| 8 | 控制台 + `.harness/reports/codebase-map-*.md` 报告 |
+
+逐步细节、frontmatter 字段、git 允许列表 → `reference.md` / `checklist.md`
+
+## Mapper Agent 策略
+
+优先并行 mapper（tech/arch/quality/concerns）；Agent 直写文档，主会话汇总。不可用 → 主会话顺序扫描 + 🟡WARN。
+
+## 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]]
+
+## 关键规则
+
+| # | 规则 |
+|---|------|
+| 1 | 唯一输出 `.harness/codebase/map/` |
+| 2 | `generated_reviewable`，不建议手工改 map 正文 |
+| 3 | 不 Git 写操作、不改业务代码 |
+| 4 | 不管理 CodeGraph |
+| 5 | 敏感信息脱敏 → `sensitive-info-protocol` |
+| 6 | 证据化输出 → `evidence-based-reporting-protocol` |
+
+## Output Format
+
+模式、范围、7/7 文档路径与行数、manifest/summary、context-index 状态、WARN/FAIL → `reference.md` 报告模板
+
+## 渐进披露
+
+- **Read `checklist.md`** — 执行前后检查
+- **Read `reference.md`** — manifest、mapper、扫描模式
+- **Read `templates/*`** — 各文档模板
+
+## 交互白名单
+
+**无** AskUserQuestion；参数/默认值 + `decision` 事件
+
+## 执行日志
+
+`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/java/harness-codebase-map/templates/map-summary.md

@@ -16,9 +16,9 @@ status: active
 
 # Codebase Map Summary
 
-**Generated At:** <YYYY-MM-DD HH:mm>  
-**Mode:** <full|fast|focus|paths|status|diff>  
-**Profile:** <profile-or-unknown>  
+**Generated At:** <YYYY-MM-DD HH:mm>
+**Mode:** <full|fast|focus|paths|status|diff>
+**Profile:** <profile-or-unknown>
 **Commit:** <sha-or-unknown>
 
 ## Project Snapshot