@hunter-harness/workflow-harness 0.2.25 → 0.2.26

package/harness/bundles/general/cursor/harness-sync/SKILL.md

@@ -2,12 +2,12 @@
 name: harness-sync
 description: 检查并更新项目AI元数据（CodeGraph索引、harness-codebase-map分析、CLAUDE.md、AGENTS.md、.harness/完整性），确保Claude对代码库的理解与最新代码一致。当用户说'同步/更新索引/刷新元数据/检查一致性'时使用
 ---
-<!-- generated by harness_deploy.py; core=170e634f2d9f865c; overlay=none; agent=cursor; do not edit -->
+<!-- generated by harness_deploy.py; core=978270969c74a848; overlay=none; agent=cursor; do not edit -->
 # harness-sync — 元数据同步
 
 ## Purpose
 
-检查并更新 AI 元数据（CodeGraph、codebase map、knowledge 索引、CLAUDE.md、AGENTS.md、`.harness/`），使理解与代码一致。
+检查并更新 AI 元数据（CodeGraph、codebase map、knowledge 索引、公共规则、CLAUDE.md、AGENTS.md、`.harness/`），使理解与代码一致。
 
 ## When to Use
 
@@ -40,6 +40,7 @@ python <skills-root>/scripts/harness_sync.py finalize --project . --run-id <run-
 | 3.6 | 单次运行 `harness_knowledge.py maintain --project . --drain --json`，有界推进全部 `.harness/knowledge/maintenance-outbox/{pending,failed}`；不得为每个条目重复启动 Python/重建索引（§8.2：archive close 只 enqueue，sync 异步推进 outbox 到 completed/pending-judge） |
 | 4 | CLAUDE.md 完整性/行数 → 超限 blocking user confirmation 瘦身 |
 | 5 | AGENTS.md 与各 Agent 指令入口一致；Claude Code 启用时验证 CLAUDE.md 引用 AGENTS.md，禁止反向循环引用 |
+| 5.5 | 运行 `npx hunter-harness rules-sync --json`：扫描各 Agent 用户规则并收敛到 `.harness/rules/`，刷新受管投影；读取结构化 review/test/archive 证据生成 `.harness/knowledge/rule-candidates.json`。分歧只报告不覆盖，候选只生成不激活 |
 | 6 | `.harness/` 结构（init 规程 → `reference.md` 第 6 步）；已装 skill 新鲜度只经 `hunter-harness refresh --dry-run --json` 的 post-adaptation freshness 判断，禁止 raw build 字节比较 |
 | 7–9 | `项目规则（见 .harness/context-index.json）/`、构建配置、测试目录 — **只提示不自动修复** |
 
@@ -54,7 +55,7 @@ python <skills-root>/scripts/harness_sync.py finalize --project . --run-id <run-
 
 ## 关键规则
 
-变更量先行 · CodeGraph 依赖编译产物 · map 与 Repomix 互斥 · CLAUDE 瘦身须用户确认 · Phase 7–9 只提示 · knowledge sync 失败记 WARN/FAIL
+变更量先行 · CodeGraph 依赖编译产物 · map 与 Repomix 互斥 · CLAUDE 瘦身须用户确认 · 公共规则自动收敛但分歧不覆盖 · 历史规则只生成候选 · Phase 7–9 只提示 · knowledge sync 失败记 WARN/FAIL
 
 ## Output Format
 

package/harness/bundles/general/cursor/harness-sync/reference.md

@@ -64,6 +64,15 @@ powershell.exe -Command "git -C '<项目路径>' diff --stat HEAD~5 2>$null"
 
 检查 `AGENTS.md` 是否包含项目概述和规则索引。Claude Code adapter 启用时，检查 `CLAUDE.md` 引用 `AGENTS.md`（canonical managed block 使用 `@AGENTS.md`），让共享约束保持单一来源；不得要求 `AGENTS.md` 反向引用 `CLAUDE.md`，否则会形成循环，且会破坏未启用 Claude Code 的项目。
 
+### 5.5 公共规则收敛与历史候选
+
+运行 `npx hunter-harness rules-sync --json`。该命令执行两条相互隔离的链路：
+
+- 扫描 Claude、Cursor、CodeBuddy 的用户规则；相同且全局适用的内容归一到 `.harness/rules/*.md`，再按启用 Agent 生成受管投影。receipt 已确认的投影不作为导入源；手工修改或同名异义规则返回冲突且不覆盖；带 glob/path 范围的规则保留为 Agent 专属。
+- 增量比对结构化 review findings、test failure 与 archive summary，只有跨两个独立归档重复出现，或单次高严重度且证据充分的问题才进入 `.harness/knowledge/rule-candidates.json`。候选包含来源和置信度，但不会自动写入 `.harness/rules/`。
+
+`exit_code=5` 表示存在需要人工取舍的规则分歧，应在状态表中列出路径；不得用 `--force-managed` 绕过。第二次运行无输入变化时必须无新增迁移、无重复提示、候选文件保持不变。
+
 ### 6. .harness/ 完整性
 
 检查 `.harness/` 目录结构和配置文件。结构以产品 file-policy（`requirements/.../22-FILE-POLICY-MATRIX`）为准，init 实际产出的核心路径如下：
