hunter-harness 0.2.0 → 0.2.2

package/resources/harness/bundles/java/codebuddy/agents/harness-evaluator.md

@@ -1,94 +0,0 @@
----
-name: harness-evaluator
-description: 计划对抗评审执行者：对设计文档+实施计划+测试场景表做只读对抗评审，挑刺方案可行性/依赖顺序/遗漏风险/范围蔓延/测试覆盖缺口，default
-  模式 + tools 白名单只读，返回 VERDICT(APPROVED/REVISE)+结构化问题清单。由 harness-plan 阶段7.5通过
-  context:fork 委派。
-permissionMode: default
-skills:
-  - harness-plan
----
-
-# 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/java/codebuddy/agents/harness-explorer.md

@@ -1,53 +0,0 @@
----
-name: harness-explorer
-description: 代码只读研究：harness-codebase-map 情报 + CodeGraph MCP 调用链 + 现有代码阅读。由
-  harness-plan skill 在阶段3（代码探索）委派，default 模式 + tools 白名单确保只读，返回结构化设计概要。
-permissionMode: default
-skills:
-  - harness-plan
----
-
-# 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/java/codebuddy/agents/harness-reviewer.md

@@ -1,52 +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）委派。"
-permissionMode: default
-skills:
-  - harness-review
----
-
-# 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/java/codebuddy/harness-apidoc/SKILL.md

@@ -1,68 +0,0 @@
----
-name: harness-apidoc
-description: 从 Java 后端代码生成结构化前端 API 文档（Controller/VO/ErrorCode）。使用场景：接口文档、前端接口文档、API 文档生成
----
-<!-- generated by harness_deploy.py; core=c7f197c6a6f1ff5a; overlay=java; agent=codebuddy; do not edit -->
-# harness-apidoc — 前端接口文档（Java overlay）
-
-## Purpose
-
-基于 Controller、VO、ErrorCode 生成结构化前端接口文档（增量 + 全量）。
-
-## When to Use
-
-- 新功能完成需出接口文档
-- 触发语："接口文档""API 文档""写文档给前端"
-
-## 统一读取协议
-
-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
-
-1. 确定 change-name（Glob plans，读 frontmatter）
-2. append `phase.start`
-3. 扫描变更涉及 Controller/VO/ErrorCode（CodeGraph 优先）
-4. 生成/更新 `reports/apidoc/` 下 Markdown
-5. append `artifact` + `phase.end`
-
-## Output
-
-- `.harness/changes/<cn>/reports/apidoc/api-doc-*.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]]
-
-## 渐进披露
-
-- **Read `reference.md`** — 文档模板与字段规则
-- **Read `checklist.md`** — 逐步勾选
-
-## 交互白名单
-
-**无** AskUserQuestion；缺输入记 `issue`。
-
-## 执行日志
-
-`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/java/codebuddy/harness-apidoc/checklist.md

