@hunter-harness/workflow-harness 0.2.0 → 0.2.1

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

@@ -2,5 +2,5 @@
   "schemaVersion": 1,
   "overlay": "none",
   "agent": "claude-code",
-  "coreHash": "3797d93d2cf363a9"
+  "coreHash": "781daf01a900c012"
 }

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

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

package/harness/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=3797d93d2cf363a9; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=781daf01a900c012; overlay=none; agent=claude-code; do not edit -->
 # harness-codebase-map — 代码库地图
 
 ## Purpose

package/harness/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=3797d93d2cf363a9; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=781daf01a900c012; overlay=none; agent=claude-code; do not edit -->
 # harness-knowledge-ingest
 
 从 `.harness/archive/**/reports/final/summary-data.json` 抽取项目知识，生成并维护本地 `.harness/knowledge/` 索引。
@@ -51,7 +51,7 @@ disallowed-tools:
 解决两个问题：
 
 1. **整理知识库内容**：把归档里的 `businessGoal`、`changedFiles`、`maintenanceNotes`、`knownRisks`、`manualActions`、`verification`、`reviewSummary` 抽成知识条目。
-2. **维护知识生命周期**：检查索引是否过期，保留 active 条目；高价值 candidate 可经人工确认提升，也可由 `auto` 首次写入的 `autoPromote` 配置按置信度门槛自动提升。
+2. **维护知识生命周期**：检查索引是否过期，保留 active 条目；高置信 candidate 由 `autoPromote` 自动提升；其余 candidate/conflicted 由 **Agent judge** 闭环裁决，不再默认输出人工待办清单。
 
 ## Outputs
 
@@ -84,11 +84,11 @@ disallowed-tools:
 
 | 命令 | 用途 |
 |---|---|
-| `auto` | 一键防腐：首建 config、sync --update、suggest-validators、verify、audit；首次自动写 autoPromote 配置并提升高 confidence 条目 |
+| `auto` | 一键防腐：首建 config、sync --update、**默认**写回 validator 建议、verify、audit；随后由 **Agent** 执行 judge 闭环 |
 | `ingest` | 重建/刷新知识索引，抽取 candidate；`--no-incremental` 强制全量重抽取 |
 | `sync` | 检查 index 与 archive/HEAD 一致性；`--update` 自动刷新 |
-| `promote` | candidate→active（人工确认或 autoPromote 触发） |
-| `demote` | active→stale/candidate（人工复核后） |
+| `promote` | candidate→active（显式 promote 或 autoPromote / judge 触发） |
+| `demote` | active→stale/candidate（显式 demote 或自动降级策略触发） |
 | `audit` | 生成 Candidate/Stale/Superseded/Conflict/Active Review 报告 |
 | `verify` | 执行 entry validators，刷新 lifecycle.validation，生成 verification-report |
 | `suggest-validators` | 生成 file_exists/file_contains validator 建议；`--apply` 写回 entry |
@@ -120,29 +120,40 @@ powershell.exe -Command "python '<skill-dir>\scripts\harness_knowledge.py' inges
 - `views/`：Obsidian 友好的浏览视图。
 - `reports/`：本次 ingest 报告。
 
-### Phase 2：同步检查
+### Phase 2：一键 auto（推荐入口）
 
 ```powershell
-powershell.exe -Command "python '<skill-dir>\scripts\harness_knowledge.py' sync --project '<project-root>'"
+powershell.exe -Command "python '<skill-dir>\scripts\harness_knowledge.py' auto --project '<project-root>'"
 ```
 
