@hunter-harness/workflow-harness 0.2.50 → 0.2.52

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

@@ -2,5 +2,5 @@
   "schemaVersion": 1,
   "overlay": "none",
   "agent": "claude-code",
-  "coreHash": "6b900d319d6b6d77"
+  "coreHash": "bde20b36d56b03f4"
 }

package/harness/bundles/general/claude-code/README.md

@@ -56,8 +56,8 @@
 | harness-review | `[Read, Write, Edit, Glob, Grep, Agent, Bash(powershell.exe:*)]` | 同上 |
 | harness-sync | `[Read, Glob, Grep, Edit, Write, Bash(powershell.exe:*)]` | 同上 |
 | harness-codebase-map | `[Read, Glob, Grep, Write, Edit, Agent, Bash(powershell.exe:*)]` | 同上 |
-| harness-knowledge-query | `[Bash(powershell.exe:*), Read, Write, Edit, Glob, Grep]` | 同上 |
-| harness-knowledge-ingest | `[Bash(powershell.exe:*), Read, Write, Edit, Glob, Grep]` | 同上 |
+| harness-knowledge-query | `[Bash(powershell.exe:*), Read, Glob, Grep]` | 同上 |
+| harness-knowledge-ingest | `[Bash(powershell.exe:*), Read, Glob, Grep]` | 同上 |
 
 > **blocking user confirmation 不预批准**：各 skill 需要向用户确认时通过普通权限提示调用 `blocking user confirmation`（adapter 映射到 `AskUserQuestion`/`request_user_input`/普通对话），不在 `allowed-tools` 中预批准（遵循 skill-optimizer 规则）。`harness-codebase-map` 额外预批准 `Agent` 用于派发并行 mapper。
 
@@ -227,8 +227,8 @@ harness-skills/
 | harness-review | `/harness-review` | 6维度参考性审查（不阻塞后续流程） | `test` | 手动 | `.harness/changes/<cn>/reports/review/` |
 | harness-submit | `/harness-submit` 或 `/harness-merge`（别名） | commit+push（主目录）/ worktree：本地 commit→--no-ff 合并→push 主分支 | `review` | 手动 | ledger `mergeFinalHash` + 控制台报告 |
 | harness-archive | `/harness-archive` | 归档产出到 archive/YYYY-MM-DD-<cn>，释放工作区 | `submit` | 手动 | `.harness/archive/YYYY-MM-DD-<cn>/` |
-| harness-knowledge-query | `/harness-knowledge-query` | 查询 .harness/knowledge 历史上下文，生成需求 context pack | `sync`/独立 | ✅ | `.harness/knowledge/context-packs/` |
-| harness-knowledge-ingest | `/harness-knowledge-ingest` | 从 archive 整理/同步/维护知识索引（promote/demote/audit） | `archive` | ✅ | `.harness/knowledge/index.json` |
+| harness-knowledge-query | `/harness-knowledge-query` | 只查询平台语义知识；无本地索引或离线回退 | 独立 | ✅ | CLI JSON（不落本地知识文件） |
+| harness-knowledge-ingest | `/harness-knowledge-ingest` | 确认归档 ZIP 已由平台保存、解包并 ingest | `archive` | ✅ | 服务端 package/knowledge 收据 |
 
 > 生命周期 skill（plan → run → test → review → submit → archive）为**手动触发**：单阶段结束后停止，不自动接续下一阶段（已设 `disable-model-invocation`）。sync / codebase-map / knowledge 等辅助 skill 仍可按需被调用。`harness-run`、`harness-submit`、`harness-archive` 涉及 git 写操作、文件移动或归档，调用前必须确保前置条件已满足。
 > `<cn>` = change-name，由 harness-plan 阶段7确定。其他 skill 自动扫描未归档变更定位。

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

@@ -21,7 +21,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=6b900d319d6b6d77; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=bde20b36d56b03f4; overlay=none; agent=claude-code; do not edit -->
 # harness-archive — 变更归档
 
 ## Purpose
@@ -76,7 +76,7 @@ disallowed-tools:
 6. **implementation-detail** — 自适应执行参考；legacy 缺失 🟡WARN，不阻断
 7. **test-scenarios** — 测试真相源：`plans/<change>-test-scenarios.md`
 8. **禁止读取 `docs/superpowers/` 作为正式输入** — 旧草稿仅人工线索