@@ -1,142 +0,0 @@
----
-description: harness-apidoc 的7步工作流详细步骤、接口提取规则和执行日志记录格式。仅在执行文档生成流程时读取。
----
-
-# harness-apidoc 检查清单
-
-## 步骤 0：启动准备
-
-确定变更名：用 Glob 搜索 `.harness/changes/*/plans/*-plan.md`（**排除 `.harness/archive/*/`**），读取 frontmatter 提取 `change-name`。默认最多一个未归档变更；如有多个，优先取最近修改的，或询问用户。
-
-**检查 worktree**：读取 `.harness/changes/<change-name>/meta/worktree.json`（旧路径兼容根目录 `worktree.json`）：
-
-- `requested=true` 且 `worktreeRoot` 存在 → cd 到 `worktreeRoot`，确保读取 worktree 中最新代码
-- `requested=true` 但 worktree 不存在 → **停止并提示用户修复 worktree 状态，不得静默回到主目录**
-- `requested=false` 或文件不存在 → 在主目录执行
-
-不要用 `**` 通配符扫描 worktree（返回 100+ 无关文件）。
-
-**append `phase.start`**（`harness_events.py`；禁止手工 Edit `execution-log.md`）：
-
-```powershell
-python <skills-root>/scripts/harness_events.py append --change-dir ".harness/changes/<change-name>" --phase apidoc --type phase.start --note "<触发指令>"
-```
-
-## 步骤 1：识别变更范围
-
-读取变更计划文件，结合 `git diff --stat` 确定涉及的 Controller、VO、ErrorCode 文件。
-
-**⚠️ 必读：审查 logs/execution-log.md 中的后续修复记录**
-
-plan 文件是初始设计，代码可能在 review/test 阶段被修改。必须读取 `logs/execution-log.md` 中 plan 之后的条目（旧路径兼容根目录 `execution-log.md`；特别是 harness-review 和审查修复补充），关注：
-
-- 哪些方法被修改了实现逻辑（如硬编码改为枚举）
-- 哪些字段被新增/删除/重命名
-- 哪些行为发生了变更（如权限策略调整）
-
-在生成文档时，以**实际代码**为准，不以 plan 文件的伪代码为准。
-
-## 步骤 2：提取接口信息
-
-逐个读取变更涉及的 Controller 文件，提取：
-
-- **接口路径和方法**：从 `@RequestMapping`、`@GetMapping`、`@PostMapping` 等注解
-- **请求参数**：从方法签名和 `@RequestBody`、`@RequestParam`、`@PathVariable` 注解
-- **请求体结构**：从 SaveReqVO、PageReqVO 等请求 VO 的字段定义
-- **响应体结构**：从 RespVO、SimpleRespVO 等响应 VO 的字段定义
-- **校验规则**：从 VO 上的 `@NotNull`、`@NotBlank`、`@Size` 等校验注解
-- **错误码**：从 ErrorCodeConstants 或相关常量类
-
-用 CodeGraph 辅助探索调用链（Controller → Service → Mapper），理解接口的业务逻辑。
-
-**⚠️ 行为变更接口必须读 Service 实际实现**
-
-对于有行为变更的接口（如权限调整、返回值结构变更、查询逻辑修改），必须读取 Service 实现类的实际代码，不能仅依赖 plan 文件中的伪代码。
-
-重点验证：
-
-- `getMeta()` 等返回动态数据的接口 → 读实际返回值构造逻辑
-- 枚举/常量值 → 读实际枚举类源码，不从 plan 推断
-- 权限校验逻辑 → 读实际 Service 方法体
-
-**枚举值交叉验证**：数据字典中的枚举值必须从实际枚举类源码提取，不从 plan 文件的伪代码推断。如果 plan 中写 `new SceneMetaVO("1", ...)` 但实际代码用 `ProjectTypeEnum.DELIVERY.getCode()`，以实际代码为准。
-
-**codegraph 降级策略**：
-
-- `codegraph_search` 返回 0 结果时（新文件索引未同步），立即用 Grep 搜索
-- `codegraph_node` 遇到重名符号时（如多个 ErrorCodeConstants），用 `file` 参数指定文件名
-- 不要对同一符号重复调用 codegraph_node 超过 2 次，第 2 次仍不对则用 Read 直接读文件
-
-## 步骤 3：确定文档类型
-
-| 变更规模 | 文档类型 | 说明 |
-|----------|----------|------|
-| 新功能/新模块（5+ 新接口） | **完整接口文档** | 包含所有章节 |
-| 扩展已有接口（新增字段、修改逻辑） | **增量接口文档** | 只描述变更部分，注明与旧版本的差异 |
-| 小改动（1-2 个字段变更） | **增量接口文档** | 简要描述变更 |
-
-## 步骤 4：生成文档
-
-按照 `reference.md` 的7章节模板生成文档。关键要求：
-- 每个接口必须有：路径参数表、Query/请求体字段表、响应字段表
-- 响应示例必须包含完整 JSON
-- 字段表必须包含：字段名、类型、必填（请求）、说明
-- 校验规则写入字段表的「校验」列（如 `≤50字符`、`枚举`）
-- 枚举值必须列入「数据字典」章节，标注前端展示方式
-- 前端用法要写具体（不是"展示数据"，而是控件+联动）
-- 扩展接口必须描述行为变更（不只是字段变更）
-- 前端交互建议用表格：操作 → 接口 → 触发时机 → 交互效果
-- 兼容性说明用表格：场景 → 旧行为 → 新行为 → 前端处理
-- 错误码必须包含触发场景列
-- 从代码提取信息，不从需求文档猜测
-
-**⚠️ 前端影响分级标注（强制）**
-
-每个变更接口必须标注前端影响级别，让前端开发者一眼看出哪些需要改代码、哪些无需处理：
-
-| 标记 | 含义 | 前端动作 |
-|:----:|------|----------|
-| 🔴 **BREAKING** | 破坏性变更，前端不修改会报错或功能异常 | **必须修改**，优先处理 |
-| 🟡 **NEEDS-UPDATE** | 非破坏性变更，但前端需要适配才能使用新功能 | **建议修改**，否则无法使用新能力 |
-| 🟢 **TRANSPARENT** | 后端内部变更，前端无感，无需修改 | 无需处理，仅供了解 |
-
-**判定规则**：
-
-- 🔴 **BREAKING**：删除字段、字段类型变更、枚举值删除/变更、请求必填字段新增、响应结构变更、接口路径变更
-- 🟡 **NEEDS-UPDATE**：新增可选字段、新增可选参数、新增响应字段（前端可选渲染）、行为变更（如权限放开，前端可删除旧的 403 处理）
-- 🟢 **TRANSPARENT**：后端内部重构（如死代码删除、Mapper 优化）、性能优化、日志变更、注释变更
-
-**标注位置**：
-
-1. **接口变更概览表**：在「变更」列后增加「前端影响」列
-2. **扩展接口详情**：每个接口标题下方用 callout 标注
-3. **文档开头**：增加「前端改动清单」摘要章节
-
-**前端改动清单模板**（放在文档开头，接口变更概览之前）：
-
-```markdown
-## ⚡ 前端改动清单
-
-> 前端开发者请优先处理以下 🔴 BREAKING 项，其次处理 🟡 NEEDS-UPDATE 项。
-
-| 优先级 | 接口 | 改动点 | 前端动作 |
-|:------:|------|--------|----------|
-| 🔴 | `GET /indicator/meta` | `applicableScenes[].code` 值从数字改为枚举编码 | Select 组件 value 改用 `projectType` 字段 |
-| 🔴 | `POST /indicator/applicable` | 请求体 `sceneCode` 删除 | 改为传 `projectType` |
-| 🟡 | `GET /indicator/enabled` | 新增 `projectType` 过滤参数 | 可选适配，传入可筛选适用指标 |
-| 🟢 | `POST /indicator/list` | 后端自动 orgCode 过滤 | 无需处理，前端可删除传 orgCode 逻辑 |
-```
-
-## 步骤 5：保存文档
-
-用 Write 工具保存到 `.harness/changes/<change-name>/apidoc/<模块名>-前端接口文档-YYYY-MM-DD.md`。
-
-## 步骤 6：展示并确认
-
-展示文档摘要，询问用户是否满意。不满意 → 修改后重新保存。
-
-**append `phase.complete`**（`note` 含结果/摘要/文档路径）：
-
-```powershell
-python <skills-root>/scripts/harness_events.py append --change-dir ".harness/changes/<change-name>" --phase apidoc --type phase.complete --note "OK|WARN|FAIL — <摘要>"
-```