-当 `upToDate=false` 时，应优先运行 `sync --update` 或 `ingest`，再交给 `harness-knowledge-query` 查询。
+`auto` 默认会写回确定性 validator 建议（`--no-apply-suggestions` 可关闭）。JSON 返回含 `lifecycle` 摘要（validatorsApplied、autoPromote、pendingAgentJudge 等）。
+
+### Phase 3：Agent judge 闭环（auto 之后必须执行）
+
+当 `lifecycle.pendingAgentJudge > 0`、存在 `pending-judge` outbox，或 `judge export` 的 `counts.pending > 0` 时：
+
+1. `judge export`（或读 maintain 产出的 pending judgements）
+2. Agent 读取 export JSON，按 `reference.md`「Agent judge 启发式」批量写 `reports/judge-decisions-<ts>.json`
+3. `judge apply --apply <decisions.json>`（`knowledge.manualReview=true` 时需用户显式 `--force`）
+4. 向用户输出 **已处理报告**（promoted/dropped/superseded/kept/skipped 计数 + 报告路径）
+
+**禁止**默认输出「请人工确认 N 条 candidate」类五步待办清单。拿不准的 candidate 保持 `candidate` 状态留待下轮，记入 `skippedCandidates` 即可。
 
-### Phase 3：人工确认高价值知识
+裁决体量：`config.judge.maxCandidatesPerRun`（默认 100）；conflicted 优先全量裁决。
 
-如果某条 candidate 已确认仍然有效，并且会反复影响后续需求，可运行 `promote` 将其提升为 active。
+### Phase 4：同步检查（可选）
+
+```powershell
+powershell.exe -Command "python '<skill-dir>\scripts\harness_knowledge.py' sync --project '<project-root>'"
+```
 
-active 条目适合保存：
+当 `upToDate=false` 时，运行 `sync --update` 或重新 `auto`，再交给 `harness-knowledge-query` 查询。
 
-- 需求约束
-- 架构决策
-- API contract
-- 反复踩坑点
-- 测试或发布前置条件
+### Phase 5：显式 promote/demote（例外路径）
 
-不要把一次性实现细节、过期临时方案、未验证结论提升为 active。
+仅在用户点名单条、或 `manualReview=true` 需人工确认时使用 `promote` / `demote`。日常归档后不要逐条人工复核。
 
-### Phase 4：解释同步结果
+### Phase 6：解释同步结果
 
 回复用户或交给后续 skill 前，应说明：
 
@@ -163,8 +174,8 @@ active 条目适合保存：
 
 ## Lifecycle rules
 
-- `candidate`：自动抽取但未人工确认。
-- `active`：人工确认、显式 promote，或配置允许的高置信度 autoPromote 后可用。
+- `candidate`：自动抽取；高置信 + 白名单类型可由 autoPromote 提升；其余由 Agent judge 裁决或保持 candidate。
+- `active`：autoPromote、judge promote，或显式 promote 后可用。
 - `stale`：来源 commit 缺失、来源 commit 后相关文件变化，或当前代码无法证明旧结论仍有效。
 - `superseded`：被后续归档/决策取代。
 - `conflicted`：与另一条 active/candidate 知识冲突。
@@ -186,6 +197,7 @@ active 条目适合保存：
 - write_active_knowledge_after_manual_confirmation
 - write_confidence_scores
 - auto_promote_high_confidence_knowledge_when_configured
+- agent_judge_knowledge_lifecycle
 - write_knowledge_index
 - write_obsidian_views
 
@@ -223,7 +235,9 @@ powershell.exe -Command "python '<skill-dir>\scripts\harness_knowledge.py' sync
 - `upToDate` 及 `reasons`（sync）或新增/覆盖条目数（ingest/promote）。
 - 当前 `active` / `candidate` / `stale` 数量统计。
 - 产物路径（`index.json`、`index.sqlite`、`views/`、`reports/`）。
-- 下一步建议（`upToDate=false` → `sync --update`；有 candidate → 人工确认后 `promote`，或项目启用 `autoPromote` 后让高置信度长期知识自动提升；查询历史 → `/harness-knowledge-query`）。
+- `lifecycle` 摘要：`validatorsApplied`、`candidateAutoPromoted`、`pendingAgentJudge` 等。
+- **已处理报告**（auto + judge 后）：promoted/dropped/superseded/kept/skipped 计数与 `reports/judge-decisions-*.json`、`judgements-*.json` 路径。
+- 仅当 `upToDate=false` 时建议 `sync --update`；查询历史 → `/harness-knowledge-query`。**禁止**默认列出「请人工确认 N 条 candidate」待办。
 
 ## 渐进披露
 