@@ -86,11 +95,11 @@ powershell.exe -Command "git -C '<项目路径>' diff --stat HEAD~5 2>$null"
 > 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` 路径在产品中不存在，勿作检查项。
+> file-policy 备注：`.harness/changes/**`（user_editable，push/update=never，本地工作材料）不作为完整性判断标志；`.harness/rules/**` 是可推送的公共规则唯一真源，由 rules-sync 管理投影。旧文本的 `.harness/config/harness-test-config.md` 路径在产品中不存在，勿作检查项。
 
-### 7. 项目规则（见 .harness/context-index.json）/ 完整性
+### 7. `.harness/rules/` 完整性
 
-用 Glob 搜索 `项目规则（见 .harness/context-index.json）/*.md`，检查是否覆盖 5 个必要主题：
+用 Glob 搜索 `.harness/rules/*.md`，检查是否覆盖 5 个必要主题：
 
 | 必要主题 | 检测方式 | 缺失影响 |
 |----------|----------|----------|

package/harness/bundles/general/cursor/harness-test/SKILL.md

@@ -2,7 +2,7 @@
 name: harness-test
 description: 测试执行：读取场景表，执行单元测试+API接口测试+数据兼容验证，输出测试报告。当用户说'跑测试/验证/跑用例/接口测试/单元测试'时使用
 ---
-<!-- generated by harness_deploy.py; core=170e634f2d9f865c; overlay=none; agent=cursor; do not edit -->
+<!-- generated by harness_deploy.py; core=978270969c74a848; overlay=none; agent=cursor; do not edit -->
 # harness-test — 测试执行
 
 ## Purpose

package/harness/bundles/java/claude-code/.harness-build.json

@@ -2,5 +2,5 @@
   "schemaVersion": 1,
   "overlay": "java",
   "agent": "claude-code",
-  "coreHash": "64416412e3f3782d"
+  "coreHash": "b33f68e8e961cb61"
 }

package/harness/bundles/java/claude-code/harness-apidoc/SKILL.md

@@ -20,7 +20,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=64416412e3f3782d; overlay=java; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=b33f68e8e961cb61; overlay=java; agent=claude-code; do not edit -->
 # harness-apidoc — 前端接口文档（Java overlay）
 
 ## Purpose

package/harness/bundles/java/claude-code/harness-archive/SKILL.md

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

package/harness/bundles/java/claude-code/harness-codebase-map/SKILL.md

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

package/harness/bundles/java/claude-code/harness-knowledge-ingest/SKILL.md

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

package/harness/bundles/java/claude-code/harness-knowledge-query/SKILL.md

@@ -20,7 +20,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=64416412e3f3782d; overlay=java; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=b33f68e8e961cb61; overlay=java; agent=claude-code; do not edit -->
 # harness-knowledge-query
 
 并行 change 中查询必须传 `--change <change-id>`；成功后以该 change 的 `meta/knowledge-context.json` 为稳定指针。全局 `context-packs/latest.json` 仅向后兼容，不得用于判断多个 active change 的上下文归属。

package/harness/bundles/java/claude-code/harness-package/SKILL.md

@@ -20,7 +20,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=64416412e3f3782d; overlay=java; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=b33f68e8e961cb61; overlay=java; agent=claude-code; do not edit -->
 # harness-package — 增量模块打包（Java overlay）
 
 ## Purpose

package/harness/bundles/java/claude-code/harness-plan/SKILL.md

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

package/harness/bundles/java/claude-code/harness-review/SKILL.md

@@ -21,7 +21,7 @@ disallowed-tools:
   - Bash(curl *)
   - Bash(codegraph *)
 ---
-<!-- generated by harness_deploy.py; core=64416412e3f3782d; overlay=java; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=b33f68e8e961cb61; overlay=java; agent=claude-code; do not edit -->
 # harness-review — 代码审查
 
 ## Purpose

package/harness/bundles/java/claude-code/harness-run/SKILL.md

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

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

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

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

@@ -19,12 +19,12 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=64416412e3f3782d; overlay=java; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=b33f68e8e961cb61; overlay=java; agent=claude-code; do not edit -->
 # harness-sync — 元数据同步
 
 ## Purpose
 
-检查并更新 AI 元数据（CodeGraph、codebase map、knowledge 索引、CLAUDE.md、AGENTS.md、`.harness/`），使理解与代码一致。
+检查并更新 AI 元数据（CodeGraph、codebase map、knowledge 索引、公共规则、CLAUDE.md、AGENTS.md、`.harness/`），使理解与代码一致。
 
 ## When to Use
 
@@ -57,6 +57,7 @@ python <skills-root>/scripts/harness_sync.py finalize --project . --run-id <run-
 | 3.6 | 单次运行 `harness_knowledge.py maintain --project . --drain --json`，有界推进全部 `.harness/knowledge/maintenance-outbox/{pending,failed}`；不得为每个条目重复启动 Python/重建索引（§8.2：archive close 只 enqueue，sync 异步推进 outbox 到 completed/pending-judge） |
 | 4 | CLAUDE.md 完整性/行数 → 超限 blocking user confirmation 瘦身 |
 | 5 | AGENTS.md 与各 Agent 指令入口一致；Claude Code 启用时验证 CLAUDE.md 引用 AGENTS.md，禁止反向循环引用 |
+| 5.5 | 运行 `npx hunter-harness rules-sync --json`：扫描各 Agent 用户规则并收敛到 `.harness/rules/`，刷新受管投影；读取结构化 review/test/archive 证据生成 `.harness/knowledge/rule-candidates.json`。分歧只报告不覆盖，候选只生成不激活 |
 | 6 | `.harness/` 结构（init 规程 → `reference.md` 第 6 步）；已装 skill 新鲜度只经 `hunter-harness refresh --dry-run --json` 的 post-adaptation freshness 判断，禁止 raw build 字节比较 |
 | 7–9 | `项目规则（见 .harness/context-index.json）/`、构建配置、测试目录 — **只提示不自动修复** |
 
@@ -71,7 +72,7 @@ python <skills-root>/scripts/harness_sync.py finalize --project . --run-id <run-
 
 ## 关键规则
 
-变更量先行 · CodeGraph 依赖编译产物 · map 与 Repomix 互斥 · CLAUDE 瘦身须用户确认 · Phase 7–9 只提示 · knowledge sync 失败记 WARN/FAIL
+变更量先行 · CodeGraph 依赖编译产物 · map 与 Repomix 互斥 · CLAUDE 瘦身须用户确认 · 公共规则自动收敛但分歧不覆盖 · 历史规则只生成候选 · Phase 7–9 只提示 · knowledge sync 失败记 WARN/FAIL
 
 ## Output Format
 

package/harness/bundles/java/claude-code/harness-sync/reference.md

@@ -64,6 +64,15 @@ powershell.exe -Command "git -C '<项目路径>' diff --stat HEAD~5 2>$null"
 
 检查 `AGENTS.md` 是否包含项目概述和规则索引。Claude Code adapter 启用时，检查 `CLAUDE.md` 引用 `AGENTS.md`（canonical managed block 使用 `@AGENTS.md`），让共享约束保持单一来源；不得要求 `AGENTS.md` 反向引用 `CLAUDE.md`，否则会形成循环，且会破坏未启用 Claude Code 的项目。
 
+### 5.5 公共规则收敛与历史候选
+
+运行 `npx hunter-harness rules-sync --json`。该命令执行两条相互隔离的链路：
+
+- 扫描 Claude、Cursor、CodeBuddy 的用户规则；相同且全局适用的内容归一到 `.harness/rules/*.md`，再按启用 Agent 生成受管投影。receipt 已确认的投影不作为导入源；手工修改或同名异义规则返回冲突且不覆盖；带 glob/path 范围的规则保留为 Agent 专属。
+- 增量比对结构化 review findings、test failure 与 archive summary，只有跨两个独立归档重复出现，或单次高严重度且证据充分的问题才进入 `.harness/knowledge/rule-candidates.json`。候选包含来源和置信度，但不会自动写入 `.harness/rules/`。
+
+`exit_code=5` 表示存在需要人工取舍的规则分歧，应在状态表中列出路径；不得用 `--force-managed` 绕过。第二次运行无输入变化时必须无新增迁移、无重复提示、候选文件保持不变。
+
 ### 6. .harness/ 完整性
 
 检查 `.harness/` 目录结构和配置文件。结构以产品 file-policy（`requirements/.../22-FILE-POLICY-MATRIX`）为准，init 实际产出的核心路径如下：
@@ -86,11 +95,11 @@ powershell.exe -Command "git -C '<项目路径>' diff --stat HEAD~5 2>$null"
 > 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` 路径在产品中不存在，勿作检查项。
+> file-policy 备注：`.harness/changes/**`（user_editable，push/update=never，本地工作材料）不作为完整性判断标志；`.harness/rules/**` 是可推送的公共规则唯一真源，由 rules-sync 管理投影。旧文本的 `.harness/config/harness-test-config.md` 路径在产品中不存在，勿作检查项。
 
-### 7. 项目规则（见 .harness/context-index.json）/ 完整性
+### 7. `.harness/rules/` 完整性
 
-用 Glob 搜索 `项目规则（见 .harness/context-index.json）/*.md`，检查是否覆盖 5 个必要主题：
+用 Glob 搜索 `.harness/rules/*.md`，检查是否覆盖 5 个必要主题：
 
 | 必要主题 | 检测方式 | 缺失影响 |
 |----------|----------|----------|

package/harness/bundles/java/claude-code/harness-test/SKILL.md

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

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

@@ -2,5 +2,5 @@
   "schemaVersion": 1,
   "overlay": "java",
   "agent": "codebuddy",
-  "coreHash": "64416412e3f3782d"
+  "coreHash": "b33f68e8e961cb61"
 }

package/harness/bundles/java/codebuddy/harness-apidoc/SKILL.md

@@ -2,7 +2,7 @@
 name: harness-apidoc
 description: 从 Java 后端代码生成结构化前端 API 文档（Controller/VO/ErrorCode）。使用场景：接口文档、前端接口文档、API 文档生成
 ---
-<!-- generated by harness_deploy.py; core=64416412e3f3782d; overlay=java; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=b33f68e8e961cb61; overlay=java; agent=codebuddy; do not edit -->
 # harness-apidoc — 前端接口文档（Java overlay）
 
 ## Purpose

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

@@ -3,7 +3,7 @@ name: harness-archive
 description: 归档所有变更产出（计划/测试报告/审查/SQL/API文档）到
   .harness/archive/，含归档元数据和可视化最终总结。使用场景：归档、完成归档、收尾、打包产出物
 ---
-<!-- generated by harness_deploy.py; core=64416412e3f3782d; overlay=java; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=b33f68e8e961cb61; overlay=java; agent=codebuddy; do not edit -->
 # harness-archive — 变更归档
 
 ## Purpose

package/harness/bundles/java/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=64416412e3f3782d; overlay=java; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=b33f68e8e961cb61; overlay=java; agent=codebuddy; do not edit -->
 # harness-codebase-map — 代码库地图
 
 ## Purpose

package/harness/bundles/java/codebuddy/harness-knowledge-ingest/SKILL.md

@@ -3,7 +3,7 @@ name: harness-knowledge-ingest
 description: 从 .harness/archive 归档整理、同步和维护项目知识索引。适用场景：ingest knowledge、sync
   knowledge、rebuild knowledge index、promote knowledge、确认知识条目、检查知识库是否过期。
 ---
-<!-- generated by harness_deploy.py; core=64416412e3f3782d; overlay=java; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=b33f68e8e961cb61; overlay=java; agent=codebuddy; do not edit -->
 # harness-knowledge-ingest
 
 从 `.harness/archive/**/reports/final/summary-data.json` 抽取项目知识，生成并维护本地 `.harness/knowledge/` 索引。

package/harness/bundles/java/codebuddy/harness-knowledge-query/SKILL.md

@@ -3,7 +3,7 @@ name: harness-knowledge-query
 description: 根据新需求、设计任务、代码修改请求或问题排查，在规划和编码前查询 .harness/knowledge
   历史上下文。适用场景：query knowledge、查找历史需求、根据归档理解需求、继续之前类似开发、生成需求上下文包。
 ---
-<!-- generated by harness_deploy.py; core=64416412e3f3782d; overlay=java; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=b33f68e8e961cb61; overlay=java; agent=codebuddy; do not edit -->
 # harness-knowledge-query
 
 并行 change 中查询必须传 `--change <change-id>`；成功后以该 change 的 `meta/knowledge-context.json` 为稳定指针。全局 `context-packs/latest.json` 仅向后兼容，不得用于判断多个 active change 的上下文归属。

package/harness/bundles/java/codebuddy/harness-package/SKILL.md

@@ -2,7 +2,7 @@
 name: harness-package
 description: 增量模块打包：拉取最新→编译验证→mvn package→汇总 jar/war。使用场景：打包、package、发版准备
 ---
-<!-- generated by harness_deploy.py; core=64416412e3f3782d; overlay=java; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=b33f68e8e961cb61; overlay=java; agent=codebuddy; do not edit -->
 # harness-package — 增量模块打包（Java overlay）
 
 ## Purpose

package/harness/bundles/java/codebuddy/harness-plan/SKILL.md

@@ -2,7 +2,7 @@
 name: harness-plan
 description: 将需求转化为设计文档+实施计划+完整测试场景表，必须在编码前完成。使用场景：需求分析、feature plan、技术方案设计、实现方案规划
 ---
-<!-- generated by harness_deploy.py; core=64416412e3f3782d; overlay=java; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=b33f68e8e961cb61; overlay=java; agent=codebuddy; do not edit -->
 # harness-plan — 需求规划
 
 ## Purpose

package/harness/bundles/java/codebuddy/harness-review/SKILL.md

@@ -3,7 +3,7 @@ name: harness-review
 description: 6维度代码审查（架构/安全/规范/兼容/测试/性能），对照项目规则（见
   .harness/context-index.json）和测试场景表，在隔离上下文运行。使用场景：代码审查、提交前检查、合并评审
 ---
-<!-- generated by harness_deploy.py; core=64416412e3f3782d; overlay=java; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=b33f68e8e961cb61; overlay=java; agent=codebuddy; do not edit -->
 # harness-review — 代码审查
 
 ## Purpose

package/harness/bundles/java/codebuddy/harness-run/SKILL.md

@@ -2,7 +2,7 @@
 name: harness-run
 description: 按变更簇执行 TDD 编码循环（RED→GREEN→REFACTOR→编译验证），逐变更簇实现计划中的任务。使用场景：开始编码、实现功能、写代码、TDD 编码
 ---
-<!-- generated by harness_deploy.py; core=64416412e3f3782d; overlay=java; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=b33f68e8e961cb61; overlay=java; agent=codebuddy; do not edit -->
 # harness-run — 需求编码
 
 ## Purpose

package/harness/bundles/java/codebuddy/harness-submit/SKILL.md

@@ -3,7 +3,7 @@ name: harness-submit
 description: 最终提交封装：验证→中文 commit→提交/推送；worktree 模式含 --no-ff
   合并回主分支。使用场景：提交代码、commit、push、合并分支、merge to main、完成开发
 ---
-<!-- generated by harness_deploy.py; core=64416412e3f3782d; overlay=java; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=b33f68e8e961cb61; overlay=java; agent=codebuddy; do not edit -->
 # harness-submit — 最终提交（含 worktree 合并）
 
 ## Purpose

package/harness/bundles/java/codebuddy/harness-sync/SKILL.md

@@ -2,12 +2,12 @@
 name: harness-sync
 description: 检查并更新项目AI元数据（CodeGraph索引、harness-codebase-map分析、CLAUDE.md、AGENTS.md、.harness/完整性），确保Claude对代码库的理解与最新代码一致。当用户说'同步/更新索引/刷新元数据/检查一致性'时使用
 ---
-<!-- generated by harness_deploy.py; core=64416412e3f3782d; overlay=java; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=b33f68e8e961cb61; overlay=java; agent=codebuddy; do not edit -->
 # harness-sync — 元数据同步
 
 ## Purpose
 
-检查并更新 AI 元数据（CodeGraph、codebase map、knowledge 索引、CLAUDE.md、AGENTS.md、`.harness/`），使理解与代码一致。
+检查并更新 AI 元数据（CodeGraph、codebase map、knowledge 索引、公共规则、CLAUDE.md、AGENTS.md、`.harness/`），使理解与代码一致。
 
 ## When to Use
 
@@ -40,6 +40,7 @@ python <skills-root>/scripts/harness_sync.py finalize --project . --run-id <run-
 | 3.6 | 单次运行 `harness_knowledge.py maintain --project . --drain --json`，有界推进全部 `.harness/knowledge/maintenance-outbox/{pending,failed}`；不得为每个条目重复启动 Python/重建索引（§8.2：archive close 只 enqueue，sync 异步推进 outbox 到 completed/pending-judge） |
 | 4 | CLAUDE.md 完整性/行数 → 超限 blocking user confirmation 瘦身 |
 | 5 | AGENTS.md 与各 Agent 指令入口一致；Claude Code 启用时验证 CLAUDE.md 引用 AGENTS.md，禁止反向循环引用 |
+| 5.5 | 运行 `npx hunter-harness rules-sync --json`：扫描各 Agent 用户规则并收敛到 `.harness/rules/`，刷新受管投影；读取结构化 review/test/archive 证据生成 `.harness/knowledge/rule-candidates.json`。分歧只报告不覆盖，候选只生成不激活 |
 | 6 | `.harness/` 结构（init 规程 → `reference.md` 第 6 步）；已装 skill 新鲜度只经 `hunter-harness refresh --dry-run --json` 的 post-adaptation freshness 判断，禁止 raw build 字节比较 |
 | 7–9 | `项目规则（见 .harness/context-index.json）/`、构建配置、测试目录 — **只提示不自动修复** |
 
@@ -54,7 +55,7 @@ python <skills-root>/scripts/harness_sync.py finalize --project . --run-id <run-
 
 ## 关键规则
 
-变更量先行 · CodeGraph 依赖编译产物 · map 与 Repomix 互斥 · CLAUDE 瘦身须用户确认 · Phase 7–9 只提示 · knowledge sync 失败记 WARN/FAIL
+变更量先行 · CodeGraph 依赖编译产物 · map 与 Repomix 互斥 · CLAUDE 瘦身须用户确认 · 公共规则自动收敛但分歧不覆盖 · 历史规则只生成候选 · Phase 7–9 只提示 · knowledge sync 失败记 WARN/FAIL
 
 ## Output Format
 

package/harness/bundles/java/codebuddy/harness-sync/reference.md

@@ -64,6 +64,15 @@ powershell.exe -Command "git -C '<项目路径>' diff --stat HEAD~5 2>$null"
 
 检查 `AGENTS.md` 是否包含项目概述和规则索引。Claude Code adapter 启用时，检查 `CLAUDE.md` 引用 `AGENTS.md`（canonical managed block 使用 `@AGENTS.md`），让共享约束保持单一来源；不得要求 `AGENTS.md` 反向引用 `CLAUDE.md`，否则会形成循环，且会破坏未启用 Claude Code 的项目。
 
+### 5.5 公共规则收敛与历史候选
+
+运行 `npx hunter-harness rules-sync --json`。该命令执行两条相互隔离的链路：
+
+- 扫描 Claude、Cursor、CodeBuddy 的用户规则；相同且全局适用的内容归一到 `.harness/rules/*.md`，再按启用 Agent 生成受管投影。receipt 已确认的投影不作为导入源；手工修改或同名异义规则返回冲突且不覆盖；带 glob/path 范围的规则保留为 Agent 专属。
+- 增量比对结构化 review findings、test failure 与 archive summary，只有跨两个独立归档重复出现，或单次高严重度且证据充分的问题才进入 `.harness/knowledge/rule-candidates.json`。候选包含来源和置信度，但不会自动写入 `.harness/rules/`。
+
+`exit_code=5` 表示存在需要人工取舍的规则分歧，应在状态表中列出路径；不得用 `--force-managed` 绕过。第二次运行无输入变化时必须无新增迁移、无重复提示、候选文件保持不变。
+
 ### 6. .harness/ 完整性
 
 检查 `.harness/` 目录结构和配置文件。结构以产品 file-policy（`requirements/.../22-FILE-POLICY-MATRIX`）为准，init 实际产出的核心路径如下：
@@ -86,11 +95,11 @@ powershell.exe -Command "git -C '<项目路径>' diff --stat HEAD~5 2>$null"
 > 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` 路径在产品中不存在，勿作检查项。
+> file-policy 备注：`.harness/changes/**`（user_editable，push/update=never，本地工作材料）不作为完整性判断标志；`.harness/rules/**` 是可推送的公共规则唯一真源，由 rules-sync 管理投影。旧文本的 `.harness/config/harness-test-config.md` 路径在产品中不存在，勿作检查项。
 
-### 7. 项目规则（见 .harness/context-index.json）/ 完整性
+### 7. `.harness/rules/` 完整性
 
-用 Glob 搜索 `项目规则（见 .harness/context-index.json）/*.md`，检查是否覆盖 5 个必要主题：
+用 Glob 搜索 `.harness/rules/*.md`，检查是否覆盖 5 个必要主题：
 
 | 必要主题 | 检测方式 | 缺失影响 |
 |----------|----------|----------|

package/harness/bundles/java/codebuddy/harness-test/SKILL.md

@@ -2,7 +2,7 @@
 name: harness-test
 description: 测试执行：读取场景表，执行单元测试+API接口测试+数据兼容验证，输出测试报告。当用户说'跑测试/验证/跑用例/接口测试/单元测试'时使用
 ---
-<!-- generated by harness_deploy.py; core=64416412e3f3782d; overlay=java; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=b33f68e8e961cb61; overlay=java; agent=codebuddy; do not edit -->
 # harness-test — 测试执行
 
 ## Purpose

package/harness/bundles/java/codex/.harness-build.json

@@ -2,5 +2,5 @@
   "schemaVersion": 1,
   "overlay": "java",
   "agent": "codex",
-  "coreHash": "cfa83d5f8390af7f"
+  "coreHash": "68c6493d4f8f419e"
 }

package/harness/bundles/java/codex/harness-apidoc/SKILL.md

@@ -2,7 +2,7 @@
 name: harness-apidoc
 description: 从 Java 后端代码生成结构化前端 API 文档（Controller/VO/ErrorCode）。使用场景：接口文档、前端接口文档、API 文档生成
 ---
-<!-- generated by harness_deploy.py; core=cfa83d5f8390af7f; overlay=java; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=68c6493d4f8f419e; overlay=java; agent=codex; do not edit -->
 # harness-apidoc — 前端接口文档（Java overlay）
 
 ## Purpose

package/harness/bundles/java/codex/harness-archive/SKILL.md

@@ -3,7 +3,7 @@ name: harness-archive
 description: 归档所有变更产出（计划/测试报告/审查/SQL/API文档）到
   .harness/archive/，含归档元数据和可视化最终总结。使用场景：归档、完成归档、收尾、打包产出物
 ---
-<!-- generated by harness_deploy.py; core=cfa83d5f8390af7f; overlay=java; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=68c6493d4f8f419e; overlay=java; agent=codex; do not edit -->
 # harness-archive — 变更归档
 
 ## Purpose

package/harness/bundles/java/codex/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=cfa83d5f8390af7f; overlay=java; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=68c6493d4f8f419e; overlay=java; agent=codex; do not edit -->
 # harness-codebase-map — 代码库地图
 
 ## Purpose

package/harness/bundles/java/codex/harness-knowledge-ingest/SKILL.md

@@ -3,7 +3,7 @@ name: harness-knowledge-ingest
 description: 从 .harness/archive 归档整理、同步和维护项目知识索引。适用场景：ingest knowledge、sync
   knowledge、rebuild knowledge index、promote knowledge、确认知识条目、检查知识库是否过期。
 ---
-<!-- generated by harness_deploy.py; core=cfa83d5f8390af7f; overlay=java; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=68c6493d4f8f419e; overlay=java; agent=codex; do not edit -->
 # harness-knowledge-ingest
 
 从 `.harness/archive/**/reports/final/summary-data.json` 抽取项目知识，生成并维护本地 `.harness/knowledge/` 索引。

package/harness/bundles/java/codex/harness-knowledge-query/SKILL.md

@@ -3,7 +3,7 @@ name: harness-knowledge-query
 description: 根据新需求、设计任务、代码修改请求或问题排查，在规划和编码前查询 .harness/knowledge
   历史上下文。适用场景：query knowledge、查找历史需求、根据归档理解需求、继续之前类似开发、生成需求上下文包。
 ---
-<!-- generated by harness_deploy.py; core=cfa83d5f8390af7f; overlay=java; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=68c6493d4f8f419e; overlay=java; agent=codex; do not edit -->
 # harness-knowledge-query
 
 并行 change 中查询必须传 `--change <change-id>`；成功后以该 change 的 `meta/knowledge-context.json` 为稳定指针。全局 `context-packs/latest.json` 仅向后兼容，不得用于判断多个 active change 的上下文归属。

package/harness/bundles/java/codex/harness-package/SKILL.md

@@ -2,7 +2,7 @@
 name: harness-package
 description: 增量模块打包：拉取最新→编译验证→mvn package→汇总 jar/war。使用场景：打包、package、发版准备
 ---
-<!-- generated by harness_deploy.py; core=cfa83d5f8390af7f; overlay=java; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=68c6493d4f8f419e; overlay=java; agent=codex; do not edit -->
 # harness-package — 增量模块打包（Java overlay）
 
 ## Purpose

package/harness/bundles/java/codex/harness-plan/SKILL.md

@@ -2,7 +2,7 @@
 name: harness-plan
 description: 将需求转化为设计文档+实施计划+完整测试场景表，必须在编码前完成。使用场景：需求分析、feature plan、技术方案设计、实现方案规划
 ---
-<!-- generated by harness_deploy.py; core=cfa83d5f8390af7f; overlay=java; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=68c6493d4f8f419e; overlay=java; agent=codex; do not edit -->
 # harness-plan — 需求规划
 
 ## Purpose

package/harness/bundles/java/codex/harness-review/SKILL.md

@@ -3,7 +3,7 @@ name: harness-review
 description: 6维度代码审查（架构/安全/规范/兼容/测试/性能），对照项目规则（见
   .harness/context-index.json）和测试场景表，在隔离上下文运行。使用场景：代码审查、提交前检查、合并评审
 ---
-<!-- generated by harness_deploy.py; core=cfa83d5f8390af7f; overlay=java; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=68c6493d4f8f419e; overlay=java; agent=codex; do not edit -->
 # harness-review — 代码审查
 
 ## Purpose

package/harness/bundles/java/codex/harness-run/SKILL.md

@@ -2,7 +2,7 @@
 name: harness-run
 description: 按变更簇执行 TDD 编码循环（RED→GREEN→REFACTOR→编译验证），逐变更簇实现计划中的任务。使用场景：开始编码、实现功能、写代码、TDD 编码
 ---
-<!-- generated by harness_deploy.py; core=cfa83d5f8390af7f; overlay=java; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=68c6493d4f8f419e; overlay=java; agent=codex; do not edit -->
 # harness-run — 需求编码
 
 ## Purpose

package/harness/bundles/java/codex/harness-submit/SKILL.md

@@ -3,7 +3,7 @@ name: harness-submit
 description: 最终提交封装：验证→中文 commit→提交/推送；worktree 模式含 --no-ff
   合并回主分支。使用场景：提交代码、commit、push、合并分支、merge to main、完成开发
 ---
-<!-- generated by harness_deploy.py; core=cfa83d5f8390af7f; overlay=java; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=68c6493d4f8f419e; overlay=java; agent=codex; do not edit -->
 # harness-submit — 最终提交（含 worktree 合并）
 
 ## Purpose

package/harness/bundles/java/codex/harness-sync/SKILL.md

@@ -2,12 +2,12 @@
 name: harness-sync
 description: 检查并更新项目AI元数据（CodeGraph索引、harness-codebase-map分析、CLAUDE.md、AGENTS.md、.harness/完整性），确保Claude对代码库的理解与最新代码一致。当用户说'同步/更新索引/刷新元数据/检查一致性'时使用
 ---
-<!-- generated by harness_deploy.py; core=cfa83d5f8390af7f; overlay=java; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=68c6493d4f8f419e; overlay=java; agent=codex; do not edit -->
 # harness-sync — 元数据同步
 
 ## Purpose
 
-检查并更新 AI 元数据（CodeGraph、codebase map、knowledge 索引、CLAUDE.md、AGENTS.md、`.harness/`），使理解与代码一致。
+检查并更新 AI 元数据（CodeGraph、codebase map、knowledge 索引、公共规则、CLAUDE.md、AGENTS.md、`.harness/`），使理解与代码一致。
 
 ## When to Use
 
@@ -40,6 +40,7 @@ python <skills-root>/scripts/harness_sync.py finalize --project . --run-id <run-
 | 3.6 | 单次运行 `harness_knowledge.py maintain --project . --drain --json`，有界推进全部 `.harness/knowledge/maintenance-outbox/{pending,failed}`；不得为每个条目重复启动 Python/重建索引（§8.2：archive close 只 enqueue，sync 异步推进 outbox 到 completed/pending-judge） |
 | 4 | CLAUDE.md 完整性/行数 → 超限 blocking user confirmation 瘦身 |
 | 5 | AGENTS.md 与各 Agent 指令入口一致；Claude Code 启用时验证 CLAUDE.md 引用 AGENTS.md，禁止反向循环引用 |
+| 5.5 | 运行 `npx hunter-harness rules-sync --json`：扫描各 Agent 用户规则并收敛到 `.harness/rules/`，刷新受管投影；读取结构化 review/test/archive 证据生成 `.harness/knowledge/rule-candidates.json`。分歧只报告不覆盖，候选只生成不激活 |
 | 6 | `.harness/` 结构（init 规程 → `reference.md` 第 6 步）；已装 skill 新鲜度只经 `hunter-harness refresh --dry-run --json` 的 post-adaptation freshness 判断，禁止 raw build 字节比较 |
 | 7–9 | `项目规则（见 .harness/context-index.json）/`、构建配置、测试目录 — **只提示不自动修复** |
 
@@ -54,7 +55,7 @@ python <skills-root>/scripts/harness_sync.py finalize --project . --run-id <run-
 
 ## 关键规则
 
-变更量先行 · CodeGraph 依赖编译产物 · map 与 Repomix 互斥 · CLAUDE 瘦身须用户确认 · Phase 7–9 只提示 · knowledge sync 失败记 WARN/FAIL
+变更量先行 · CodeGraph 依赖编译产物 · map 与 Repomix 互斥 · CLAUDE 瘦身须用户确认 · 公共规则自动收敛但分歧不覆盖 · 历史规则只生成候选 · Phase 7–9 只提示 · knowledge sync 失败记 WARN/FAIL
 
 ## Output Format