-9. **每个 skill 边界只刷新一次状态快照** — 先运行 `python <skills-root>/scripts/harness_state.py capture --project . --change-dir ".harness/changes/<change-name>" --base <baseCommit> --json`；`changedSegments=[]` 时复用已有 profile/rules/map/knowledge/change/code 指纹，不再重复跑全量 `harness-sync`、知识重建或代码库扫描。只有对应 segment 变化或缺失时才定向刷新；快照不能替代源码读取和验证门禁。
+9. **每个 skill 边界只刷新一次状态快照** — 先运行 `python <skills-root>/scripts/harness_state.py capture --project . --change-dir ".harness/changes/<change-name>" --base <baseCommit> --json`；`changedSegments=[]` 时复用已有 profile/rules/map/change/code 指纹，不再重复跑全量 `harness-sync` 或代码库扫描。`knowledge` 段仅为兼容空段，知识始终按需远端查询；快照不能替代源码读取和验证门禁。
 
 状态目录分层：新路径优先，旧路径兼容 → [[../protocols/state-layout-protocol.md|state-layout-protocol]]
 > 片段：read-protocol
@@ -118,10 +118,10 @@ disallowed-tools:
 
 1. 运行 `python <skills-root>/scripts/harness_archive.py status --change-dir ".harness/changes/<change-name>" --intent release-candidate --json` 前置检查。无 CI 项目若已有完整全量 ledger，先运行 `certify-local`；若用户明确只封存事实，则 status/finalize 均使用 `--intent record-only`。
 2. `meta/archive-meta.md` **由 `harness_archive.py finalize` 自动生成**（与 summary-data `finalStatus` 同源）；**禁止 agent 手写**该文件，手写视为数据丢失。维护者结论写入 events（decision/issue）即可，finalize 会汇总到 summary / archive-meta。
-3. 运行 `python <skills-root>/scripts/harness_archive.py finalize --change-dir ".harness/changes/<change-name>" --archive-root ".harness/archive" --intent <release-candidate|record-only> --json`；读 JSON（cleanup、事件、移动、collect、render、validate、manifest 比对、archive-meta）。finalize 内部负责且仅负责一次 `phase.start` / `phase.end`，调用者不得重复追加。**finalize 不再同步执行知识维护**（§8.2）：它写一个 `pending` maintenance-outbox 项即返回，`knowledgeMaintenance=QUEUED`；写 outbox 失败时 `NOT_QUEUED`（warning，不回滚 archive，总状态 CONDITIONAL）。后续由 `harness-sync` / `harness_knowledge.py maintain` 异步推进 outbox。**finalize 失败或 validate 报错时不删除原目录**。
-   - **平台钩子（best-effort，不阻断归档）**：
-     1. **归档推送（C1）**：有远程凭据时自动 `hunter-harness push` 上传核心+可选辅助档（spec/plans/summary-data/knowledge + `reports/review/*`、`reports/test/*`、`meta/archive-meta.md`、`meta/change-context.json`）。
-     2. **监控终态（C3）**：auto-push 之后自动 `events-sync`，用归档前 change 路径派生的 `run_id` + 原 `change_key` 上报；平台依据 `phase.end`/`archive` 将 run 置为 succeeded/failed（含 `ended_at`）。失败只记 warning。
+3. 运行 `python <skills-root>/scripts/harness_archive.py finalize --change-dir ".harness/changes/<change-name>" --archive-root ".harness/archive" --intent <release-candidate|record-only> --json`；读 JSON（cleanup、事件、移动、collect、render、validate、manifest 比对、archive-meta、ZIP package、上传与服务端 knowledge status）。finalize 内部负责且仅负责一次 `phase.start` / `phase.end`，调用者不得重复追加。**本地不再执行知识维护，也不写 maintenance-outbox**；服务端在归档 ZIP 持久保存并解包后 ingest。**finalize 失败或 validate 报错时不删除原目录**。
+   - **归档包上传**：始终先生成一个确定性 ZIP；有远程凭据时再调用 `npx hunter-harness archive upload`。ZIP 仅包含 `summary-data.json`、`spec/**/*.md`、`plans/**/*.md`、`archive-meta.md`、`change-context.json` 和稳定 manifest；明确排除 logs、review/test 报告、HTML、缓存、备份、凭据和临时文件。
+   - **失败可恢复**：无论远端凭据是否齐全，都先生成 ZIP 与 `<change-key>.upload.json`；上传或服务端 ingest 失败不破坏本地归档。待上传 ZIP 与逐 change 回执保留在 `.harness/state/local/archive-packages/`，可枚举独立重试。只有 CLI 核验 package hash 且服务端同时返回 `archive_status=durable`、`knowledge_status=ready` 后，才清理对应 ZIP 与回执；`indexing` 记为 pending，不记为失败。
+   - **监控终态（C3）**：auto-upload 之后自动 `events-sync`，用归档前 change 路径派生的 `run_id` + 原 `change_key` 上报；失败只记 warning。
 
 - **Read `reference.md`** — finalize 输出字段、archive-meta 格式、CONDITIONAL_OK 规则
 - **Read `templates/summary-data-template.json`** — summary-data 数据结构

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

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

@@ -1,262 +1,69 @@
 ---
 name: harness-knowledge-ingest