package/harness/bundles/general/claude-code/harness-knowledge-ingest/reference.md

@@ -10,16 +10,36 @@ description: harness-knowledge-ingest 的命令详细示例、config.json 配置
 
 ### Auto maintenance
 
-如果只是想让 skill 自己完成常规知识库防腐，优先跑 `auto`：
+如果只是想让 skill 自己完成常规知识库防腐，优先跑 `auto`，再执行 **Agent judge 闭环**（见下文）：
 
 ```powershell
 powershell.exe -Command "python '<skill-dir>\scripts\harness_knowledge.py' auto --project '<project-root>'"
 ```
 
-`auto` 会按默认维护顺序执行：首建 `config.json`（若缺失）、`sync --update`、只读 `suggest-validators`、`verify`、`audit`。首次发现 `.harness/knowledge/config.json` 不存在时，`auto` 会自动写入启用版 `autoPromote` 配置，并让本次运行立刻按 confidence 规则提升满足门槛的长期知识。默认不会把 validator 建议写回条目；确认要把建议写入后再执行：
+`auto` 会按默认维护顺序执行：首建 `config.json`（若缺失）、`sync --update`、**默认写回** validator 建议、`verify`、`audit`。首次发现 `.harness/knowledge/config.json` 不存在时，会写入启用版 `autoPromote` + `activeLifecycle.autoDemote` + `knowledgeValidation.autoDemoteActive` + `judge.maxCandidatesPerRun` 配置。
+
+关闭 validator 写回：
+
+```powershell
+powershell.exe -Command "python '<skill-dir>\scripts\harness_knowledge.py' auto --project '<project-root>' --no-apply-suggestions"
+```
+
+### Agent judge 闭环（auto 之后）
+
+1. `judge export`（或 maintain 产出的 pending judgements）
+2. Agent 读 export，写 `reports/judge-decisions-<ts>.json`（schema 对齐 `judge apply`）
+3. `judge apply --apply <decisions.json>`
+4. 输出已处理报告，不列人工待办
+
+**启发式**（Agent 侧，非脚本硬编码）：
+
+- **conflicted**：优先 `supersede` 较旧/较弱证据方；对称难判 → `keep-conflict` + reason
+- **candidate**：`decision|api-contract|requirement|pitfall` 且 confidence 高 → `promote`；`implementation|test-evidence` 倾向 `drop` 或保持 candidate
+- 超过 `judge.maxCandidatesPerRun`（默认 100）的低分 candidate：跳过，记入 `skippedCandidates`
 
 ```powershell
-powershell.exe -Command "python '<skill-dir>\scripts\harness_knowledge.py' auto --project '<project-root>' --apply-suggestions --suggest-status candidate"
+powershell.exe -Command "python '<skill-dir>\scripts\harness_knowledge.py' judge --project '<project-root>' --export '<export.json>'"
+powershell.exe -Command "python '<skill-dir>\scripts\harness_knowledge.py' judge --project '<project-root>' --apply '<decisions.json>'"
 ```
 
 常用参数：
@@ -147,20 +167,25 @@ powershell.exe -Command "python '<skill-dir>\scripts\harness_knowledge.py' demot
 
 `demote` 只处理人工确认后的 `active` 条目，可降级到 `stale` 或 `candidate`。降级到 `stale` 时会写入 `manual demotion` stale reason，并在后续 ingest 中保留该人工维护条目。
 
-### Optional active auto-demotion
+### activeLifecycle 与 validator auto-demotion
 