package/resources/harness/bundles/java/codebuddy/harness-apidoc/reference.md

@@ -1,233 +0,0 @@
----
-description: harness-apidoc 的文档7章节完整模板和增量接口文档差异说明。仅在生成文档需要参考模板结构时读取。
----
-
-# harness-apidoc 参考 — 文档模板
-
-## 文档7章节完整模板
-
-```markdown
-# <模块名> — 前端接口文档
-
-> **版本**：V<N> ｜ **日期**：YYYY-MM-DD ｜ **变更**：<change-name>
-> **基础路径**：`/<模块路径>` ｜ **认证**：Bearer Token ｜ **Content-Type**：`application/json`
-
----
-
-## ⚡ 前端改动清单
-
-> 前端开发者请优先处理以下 🔴 BREAKING 项，其次处理 🟡 NEEDS-UPDATE 项。
-
-| 优先级 | 接口 | 改动点 | 前端动作 |
-|:------:|------|--------|----------|
-| 🔴 | `GET /xxx/meta` | `code` 值从数字改为枚举编码 | Select 组件 value 改用 `projectType` 字段 |
-| 🔴 | `POST /xxx/applicable` | 请求体 `sceneCode` 删除 | 改为传 `projectType` |
-| 🟡 | `GET /xxx/enabled` | 新增 `projectType` 过滤参数 | 可选适配，传入可筛选适用数据 |
-| 🟢 | `POST /xxx/list` | 后端自动 orgCode 过滤 | 无需处理，前端可删除传 orgCode 逻辑 |
-
-> 影响级别：🔴 BREAKING（必须修改）｜ 🟡 NEEDS-UPDATE（建议修改）｜ 🟢 TRANSPARENT（无需处理）
-
----
-
-## 一、接口变更概览
-
-| # | 方法 | 路径 | 说明 | 变更 | 前端影响 |
-|:--:|------|------|------|:----:|:--------:|
-| 1 | GET | `/xxx/meta` | 获取下拉选项 | 🆕 新增 | — |
-| 2 | POST | `/xxx/applicable` | 查询可用数据 | 🆕 新增 | — |
-| 3 | POST | `/xxx/list/{pageNum}/{pageSize}` | 分页查询（新增字段） | 📝 扩展 | 🟡 |
-| 4 | GET | `/xxx/{id}` | 详情（新增子表） | 📝 扩展 | 🟡 |
-| 5 | DELETE | `/xxx/{ids}` | 批量删除 | — 不变 | 🟢 |
-
-> 变更标记：🆕 新增 ｜ 📝 扩展 ｜ ❌ 删除 ｜ — 不变 ｜ ⚠️ 废弃
-> 前端影响：🔴 BREAKING ｜ 🟡 NEEDS-UPDATE ｜ 🟢 TRANSPARENT
-
----
-
-## 二、新增接口
-
-### 2.1 <接口名称>
-
-> `GET /xxx/meta` ｜ 用途：获取下拉选项
-
-**路径参数**：无
-
-**Query 参数**：
-
-| 字段 | 类型 | 必填 | 说明 |
-|------|------|:----:|------|
-| `type` | String | 是 | 选项类型（见数据字典） |
-
-**响应示例**：
-
-```json
-{
-  "code": 0,
-  "msg": "成功",
-  "data": [
-    { "label": "选项A", "value": "A" }
-  ]
-}
-```
-
-**响应字段**：
-
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| `data[].label` | String | 选项显示文本 |
-| `data[].value` | String | 选项值 |
-
-**前端用法**：`type` → 下拉选择控件数据源
-
----
-
-### 2.2 <接口名称>
-
-> `POST /xxx/applicable` ｜ 用途：查询可用数据
-
-**请求体示例**：
-
-```json
-{
-  "keyword": "张三",
-  "status": "ENABLED"
-}
-```
-
-**请求字段**：
-
-| 字段 | 类型 | 必填 | 校验 | 说明 |
-|------|------|:----:|------|------|
-| `keyword` | String | 否 | ≤50字符 | 模糊搜索关键词 |
-| `status` | String | 否 | 枚举 | 状态过滤（见数据字典） |
-
-**响应字段**：
-
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| `data[].id` | Long | 数据ID |
-| `data[].name` | String | 数据名称 |
-| `data[].status` | String | 状态（见数据字典） |
-
-**前端用法**：
-- `keyword` → 搜索输入框，输入后实时查询
-- `status` → 筛选下拉框，选中后过滤结果
-
----
-
-## 三、扩展接口详情
-
-### 3.1 <接口名称>（新增字段）
-
-> `POST /xxx/list/{pageNum}/{pageSize}` ｜ 变更：新增 `status` 查询条件 + 响应新增 `status` 字段
-
-> 🟡 **NEEDS-UPDATE**：前端可选适配新字段，不修改不影响现有功能
-
-**新增请求字段**：
-
-| 字段 | 类型 | 必填 | 说明 |
-|------|------|:----:|------|
-| `status` | String | 否 | 状态过滤（见数据字典） |
-
-**新增响应字段**：
-
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| `data.list[].status` | String | 状态值（见数据字典） |
-
-**行为变更**：分页结果默认按创建时间倒序（原为正序）
-
----
-
-## 四、数据结构
-
-### VO 定义
-
-#### <VOName>（<用途>）
-
-```typescript
-interface <VOName> {
-  id: number;              // 数据ID
-  name: string;            // 数据名称
-  status: string;          // 状态（见数据字典）
-  createTime: string | null; // 创建时间，ISO 8601
-}
-```
-
-### 数据字典
-
-#### status — 状态
-
-| 值 | 说明 | 前端展示 |
-|------|------|------|
-| `ENABLED` | 启用 | 🟢 绿色标签 |
-| `DISABLED` | 禁用 | 🔴 红色标签 |
-
-#### type — 选项类型
-
-| 值 | 说明 |
-|------|------|
-| `A` | 类型A |
-| `B` | 类型B |
-
----
-
-## 五、前端交互建议
-
-### <页面名称>
-
-| 操作 | 调用接口 | 触发时机 | 交互效果 |
-|------|----------|----------|----------|
-| 页面加载 | `GET /xxx/meta` | `onMounted` | 填充筛选下拉框 |
-| 搜索 | `POST /xxx/list` | 输入后防抖 300ms | 刷新表格数据 |
-| 查看详情 | `GET /xxx/{id}` | 点击行 | 弹出详情抽屉 |
-
----
-
-## 六、兼容性说明
-
-| 场景 | 旧行为 | 新行为 | 前端处理 |
-|------|--------|--------|----------|
-| `status=null` 的历史数据 | 字段不存在 | 返回 `null` | 前端判空显示「未设置」 |
-| 旧版分页响应 | 无 `status` 字段 | 新增 `status` 字段 | 前端可选渲染，不阻塞 |
-
----
-
-## 七、错误码速查表
-
-| 编码 | 常量 | 信息 | 触发场景 |
-|------|------|------|----------|
-| 1002001 | `XXX_NOT_FOUND` | 数据不存在 | 查询ID不存在 |
-| 1002002 | `XXX_STATUS_INVALID` | 状态不允许操作 | 状态流转违规 |
-```
-
-## 增量接口文档差异
-
-增量文档与完整文档结构相同，但：
-
-- **前端改动清单**：必须包含，放在文档开头，列出所有 🔴 和 🟡 项
-- **接口变更概览**：只列出有变更的接口，必须包含「前端影响」列
-- **新增接口**章节：只写新增的
-- **扩展接口详情**：每个接口只展示新增/变更字段，用注释标注 `// ========== 新增字段 ==========`
-- **前端影响标注**：每个扩展接口标题下方必须用 callout 标注影响级别：
-
-  ```markdown
-  > 🔴 **BREAKING**：请求体 `sceneCode` 字段已删除，前端必须改为传 `projectType`，否则接口无法正常工作
-
-  > 🟡 **NEEDS-UPDATE**：新增 `projectType` 可选参数，前端可选适配以使用筛选功能
-
-  > 🟢 **TRANSPARENT**：后端自动 orgCode 过滤，前端无需修改（可选删除旧的传 orgCode 逻辑）
-  ```
-
-- **审查修复标注**：如果接口在 review 阶段被修改，在扩展接口详情中添加标注：
-
-  ```markdown
-  > ℹ️ **审查修复**：此接口在 harness-review 阶段有以下修改：
-  > - `code` 值从硬编码数字改为 `ProjectTypeEnum` 枚举编码
-  > - 前端依赖 `code` 字段需同步更新
-  ```
-
-- **数据结构**：只写新增或变更的 VO 字段和数据字典
-- **兼容性说明**：重点描述旧数据如何兼容新字段 + 审查修复引入的 breaking change，每行标注影响级别
-- **错误码**：只列新增的错误码
-- **前端交互建议**：只描述受变更影响的页面和操作