-description: "从 .harness/archive 归档整理、同步和维护项目知识索引。适用场景：ingest knowledge、sync knowledge、rebuild knowledge index、promote knowledge、确认知识条目、检查知识库是否过期。"
-argument-hint: "auto(默认) | status | repair | ingest | audit | promote <entry-id> | demote <entry-id> | mcp"
-effort: medium
-allowed-tools: [Bash(powershell.exe:*), Read, Write, Edit, Glob, Grep]
+description: "确认归档 ZIP 已上传并由 Hunter Platform 在服务端解包、校验和入库。客户端不再构建或维护本地知识索引。"
+argument-hint: "status | retry-upload <archive.zip>"
+effort: low
+allowed-tools: [Bash(powershell.exe:*), Read, 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=6b900d319d6b6d77; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=bde20b36d56b03f4; overlay=none; agent=claude-code; do not edit -->
 # harness-knowledge-ingest
 
-从 `.harness/archive/**/reports/final/summary-data.json` **本地抽取**知识条目，产物随归档 push 上传；**裁决与投影以平台为准**（远程优先）。本地 SQLite / Agent judge 仅作离线或未连接平台时的回退。
+知识 ingest 完全由 Hunter Platform 负责。归档完成时，客户端生成一个确定性 ZIP；
+服务端收到后保存原包、安全解包、发布核心文件，并根据其中的 Markdown 与摘要重建
+项目语义索引。
 
-> 语言约定：知识条目的 title / summary / body 及一切生成文档优先使用中文（标识符与字段名保持原文）。详见 [[../shared/p0-trust.md|p0-trust]] 的"生成内容语言约定"。
+客户端不得生成 `.harness/knowledge`、SQLite 索引、候选条目、视图、报告或本地裁决。
+本地知识处理脚本已从分发包移除；历史版本数据只由升级兼容逻辑识别，不再执行。
 
-## 远程优先模式（平台连接后）
+## 归档包边界
 
-1. **本地职责**：抽取 candidate 条目 JSON，写入 `.harness/knowledge/entries/**`（及可选本地 index）。
-2. **上传**：条目随 `hunter-harness push` / 归档 finalize 的 auto-push 上传（见归档分级清单：核心含 `knowledge/entries/active|candidate`）。
-3. **平台职责**：服务端 ingest 后自动裁决 status（promote→active 等启发式），并投影到语义知识库；`deprecate` 粘性不被后续 push 覆盖。
-4. **本地 judge / SQLite**：无平台凭据或离线时仍可用；已连接平台时**不要**把本地裁决当作多人共享真源。
+允许上传的核心内容只有：
 
-未连接平台时，行为退回本地离线 MVP：`candidate` / `stale` / `active` / `superseded` / `conflicted` + SQLite FTS。按新需求查询历史由独立的 `harness-knowledge-query` 负责（默认远程语义搜索，本地索引离线回退）。
+- `reports/final/summary-data.json`
+- `spec/**/*.md`
+- `plans/**/*.md`
+- `archive-meta.md`
+- `change-context.json`
+- 包内 `archive-manifest.json`（由 CLI 生成）
 
-## Triggers
+日志、测试报告、审查报告、HTML、缓存、备份、凭据和临时文件不得进入归档包。
 
-- ingest knowledge
-- sync knowledge
-- rebuild knowledge index
-- promote knowledge
-- 确认知识条目
-- 从归档生成知识索引
-- 刷新项目知识库
-- 检查知识库是否过期
+## Normal Workflow
 
-## Required context
-
-- AGENTS.md / CLAUDE.md
-- `.harness/archive/**/reports/final/summary-data.json`
-- `.harness/knowledge/index.json`
-- `.harness/codebase/map-summary.md`（如存在）
-- design.md
-- （可选）`.harness/credentials.local.yaml` — 已连接平台时走远程裁决
-
-## Purpose
-
-解决两个问题：
-
-1. **整理知识库内容**：把归档里的 `businessGoal`、`changedFiles`、`maintenanceNotes`、`knownRisks`、`manualActions`、`verification`、`reviewSummary` 抽成知识条目。
-2. **维护知识生命周期**：
-   - **远程优先**：平台 ingest 后裁决并投影；本地只需保证条目 JSON 可上传。
-   - **离线回退**：检查索引是否过期，保留 active；高置信 candidate 由 `autoPromote` 自动提升；其余由 **Agent judge** 闭环裁决。
-
-## Outputs
-
-```text
-.harness/knowledge/index.json
-.harness/knowledge/index.sqlite
-.harness/knowledge/entries/candidate/*.json
-.harness/knowledge/entries/active/*.json
-.harness/knowledge/entries/stale/*.json
-.harness/knowledge/entries/superseded/*.json
-.harness/knowledge/entries/conflicted/*.json
-.harness/knowledge/cache/archive-entries/*.json
-.harness/knowledge/reports/ingest-report-*.md
-.harness/knowledge/reports/verification-report-*.md
-.harness/knowledge/reports/audit-report-*.md
-.harness/knowledge/reports/judge-export-<content-sha256>.json
-.harness/knowledge/reports/judgements-<content-sha256>.json
-.harness/knowledge/reports/latest.json
-.harness/knowledge/views/knowledge-dashboard.md
-.harness/knowledge/views/by-file.md
-.harness/knowledge/views/stale-items.md
-.harness/knowledge/views/superseded-items.md
-.harness/knowledge/views/conflicted-items.md
-.harness/knowledge/views/active-review.md
-.harness/knowledge/views/knowledge.base
-.harness/knowledge/context-packs/*.md
-```
-
-## Commands
-
-`<skill-dir>` 指本 skill 目录。所有 python 脚本命令通过 `powershell.exe -Command "..."` 执行。完整命令示例与 config.json 配置见 `reference.md`「Commands 详细」。
-
-| 命令 | 用途 |
-|---|---|
-| 无参数 / `auto` | 一键防腐：首建 config、sync --update、**默认**写回 validator 建议、verify、audit；随后由 **Agent** 执行 judge 闭环 |
-| `status` | 严格只读地返回 freshness 与 health |
-| `repair all` | 修复可证明的 legacy gate、归一化重复、冲突与报告保留；不确定项返回 `needsConfirmation` |
-| `ingest` | 重建/刷新知识索引，抽取 candidate；`--no-incremental` 强制全量重抽取 |
-| `sync --check` | 只读检查 index 与 archive/HEAD 一致性；`--update` 自动刷新 |
-| `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 |
-| `admin <旧命令>` | 旧管理命令兼容入口 |
-| `mcp` | FastMCP stdio 入口，暴露 9 个工具（见 reference.md） |
-
-config.json 配置项（autoPromote / confidence / activeLifecycle / knowledgeValidation）详见 `reference.md`「Commands 详细」。
-
-## Workflow
-
-### Phase 0：确认项目根目录
-
-项目根目录必须包含 `.harness/`。如果 `.harness/archive/` 不存在或没有 `summary-data.json`，报告当前项目暂无可索引归档，不要伪造知识。
-
-### Phase 1：重建本地知识索引
-
-运行：
-
-```powershell
-powershell.exe -Command "python '<skill-dir>\scripts\harness_knowledge.py' ingest --project '<project-root>'"
-```
-
-生成：
-
-- `index.json`：人类可读 manifest。
-- `index.sqlite`：SQLite FTS5 检索索引。
-- `entries/candidate/`：自动抽取、待确认知识。
-- `entries/stale/`：来源 commit 缺失、无法比较，或来源 commit 后相关文件变化的知识。
-- `entries/active/`：人工确认后可长期引用的知识。
-- `views/`：Obsidian 友好的浏览视图。
-- `reports/`：本次 ingest 报告。
-
-### Phase 2：一键 auto（推荐入口）
+1. `harness-archive` 的 finalize 生成确定性 ZIP，并调用：
 
 ```powershell
-powershell.exe -Command "python '<skill-dir>\scripts\harness_knowledge.py' auto --project '<project-root>'"
+powershell.exe -Command "npx hunter-harness archive upload --file '<archive.zip>' --change-key '<change-key>' --yes --non-interactive --json"
 ```
 
-不传子命令时等价于 `auto`。`auto` 输出必须分别报告：
-
-- `freshness`：archive、HEAD、manifest、entry、SQLite 是否一致。
-- `health`：各 lifecycle、publication、validation 与待裁决工作量。
+2. 检查响应中的包哈希、服务端保存状态和 `knowledge_status`。
+3. 只有服务端确认原 ZIP 已持久保存且知识状态为 ready，才删除本地待上传 ZIP。
+4. 上传或 ingest 失败时保留 ZIP 与失败收据；修复连接后重试同一个 ZIP，不重新拼散文件。
 
-`auto` 默认会写回确定性 validator 建议（`--no-apply-suggestions` 可关闭）。JSON 返回含 `lifecycle` 摘要（validatorsApplied、autoPromote、pendingAgentJudge 等）。
+## Ownership Rules
 
-### Phase 3：Agent judge 闭环（auto 之后必须执行）
+- 客户端：选择核心文件、生成稳定 manifest/ZIP、校验包哈希、上传与保留失败重试材料。
+- 服务端：敏感信息扫描、ZIP 安全校验、原包持久化、解包、制品发布、知识 ingest、状态查询和下载恢复。
+- 远端不可用：知识不可用；不得启动本地替代索引。
+- 面向人的知识、提案、规则和说明默认使用中文。
 
-当 `lifecycle.pendingAgentJudge > 0`、存在 `pending-judge` outbox，或 `judge export` 的
-`counts.requiredDecisionCount > 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` 即可。
-
-`pendingAgentJudge`/`requiredDecisionCount` 是完整待裁决总量；`previewCount` 才受
-`config.judge.maxCandidatesPerRun`（默认 100）限制。已被 publication gate 阻断的条目
-只进入 `quarantinedCount`，不得混入 judge export。`defer` 必须保存证据指纹；来源、
-validator、冲突关系或 publication 证据变化后即使未到 `reviewAfter` 也重新进入裁决。
-
-### Phase 4：同步检查（可选）
-
-```powershell
-powershell.exe -Command "python '<skill-dir>\scripts\harness_knowledge.py' status --project '<project-root>'"
-```
+## Forbidden Actions
 
-当 `upToDate=false` 时，运行 `sync --update` 或重新 `auto`，再交给 `harness-knowledge-query` 查询。
-
-### Phase 5：显式 promote/demote（例外路径）
-
-仅在用户点名单条、或 `manualReview=true` 需人工确认时使用 `promote` / `demote`。日常归档后不要逐条人工复核。
-
-**发布门禁**：knowledge publication 与 archive release status 独立。promote / judge apply /
-autoPromote 校验 authoritative pointer/hash 与 `reportPipeline.sourceConsistency`；即使归档
-最终状态为 WARN，只要知识来源一致也可发布，但保留 release advisory。旧归档只有在
-summary/hash/source commit 可独立证明时才自动生成 attestation；否则保持 quarantined 并
-返回 `needsConfirmation`（详见 `reference.md`「发布门禁」）。
-
-### Phase 6：解释同步结果
-
-回复用户或交给后续 skill 前，应说明：
-
-- 索引是否最新。
-- 如需刷新，具体原因是 archive 增删、checksum 变化、sqlite 缺失，还是 HEAD 改变。
-- 本次是否自动刷新。
-- 当前 `active` / `candidate` / `stale` 的数量。
-- 分别报告 `freshness` 与 `health`，不要用一个 `status` 覆盖
-  lifecycle/review/publication/validation 四个正交维度。
-
-## Knowledge extraction rules
-
-- 优先读取归档显式 `knowledgeCandidates[]`；维护流水线、测试计数等
-  `category=process-observation` 不进入长期知识。
-- Duplicate content 使用 Unicode、空白、标点与大小写归一化指纹，并在全量重建时迁移。
-- 冲突必须同时有相同实体、共享来源范围和双方证据；仅关键词相反不得判为冲突。
-- Keep project-local entries excluded from any global index unless explicitly selected.
-- Validate lifecycle relationships.
-- Default generated entries are `candidate`; only config-gated `autoPromote` may promote high-confidence long-lived entries to `active`.
-- Preserve provenance: every entry must include source archive, summary path, source commit, and source files when available.
-- Do not edit `.harness/archive/**` during ingest.
-- Do not copy secrets into `.harness/knowledge`.
-
-## Lifecycle rules
-
-- `candidate`：自动抽取；高置信 + 白名单类型可由 autoPromote 提升；其余由 Agent judge 裁决或保持 candidate。
-- `active`：autoPromote、judge promote，或显式 promote 后可用。
-- `stale`：来源 commit 缺失、来源 commit 后相关文件变化，或当前代码无法证明旧结论仍有效。
-- `superseded`：被后续归档/决策取代。
-- `conflicted`：与另一条 active/candidate 知识冲突。
-
-## Forbidden actions
-
-- auto_promote_candidate_knowledge_without_config_and_confidence_gate
-- erase_conflicts
-- include_project_local_by_default
-- mutate_archive_evidence
-- store_secrets
-- treat_stale_knowledge_as_current_fact
-
-## Allowed capabilities
-
-- read
-- search
-- write_candidate_knowledge
-- 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
+- build_or_refresh_local_knowledge
+- write_dot_harness_knowledge
+- upload_logs_reviews_tests_or_temp_files
+- call_legacy_python_ingest
+- treat_upload_acceptance_without_durable_status_as_success
+- delete_pending_zip_after_failed_upload
 
 ## Verification
 
-本 skill 自带最小测试：
-
-```powershell
-powershell.exe -Command "python 'harness\scripts\harness_test_runner.py' unittest --profile safe --tests-dir '<skill-dir>\tests' --timeout-seconds 300 --verbosity 1"
-```
-
-完成脚本修改后必须至少运行该测试。若在真实项目中验证，还应运行：
-
-```powershell
-powershell.exe -Command "python '<skill-dir>\scripts\harness_knowledge.py' auto --project '<real-project-root>'"
-powershell.exe -Command "python '<skill-dir>\scripts\harness_knowledge.py' ingest --project '<real-project-root>'"
-powershell.exe -Command "python '<skill-dir>\scripts\harness_knowledge.py' suggest-validators --project '<real-project-root>' --limit 20"
-powershell.exe -Command "python '<skill-dir>\scripts\harness_knowledge.py' verify --project '<real-project-root>'"
-powershell.exe -Command "python '<skill-dir>\scripts\harness_knowledge.py' sync --project '<real-project-root>'"
-```
-
-并确认 `index.json`、`index.sqlite`、`views/knowledge-dashboard.md`、`reports/verification-report-*.md` 存在，且 sync 输出 `upToDate=true`。
+确认归档命令的 JSON 结果同时包含：服务端 package 哈希、保存状态和知识状态。
+若失败，确认 `.harness/state/local/archive-packages/` 中仍保留可重试 ZIP；若成功，确认
+ZIP 已按收据策略清理，且平台下载接口可以恢复原包。
 
 ## P0 执行可信度规则
 
@@ -268,30 +75,7 @@ powershell.exe -Command "python '<skill-dir>\scripts\harness_knowledge.py' sync
 
 - sync/ingest 等生成的文档、规则、知识条目、架构说明一律**优先使用中文**撰写（标识符、命令、代码、API 字段名保持原文）
 - 面向平台展示的标题/摘要/正文默认中文；仅当用户明确要求或目标系统强制时才用英文
-> 片段：p0-trust · ingest/sync 须绑定 `upToDate`/产物路径证据
-
-## Output Format
-
-执行完成后展示：
-
-- 本次命令（ingest/sync/promote）与目标项目根。
-- `upToDate` 及 `reasons`（sync）或新增/覆盖条目数（ingest/promote）。
-- 当前 `active` / `candidate` / `stale` 数量统计。
-- 产物路径（`index.json`、`index.sqlite`、`views/`、`reports/`）。
-- `lifecycle` 摘要：`validatorsApplied`、`candidateAutoPromoted`、兼容整数
-  `pendingAgentJudge`，以及
-  `pendingAgentJudgeSummary.requiredDecisionCount/previewCount/quarantinedCount` 等。
-- validator 摘要：`eligible/selected/applied/remaining/unavailable`，不得只报告本轮抽样数。
-- **已处理报告**（auto + judge 后）：promoted/dropped/superseded/kept/deferred/skipped 计数与 `reports/judge-decisions-*.json`、`judgements-*.json` 路径；人工判断还会追加到 `judgements/decisions.json`，后续 ingest 不得抹除。`defer` 必须带 `reviewAfter`，到期前不重复进入待判断清单。
-- 仅当 `upToDate=false` 时建议 `sync --update`；查询历史 → `/harness-knowledge-query`。**禁止**默认列出「请人工确认 N 条 candidate」待办。
-
-## 渐进披露
-
-- **Read `reference.md`** 仅在执行命令或查阅 config.json 配置时 — 含 Commands 详细示例、config.json 配置与兼容说明。
-
-## 交互白名单
-
-**仅当** `.harness/config/harness.json` 中 `knowledge.manualReview=true` 时，promote/demote 高价值条目需 blocking user confirmation；否则按 skill 默认策略 + `decision` 事件。
+> 片段：p0-trust · 只有服务端持久化与 ingest 收据可证明知识已入库
 
 ## 执行日志
 
@@ -306,4 +90,4 @@ python <skills-root>/scripts/harness_events.py append --change-dir ".harness/cha
 > **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 边界保持最新。
 
 每个阶段的 `phase.start` 与对应 `phase.end` 必须复用同一 `--run-id` / `--attempt`；阶段结束必须写 `--status OK|WARN|FAIL|BLOCKED`。重试同一阶段时生成新的 run-id 并增加 `--attempt <n>`，不得覆盖或伪装成一次执行。跨工具继续执行时写 `--executor-tool <codex|claude-code|codebuddy|cursor>`，并在接棒事件写 `--handoff-from-tool` / `--handoff-reason`；也可由 `HUNTER_HARNESS_TOOL/AGENT/MODEL/RUN_ID` 环境变量统一注入。
-> 片段：logging · phase=`knowledge-ingest` · 默认控制台报告；变更上下文写 phase/decision/issue/artifact
+> 片段：logging · phase=`knowledge-ingest` · 记录 package hash、服务端状态与失败重试路径

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

@@ -1,133 +1,69 @@
 ---
 name: harness-knowledge-query
-description: "根据新需求、设计任务、代码修改请求或问题排查，在规划和编码前查询 .harness/knowledge 历史上下文。适用场景：query knowledge、查找历史需求、根据归档理解需求、继续之前类似开发、生成需求上下文包。"
-argument-hint: "<需求文本> [--file <path>] [--status active|candidate|stale]"
-effort: medium
-allowed-tools: [Bash(powershell.exe:*), Read, Write, Edit, Glob, Grep]
+description: "在规划、实现或排查前，通过 hunter-harness CLI 查询远端项目知识库。远端不可用时直接报告不可用，不建立本地索引或离线回退。"
+argument-hint: "<需求或问题原文> [--limit <n>]"
+effort: low
+allowed-tools: [Bash(powershell.exe:*), Read, 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=6b900d319d6b6d77; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=bde20b36d56b03f4; overlay=none; agent=claude-code; do not edit -->
 # harness-knowledge-query
 
-并行 change 中查询必须传 `--change <change-id>`；成功后以该 change 的 `meta/knowledge-context.json` 为稳定指针。全局 `context-packs/latest.json` 仅向后兼容，不得用于判断多个 active change 的上下文归属。
+项目知识以 Hunter Platform 的服务端索引为唯一真源。客户端只提交查询并消费结果：
 
-根据用户的新需求或排查问题检索历史需求、决策、实现、风险和测试证据，并生成 AI 可读的 context pack。
+- 不创建或读取 `.harness/knowledge`；
+- 不运行本地 Python ingest、SQLite、FTS 或 context-pack 脚本；
+- 不在网络或服务不可用时回退到本地归档；
+- 查询失败只记录“本轮无远端知识”，后续工作必须依靠当前代码和用户提供的信息。
 
-## 远程优先 / 离线回退
-
-1. **默认（已 `hunter-harness connect`）**：优先查询平台语义知识库（与 ingest 上传 + 服务端裁决结果一致）；多机/多人共享同一裁决结果。
-2. **离线回退**：无凭据、网络失败或平台不可用时，回退到本地 `.harness/knowledge`（SQLite FTS / 条目文件）。
-3. 此 skill 只负责查询和使用知识。整理与上传由 `harness-knowledge-ingest` + push/归档负责；**不要**在已连接平台时把本地 promote 当作共享真源。
+所有面向人的总结默认使用中文，代码标识符和原始路径保持原样。
 
 ## Triggers
 
-- query knowledge
-- knowledge query
-- 查找相关历史需求
-- 根据历史归档理解这个需求
+- query knowledge / knowledge query
+- 查询历史需求、决策或实现经验
 - 结合之前做过的内容
-- 继续之前类似开发
-- 生成需求上下文包
-- 在规划前查历史
-
-## Automatic Use
-
-当用户提出新功能、改造、排查、设计方案、继续历史任务，且项目存在平台连接或 `.harness/archive` / `.harness/knowledge` 时，AI 应主动运行本 skill，不需要等用户提醒。
-
-不在 query 前单独执行 sync。`query` 命令内部执行一次 ensure-current：建立一次当前快照，索引新鲜时无操作，过期或缺失时只构建一次，然后在同一调用内完成查询（离线路径）。
+- 规划或排查前读取项目知识
 
-## Commands
+## Command
 
-`<ingest-skill-dir>` 指同级 `harness-knowledge-ingest/` 目录；查询逻辑复用其脚本。所有 python 脚本命令通过 `powershell.exe -Command "..."` 执行，避开 Bash 在 Windows 中文路径下的编码/参数问题。
-
-### Query by requirement
+在项目根目录执行一次：
 
 ```powershell
-powershell.exe -Command "python '<ingest-skill-dir>\scripts\harness_knowledge.py' query --project '<project-root>' --query '<用户需求原文>'"
+powershell.exe -Command "npx hunter-harness knowledge query '<用户需求原文>' --limit 10 --json"
 ```
 
-已连接平台时，优先使用平台语义搜索（CLI/`hunter-harness` 知识查询路径，若可用）；上述本地命令作为离线回退。
-
-### Query with metadata filters
-
-```powershell
-powershell.exe -Command "python '<ingest-skill-dir>\scripts\harness_knowledge.py' query --project '<project-root>' --query '<需求或关键词>' --file '<source-file>' --status active"
-```
-
-可重复使用：
-
-- `--file <path>`：只返回关联到指定文件的知识。
-- `--status active|candidate|stale|superseded|conflicted`：按生命周期过滤（远程路径通常已排除 deprecated）。
-- `--type requirement|decision|implementation|risk|test-evidence|pitfall|api-contract`：按知识类型过滤。
-- `--limit <n>`：限制返回数量。
+只允许通过 CLI 访问平台，不得直接拼接 HTTP 请求，也不得调用旧的
+本地知识查询脚本（该脚本已从当前分发包移除）。
 
 ## Workflow
 
-1. 确认项目根目录。
-2. 用用户原始需求执行一次 `query`；query 命令内部执行一次 ensure-current。
-3. 如已知道相关文件，在同一次查询中追加 `--file` 过滤。
-4. 读取 JSON 输出中的 `contextPack`。
-5. 在 `harness-plan`、设计、代码探索或实现前，把 context pack 当作必读输入。
+1. 原样保留用户的需求或问题作为查询文本；已知范围较大时可将关键模块名一并放入文本。
+2. 执行一次远端查询，不在查询前重建或同步知识。
+3. 读取 JSON 中的命中项、来源路径、变更键和相关度。
+4. 把命中内容作为历史线索；涉及当前行为时仍以当前代码和验证结果为准。
+5. 若命令返回远端不可达、未绑定或未认证，记录明确 issue 后继续，不重试本地方案。
 
 ## Output Contract
 
-查询输出 JSON 包含：
-
-- `matchCount`
-- `contextPack`
-- `filters`
-- `planInput`
-- `matches`
-
-`planInput.kind` 必须为 `harness-knowledge-context-pack`。后续 `harness-plan` 应读取 `planInput.path`。
-
-每次查询还会更新稳定指针：
-
-```text
-.harness/knowledge/context-packs/latest.json
-```
-
-该文件包含最新 query、context pack 路径和 `matchIds`，供后续流程快速读取最近一次知识上下文。
+必须说明：
 
-## Interpretation Rules
-
-- `active`：可优先采用，但仍要结合当前代码验证。
-- `candidate`：有参考价值，不是当前事实。
-- `stale`：只能作为历史线索，必须重新检查代码和归档。
-- `superseded` / `conflicted`：必须显式提示风险，不得静默采用。
+- 查询文本与 limit；
+- 是否成功访问远端；
+- 命中数量及最相关来源；
+- 远端不可用时，明确写“未使用本地回退”；
+- 下一步是进入规划/实现，还是先核对当前代码。
 
 ## Forbidden Actions
 
-- rebuild_index_without_need
-- pre_sync_before_query
-- query_then_sync_then_query_again
-- treat_candidate_as_current_fact
-- treat_stale_as_current_fact
-- skip_context_pack_before_planning
-- copy_large_archive_content_into_prompt
-
-## Verification
-
-```powershell
-powershell.exe -Command "python -m unittest '<ingest-skill-dir>\tests\test_harness_knowledge.py'"
-powershell.exe -Command "python '<ingest-skill-dir>\scripts\harness_knowledge.py' query --project '<real-project-root>' --query '<真实需求>'"
-```
-
-确认输出中存在 `contextPack`、`planInput.kind=harness-knowledge-context-pack`，且 context pack 文件包含 `Before planning`。
+- create_local_knowledge_index
+- query_local_sqlite_or_archive_as_fallback
+- generate_local_context_pack
+- retry_with_legacy_python_knowledge_script
+- treat_remote_history_as_current_code_fact
+- copy_secrets_into_query
 
 ## P0 执行可信度规则
 
@@ -139,25 +75,7 @@ powershell.exe -Command "python '<ingest-skill-dir>\scripts\harness_knowledge.py
 
 - sync/ingest 等生成的文档、规则、知识条目、架构说明一律**优先使用中文**撰写（标识符、命令、代码、API 字段名保持原文）
 - 面向平台展示的标题/摘要/正文默认中文；仅当用户明确要求或目标系统强制时才用英文
-> 片段：p0-trust · query 成功须含 `contextPack`/`planInput.kind` 与 `latest.json` 写入
-
-## Output Format
-
-执行完成后展示：
-
-- 用户需求原文与生效的过滤条件（`--file`/`--status`/`--type`/`--limit`）。
-- `matchCount` 与按状态分组的命中数（active/candidate/stale/superseded/conflicted）。
-- `contextPack` 路径与 `latest.json` 指针。
-- 命中 stale/superseded/conflicted 时显式提示风险。
-- 下一步建议（context pack 已就绪 → 进入 `/harness-plan`；ensure-current 失败 → 报告具体 issue，不重复同步或查询）。
-
-## 渐进披露
-
-- 本 skill 暂无 `checklist.md` / `reference.md` 支持文件，规则全部在 SKILL.md。若 Output Contract / Interpretation Rules 后续扩展变重，应拆到 `reference.md`。
-
-## 交互白名单
-
-**无** blocking user confirmation；`stale`/`conflicted` 命中记 `issue`，不阻断 query。
+> 片段：p0-trust · 远端查询成功必须有 CLI JSON 证据；失败不得伪装为已读取历史
 
 ## 执行日志
 
@@ -172,4 +90,4 @@ python <skills-root>/scripts/harness_events.py append --change-dir ".harness/cha
 > **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 边界保持最新。
 
 每个阶段的 `phase.start` 与对应 `phase.end` 必须复用同一 `--run-id` / `--attempt`；阶段结束必须写 `--status OK|WARN|FAIL|BLOCKED`。重试同一阶段时生成新的 run-id 并增加 `--attempt <n>`，不得覆盖或伪装成一次执行。跨工具继续执行时写 `--executor-tool <codex|claude-code|codebuddy|cursor>`，并在接棒事件写 `--handoff-from-tool` / `--handoff-reason`；也可由 `HUNTER_HARNESS_TOOL/AGENT/MODEL/RUN_ID` 环境变量统一注入。
-> 片段：logging · phase=`knowledge-query` · 独立运行时控制台报告；变更上下文写 decision/issue/artifact
+> 片段：logging · phase=`knowledge-query` · 成功记录命中摘要，失败记录远端错误码且不做本地回退