-默认不会自动改写 `active`。如明确希望脚本根据 `Active Review` 自动降级 active，可在 `.harness/knowledge/config.json` 中启用：
+`auto` 首建的 `config.json` **默认已启用** `activeLifecycle.autoDemote` 与 `knowledgeValidation.autoDemoteActive`。已有项目不会强制覆盖。手动启用示例：
 
 ```json
 {
   "activeLifecycle": {
     "autoDemote": true,
     "targetStatus": "stale"
+  },
+  "knowledgeValidation": {
+    "enabled": true,
+    "autoDemoteActive": true,
+    "defaultTargetStatus": "stale"
   }
 }
 ```
 
-启用后，ingest 会把需要复核的 active 自动移动到 `targetStatus`（`stale` 或 `candidate`），记录 `lifecycle.autoDemoted=true` 和 `activeLifecycle auto-demotion` 原因。该能力只应在项目团队确认接受自动降级策略后启用。
+启用后，ingest/verify 会把需复核或 validator 失败的 active 自动降级，并写入 `lifecycle` 审计字段。
 
 ### Optional confidence scoring and autoPromote
 
@@ -199,13 +224,27 @@ confidence 不是“绝对正确率”，只表示当前证据强弱。分数会
     "validatorFailPenalty": 0.5,
     "supersededPenalty": 0.8,
     "conflictPenalty": 0.8
+  },
+  "activeLifecycle": {
+    "autoDemote": true,
+    "targetStatus": "stale"
+  },
+  "knowledgeValidation": {
+    "enabled": true,
+    "autoDemoteActive": true,
+    "defaultTargetStatus": "stale",
+    "allowCommandValidators": false,
+    "commandTimeoutSeconds": 60
+  },
+  "judge": {
+    "maxCandidatesPerRun": 100
   }
 }
 ```
 
 自动提升只处理配置允许的类型，默认排除 stale/conflicted/superseded，且会写入 `lifecycle.autoPromoted=true`、`promotionNote` 和 `promotedAt`。一次性实现细节、测试证据、风险提醒仍不应自动提升为长期事实。
 
-### Optional validator auto-demotion
+### Optional validator auto-demotion（旧文档兼容）
 
 默认不会因为 validator 失败自动改写 `active`。如明确希望确定性 validator 失败时自动降级 active，可在 `.harness/knowledge/config.json` 中启用：
 
@@ -307,3 +346,10 @@ powershell.exe -Command "python '<skill-dir>\scripts\harness_knowledge_mcp.py'"
 - `auto` JSON 输出新增 `config` 摘要：`path`、`created`、`autoPromoteEnabled`、`appliedBy`、`candidateAutoPromoted`。
 - `ingest` 单独命令仍不首建 config；项目策略的自动首建只发生在 `auto` 维护入口。
 - 单测扩展到 35 个，覆盖“已有最新 index 但缺 config 时，auto 首建启用配置并立即提升”的路径。
+
+## v1.14 补充能力（knowledge-auto-close-loop）
+
+- `auto` **默认写回** validator 建议（`--no-apply-suggestions` 可关闭）；JSON 新增 `lifecycle` 摘要。
+- 首建 `config.json` 默认含 `activeLifecycle.autoDemote`、`knowledgeValidation.autoDemoteActive`、`judge.maxCandidatesPerRun=100`。
+- SKILL 工作流：`auto` 后由 **Agent** 执行 `judge export` → 裁决 → `judge apply`；禁止默认输出人工待办清单。
+- `harness-sync` 明确知识闭环主入口为 `/harness-knowledge-ingest auto`。

package/harness/bundles/general/claude-code/harness-knowledge-ingest/scripts/harness_knowledge.py

@@ -58,6 +58,20 @@ DEFAULT_AUTO_KNOWLEDGE_CONFIG = {
         "supersededPenalty": 0.8,
         "conflictPenalty": 0.8,
     },
+    "activeLifecycle": {
+        "autoDemote": True,
+        "targetStatus": "stale",
+    },
+    "knowledgeValidation": {
+        "enabled": True,
+        "autoDemoteActive": True,
+        "defaultTargetStatus": "stale",
+        "allowCommandValidators": False,
+        "commandTimeoutSeconds": 60,
+    },
+    "judge": {
+        "maxCandidatesPerRun": 100,
+    },
 }
 
 
@@ -106,6 +120,9 @@ def ensure_auto_knowledge_config(knowledge: Path) -> dict[str, Any]:
             "path": str(config_path),
             "created": False,
             "autoPromoteEnabled": auto_promote_config(config)["enabled"],
+            "autoDemoteEnabled": active_lifecycle_config(config)["autoDemote"],
+            "autoDemoteActiveEnabled": knowledge_validation_config(config)["autoDemoteActive"],
+            "maxCandidatesPerRun": judge_config(config)["maxCandidatesPerRun"],
             "appliedBy": "existing",
             "candidateAutoPromoted": None,
         }
@@ -115,6 +132,9 @@ def ensure_auto_knowledge_config(knowledge: Path) -> dict[str, Any]:
         "path": str(config_path),
         "created": True,
         "autoPromoteEnabled": True,
+        "autoDemoteEnabled": True,
+        "autoDemoteActiveEnabled": True,
+        "maxCandidatesPerRun": judge_config(config)["maxCandidatesPerRun"],
         "appliedBy": None,
         "candidateAutoPromoted": None,
     }
@@ -185,6 +205,16 @@ def auto_promote_config(config: dict[str, Any]) -> dict[str, Any]:
     }
 
 
+def judge_config(config: dict[str, Any]) -> dict[str, Any]:
+    raw = config.get("judge")
+    if not isinstance(raw, dict):
+        raw = {}
+    max_candidates = int(raw.get("maxCandidatesPerRun") or 100)
+    return {
+        "maxCandidatesPerRun": max(1, max_candidates),
+    }
+
+
 def sha256_file(path: Path) -> str:
     h = hashlib.sha256()
     with path.open("rb") as f:
@@ -2513,7 +2543,7 @@ def auto_knowledge(
     *,
     limit: int = 20,
     suggest_statuses: list[str] | None = None,
-    apply_suggestions: bool = False,
+    apply_suggestions: bool = True,
     incremental: bool = True,
     audit_limit: int = 10,
 ) -> dict[str, Any]:
@@ -2539,6 +2569,7 @@ def auto_knowledge(
     )
     verification = verify_knowledge(project)
     audit = audit_entries(project, limit=audit_limit)
+    ingest_mode = sync.get("index", {}).get("ingestMode", {}) if isinstance(sync.get("index"), dict) else {}
     return {
         "project": str(project),
         "generatedAt": now_iso(),
@@ -2578,6 +2609,15 @@ def auto_knowledge(
             "conflictReview": len(audit["conflictReview"]),
             "activeReview": len(audit["activeReview"]),
         },
+        "lifecycle": {
+            "validatorsApplied": suggestions["applied"],
+            "candidateAutoPromoted": ingest_mode.get(
+                "candidateAutoPromoted", config_summary.get("candidateAutoPromoted") or 0
+            ),
+            "activeAutoDemoted": ingest_mode.get("activeAutoDemoted", 0),
+            "validationAutoDemoted": ingest_mode.get("validationAutoDemoted", verification["autoDemoted"]),
+            "pendingAgentJudge": len(audit["conflictReview"]) + len(audit["candidateReview"]),
+        },
     }
 
 
@@ -3902,7 +3942,11 @@ def main(argv: list[str] | None = None) -> int:
         default=[],
         help="Only suggest validators for this lifecycle status",
     )
-    auto.add_argument("--apply-suggestions", action="store_true", help="Write validator suggestions into entry JSON files")
+    auto.add_argument(
+        "--no-apply-suggestions",
+        action="store_true",
+        help="Do not write validator suggestions into entry JSON files (default applies them)",
+    )
     auto.add_argument("--no-incremental", action="store_true", help="Refresh without reusing the archive entry cache")
 
     audit = sub.add_parser("audit", help="Generate review lists for candidate, stale, and superseded entries")
@@ -3999,7 +4043,7 @@ def main(argv: list[str] | None = None) -> int:
             Path(args.project),
             limit=args.limit,
             suggest_statuses=args.suggest_statuses,
-            apply_suggestions=args.apply_suggestions,
+            apply_suggestions=not args.no_apply_suggestions,
             incremental=not args.no_incremental,
             audit_limit=args.audit_limit,
         )

package/harness/bundles/general/claude-code/harness-knowledge-ingest/scripts/harness_knowledge_mcp.py

@@ -52,7 +52,7 @@ TOOL_DESCRIPTIONS: list[dict[str, Any]] = [
                 "project": {"type": "string", "description": "Project root containing .harness/archive."},
                 "limit": {"type": "integer", "default": 20, "minimum": 1, "maximum": 100},
                 "suggest_statuses": {"type": "array", "items": {"type": "string"}, "default": []},
-                "apply_suggestions": {"type": "boolean", "default": False, "description": "Write validator suggestions into entry JSON files."},
+                "apply_suggestions": {"type": "boolean", "default": True, "description": "Write validator suggestions into entry JSON files (default on)."},
                 "incremental": {"type": "boolean", "default": True, "description": "Reuse cached archive extraction results when refreshing."},
                 "audit_limit": {"type": "integer", "default": 10, "minimum": 1, "maximum": 100},
             },
@@ -181,7 +181,7 @@ def create_server() -> Any:
         project: str,
         limit: int = 20,
         suggest_statuses: list[str] | None = None,
-        apply_suggestions: bool = False,
+        apply_suggestions: bool = True,
         incremental: bool = True,
         audit_limit: int = 10,
     ) -> dict[str, Any]:

package/harness/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=3797d93d2cf363a9; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=781daf01a900c012; overlay=none; agent=claude-code; do not edit -->
 # harness-knowledge-query
 
 根据用户的新需求或排查问题，从项目本地 `.harness/knowledge` 中检索历史需求、决策、实现、风险和测试证据，并生成 AI 可读的 context pack。

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

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

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

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

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

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

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

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

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

@@ -19,7 +19,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=3797d93d2cf363a9; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=781daf01a900c012; overlay=none; agent=claude-code; do not edit -->
 # harness-sync — 元数据同步
 
 ## Purpose
@@ -38,7 +38,7 @@ disallowed-tools:
 | 1 | git log/diff 感知变更量 |
 | 2 | CodeGraph 索引是否需重建 |
 | 3 | `.harness/codebase/map/` 是否过期 → 报告建议 `/harness-codebase-map` |
-| 3.5 | `harness_knowledge.py sync`；可 `sync --update`；失败不得假装可用 |
+| 3.5 | `harness_knowledge.py sync`；可 `sync --update`；失败不得假装可用。**知识闭环主入口**是 `/harness-knowledge-ingest auto`（含 Agent judge），sync 不重复列人工知识待办 |
 | 3.6 | 扫描 `.harness/knowledge/maintenance-outbox/{pending,failed}`；对每项运行 `harness_knowledge.py maintain --project . --archive-id <id> --json`（§8.2：archive close 只 enqueue，sync 异步推进 outbox 到 completed/completed_rules_pending_judge） |
 | 4 | CLAUDE.md 完整性/行数 → 超限 AskUserQuestion 瘦身 |
 | 5 | AGENTS.md 与 CLAUDE.md 一致 |

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

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

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

@@ -2,5 +2,5 @@
   "schemaVersion": 1,
   "overlay": "none",
   "agent": "codebuddy",
-  "coreHash": "3797d93d2cf363a9"
+  "coreHash": "781daf01a900c012"
 }

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

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

package/harness/bundles/general/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=3797d93d2cf363a9; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=781daf01a900c012; overlay=none; agent=codebuddy; do not edit -->
 # harness-codebase-map — 代码库地图
 
 ## Purpose

package/harness/bundles/general/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=3797d93d2cf363a9; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=781daf01a900c012; overlay=none; agent=codebuddy; do not edit -->
 # harness-knowledge-ingest
 
 从 `.harness/archive/**/reports/final/summary-data.json` 抽取项目知识，生成并维护本地 `.harness/knowledge/` 索引。
@@ -34,7 +34,7 @@ description: 从 .harness/archive 归档整理、同步和维护项目知识索
 解决两个问题：
 
 1. **整理知识库内容**：把归档里的 `businessGoal`、`changedFiles`、`maintenanceNotes`、`knownRisks`、`manualActions`、`verification`、`reviewSummary` 抽成知识条目。
-2. **维护知识生命周期**：检查索引是否过期，保留 active 条目；高价值 candidate 可经人工确认提升，也可由 `auto` 首次写入的 `autoPromote` 配置按置信度门槛自动提升。
+2. **维护知识生命周期**：检查索引是否过期，保留 active 条目；高置信 candidate 由 `autoPromote` 自动提升；其余 candidate/conflicted 由 **Agent judge** 闭环裁决，不再默认输出人工待办清单。
 
 ## Outputs
 
@@ -67,11 +67,11 @@ description: 从 .harness/archive 归档整理、同步和维护项目知识索
 
 | 命令 | 用途 |
 |---|---|
-| `auto` | 一键防腐：首建 config、sync --update、suggest-validators、verify、audit；首次自动写 autoPromote 配置并提升高 confidence 条目 |
+| `auto` | 一键防腐：首建 config、sync --update、**默认**写回 validator 建议、verify、audit；随后由 **Agent** 执行 judge 闭环 |
 | `ingest` | 重建/刷新知识索引，抽取 candidate；`--no-incremental` 强制全量重抽取 |
 | `sync` | 检查 index 与 archive/HEAD 一致性；`--update` 自动刷新 |
-| `promote` | candidate→active（人工确认或 autoPromote 触发） |
-| `demote` | active→stale/candidate（人工复核后） |
+| `promote` | candidate→active（显式 promote 或 autoPromote / judge 触发） |
+| `demote` | active→stale/candidate（显式 demote 或自动降级策略触发） |
 | `audit` | 生成 Candidate/Stale/Superseded/Conflict/Active Review 报告 |
 | `verify` | 执行 entry validators，刷新 lifecycle.validation，生成 verification-report |
 | `suggest-validators` | 生成 file_exists/file_contains validator 建议；`--apply` 写回 entry |
@@ -103,29 +103,40 @@ powershell.exe -Command "python '<skill-dir>\scripts\harness_knowledge.py' inges
 - `views/`：Obsidian 友好的浏览视图。
 - `reports/`：本次 ingest 报告。
 
-### Phase 2：同步检查
+### Phase 2：一键 auto（推荐入口）
 
 ```powershell
-powershell.exe -Command "python '<skill-dir>\scripts\harness_knowledge.py' sync --project '<project-root>'"
+powershell.exe -Command "python '<skill-dir>\scripts\harness_knowledge.py' auto --project '<project-root>'"
 ```
 
-当 `upToDate=false` 时，应优先运行 `sync --update` 或 `ingest`，再交给 `harness-knowledge-query` 查询。
+`auto` 默认会写回确定性 validator 建议（`--no-apply-suggestions` 可关闭）。JSON 返回含 `lifecycle` 摘要（validatorsApplied、autoPromote、pendingAgentJudge 等）。
+
+### Phase 3：Agent judge 闭环（auto 之后必须执行）
+
+当 `lifecycle.pendingAgentJudge > 0`、存在 `pending-judge` outbox，或 `judge export` 的 `counts.pending > 0` 时：
+
+1. `judge export`（或读 maintain 产出的 pending judgements）
+2. Agent 读取 export JSON，按 `reference.md`「Agent judge 启发式」批量写 `reports/judge-decisions-<ts>.json`
+3. `judge apply --apply <decisions.json>`（`knowledge.manualReview=true` 时需用户显式 `--force`）
+4. 向用户输出 **已处理报告**（promoted/dropped/superseded/kept/skipped 计数 + 报告路径）
+
+**禁止**默认输出「请人工确认 N 条 candidate」类五步待办清单。拿不准的 candidate 保持 `candidate` 状态留待下轮，记入 `skippedCandidates` 即可。
 
-### Phase 3：人工确认高价值知识
+裁决体量：`config.judge.maxCandidatesPerRun`（默认 100）；conflicted 优先全量裁决。
 
-如果某条 candidate 已确认仍然有效，并且会反复影响后续需求，可运行 `promote` 将其提升为 active。
+### Phase 4：同步检查（可选）
+
+```powershell
+powershell.exe -Command "python '<skill-dir>\scripts\harness_knowledge.py' sync --project '<project-root>'"
+```
 
-active 条目适合保存：
+当 `upToDate=false` 时，运行 `sync --update` 或重新 `auto`，再交给 `harness-knowledge-query` 查询。
 
-- 需求约束
-- 架构决策
-- API contract
-- 反复踩坑点
-- 测试或发布前置条件
+### Phase 5：显式 promote/demote（例外路径）
 
-不要把一次性实现细节、过期临时方案、未验证结论提升为 active。
+仅在用户点名单条、或 `manualReview=true` 需人工确认时使用 `promote` / `demote`。日常归档后不要逐条人工复核。
 
-### Phase 4：解释同步结果
+### Phase 6：解释同步结果
 
 回复用户或交给后续 skill 前，应说明：
 
@@ -146,8 +157,8 @@ active 条目适合保存：
 
 ## Lifecycle rules
 
-- `candidate`：自动抽取但未人工确认。
-- `active`：人工确认、显式 promote，或配置允许的高置信度 autoPromote 后可用。
+- `candidate`：自动抽取；高置信 + 白名单类型可由 autoPromote 提升；其余由 Agent judge 裁决或保持 candidate。
+- `active`：autoPromote、judge promote，或显式 promote 后可用。
 - `stale`：来源 commit 缺失、来源 commit 后相关文件变化，或当前代码无法证明旧结论仍有效。
 - `superseded`：被后续归档/决策取代。
 - `conflicted`：与另一条 active/candidate 知识冲突。
@@ -169,6 +180,7 @@ active 条目适合保存：
 - write_active_knowledge_after_manual_confirmation
 - write_confidence_scores
 - auto_promote_high_confidence_knowledge_when_configured
+- agent_judge_knowledge_lifecycle
 - write_knowledge_index
 - write_obsidian_views
 
@@ -206,7 +218,9 @@ powershell.exe -Command "python '<skill-dir>\scripts\harness_knowledge.py' sync
 - `upToDate` 及 `reasons`（sync）或新增/覆盖条目数（ingest/promote）。
 - 当前 `active` / `candidate` / `stale` 数量统计。
 - 产物路径（`index.json`、`index.sqlite`、`views/`、`reports/`）。
-- 下一步建议（`upToDate=false` → `sync --update`；有 candidate → 人工确认后 `promote`，或项目启用 `autoPromote` 后让高置信度长期知识自动提升；查询历史 → `/harness-knowledge-query`）。
+- `lifecycle` 摘要：`validatorsApplied`、`candidateAutoPromoted`、`pendingAgentJudge` 等。
+- **已处理报告**（auto + judge 后）：promoted/dropped/superseded/kept/skipped 计数与 `reports/judge-decisions-*.json`、`judgements-*.json` 路径。
+- 仅当 `upToDate=false` 时建议 `sync --update`；查询历史 → `/harness-knowledge-query`。**禁止**默认列出「请人工确认 N 条 candidate」待办。
 
 ## 渐进披露