@hunter-harness/workflow-harness 0.2.49 → 0.2.51

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

@@ -1,280 +1,81 @@
 ---
 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=0c4a64243d3f7bfb; overlay=java; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=63cbdcb9833a5c07; overlay=java; agent=claude-code; do not edit -->
 # harness-knowledge-ingest
 
-从 `.harness/archive/**/reports/final/summary-data.json` 抽取项目知识，生成并维护本地 `.harness/knowledge/` 索引。
+知识 ingest 完全由 Hunter Platform 负责。归档完成时，客户端生成一个确定性 ZIP；
+服务端收到后保存原包、安全解包、发布核心文件，并根据其中的 Markdown 与摘要重建
+项目语义索引。
 
-当前实现是本地、离线、无 LLM、无外部服务的 SQLite FTS MVP，已经支持基础生命周期：`candidate`、`stale`、`active`、`superseded`、`conflicted`。按新需求查询历史由独立的 `harness-knowledge-query` 负责。
+客户端不得生成 `.harness/knowledge`、SQLite 索引、候选条目、视图、报告或本地裁决。
+本地知识处理脚本已从分发包移除；历史版本数据只由升级兼容逻辑识别，不再执行。
 
-## Triggers
+## 归档包边界
 
-- ingest knowledge
-- sync knowledge
-- rebuild knowledge index
-- promote knowledge
-- 确认知识条目
-- 从归档生成知识索引
-- 刷新项目知识库
-- 检查知识库是否过期
+允许上传的核心内容只有：
 
-## Required context
+- `reports/final/summary-data.json`
+- `spec/**/*.md`
+- `plans/**/*.md`
+- `archive-meta.md`
+- `change-context.json`
+- 包内 `archive-manifest.json`（由 CLI 生成）
 
-- AGENTS.md / CLAUDE.md
-- `.harness/archive/**/reports/final/summary-data.json`
-- `.harness/knowledge/index.json`
-- `.harness/codebase/map-summary.md`（如存在）
-- design.md
+日志、测试报告、审查报告、HTML、缓存、备份、凭据和临时文件不得进入归档包。
 
-## Purpose
+## Normal Workflow
 
-解决两个问题：
-
-1. **整理知识库内容**：把归档里的 `businessGoal`、`changedFiles`、`maintenanceNotes`、`knownRisks`、`manualActions`、`verification`、`reviewSummary` 抽成知识条目。
-2. **维护知识生命周期**：检查索引是否过期，保留 active 条目；高置信 candidate 由 `autoPromote` 自动提升；其余 candidate/conflicted 由 **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（推荐入口）
-
-```powershell
-powershell.exe -Command "python '<skill-dir>\scripts\harness_knowledge.py' auto --project '<project-root>'"
-```
-
-不传子命令时等价于 `auto`。`auto` 输出必须分别报告：
-
-- `freshness`：archive、HEAD、manifest、entry、SQLite 是否一致。
-- `health`：各 lifecycle、publication、validation 与待裁决工作量。
-
-`auto` 默认会写回确定性 validator 建议（`--no-apply-suggestions` 可关闭）。JSON 返回含 `lifecycle` 摘要（validatorsApplied、autoPromote、pendingAgentJudge 等）。
-
-### Phase 3：Agent judge 闭环（auto 之后必须执行）
-
-当 `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：同步检查（可选）
+1. `harness-archive` 的 finalize 生成确定性 ZIP，并调用：
 
 ```powershell
-powershell.exe -Command "python '<skill-dir>\scripts\harness_knowledge.py' status --project '<project-root>'"
+powershell.exe -Command "npx hunter-harness archive upload --file '<archive.zip>' --change-key '<change-key>' --yes --non-interactive --json"
 ```
 
-当 `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 知识冲突。
+2. 检查响应中的包哈希、服务端保存状态和 `knowledge_status`。
+3. 只有服务端确认原 ZIP 已持久保存且知识状态为 ready，才删除本地待上传 ZIP。
+4. 上传或 ingest 失败时保留 ZIP 与失败收据；修复连接后重试同一个 ZIP，不重新拼散文件。
 
-## Forbidden actions
+## Ownership Rules
 
-- 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
+- 客户端：选择核心文件、生成稳定 manifest/ZIP、校验包哈希、上传与保留失败重试材料。
+- 服务端：敏感信息扫描、ZIP 安全校验、原包持久化、解包、制品发布、知识 ingest、状态查询和下载恢复。
+- 远端不可用：知识不可用；不得启动本地替代索引。
+- 面向人的知识、提案、规则和说明默认使用中文。
 
-## Allowed capabilities
+## Forbidden Actions
 
-- 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 执行可信度规则
 
 - 命令结果不得靠猜测；普通 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]]
-> 片段：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` 事件。
+- sync/ingest 等生成的文档、规则、知识条目、架构说明一律**优先使用中文**撰写（标识符、命令、代码、API 字段名保持原文）
+- 面向平台展示的标题/摘要/正文默认中文；仅当用户明确要求或目标系统强制时才用英文
+> 片段：p0-trust · 只有服务端持久化与 ingest 收据可证明知识已入库
 
 ## 执行日志
 
@@ -289,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/java/claude-code/harness-knowledge-query/SKILL.md

@@ -1,152 +1,81 @@
 ---
 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=0c4a64243d3f7bfb; overlay=java; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=63cbdcb9833a5c07; 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 的上下文归属。
+项目知识以 Hunter Platform 的服务端索引为唯一真源。客户端只提交查询并消费结果：
 
-根据用户的新需求或排查问题，从项目本地 `.harness/knowledge` 中检索历史需求、决策、实现、风险和测试证据，并生成 AI 可读的 context pack。
+- 不创建或读取 `.harness/knowledge`；
+- 不运行本地 Python ingest、SQLite、FTS 或 context-pack 脚本；
+- 不在网络或服务不可用时回退到本地归档；
+- 查询失败只记录“本轮无远端知识”，后续工作必须依靠当前代码和用户提供的信息。
 
-此 skill 只负责查询和使用知识。整理、同步和 promote 条目由 `harness-knowledge-ingest` 负责。
+所有面向人的总结默认使用中文，代码标识符和原始路径保持原样。
 
 ## Triggers
 
-- query knowledge
-- knowledge query
-- 查找相关历史需求
-- 根据历史归档理解这个需求
+- query knowledge / knowledge query
+- 查询历史需求、决策或实现经验
 - 结合之前做过的内容
-- 继续之前类似开发
-- 生成需求上下文包
-- 在规划前查历史
+- 规划或排查前读取项目知识
 
-## Automatic Use
+## Command
 
-当用户提出新功能、改造、排查、设计方案、继续历史任务，且项目存在 `.harness/archive` 或 `.harness/knowledge` 时，AI 应主动运行本 skill，不需要等用户提醒。
-
-不在 query 前单独执行 sync。`query` 命令内部执行一次 ensure-current：建立一次当前快照，索引新鲜时无操作，过期或缺失时只构建一次，然后在同一调用内完成查询。
-
-## Commands
-
-`<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"
 ```
 
-### 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`：按生命周期过滤。
-- `--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 执行可信度规则
 
 - 命令结果不得靠猜测；普通 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]]
-> 片段：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。
+- sync/ingest 等生成的文档、规则、知识条目、架构说明一律**优先使用中文**撰写（标识符、命令、代码、API 字段名保持原文）
+- 面向平台展示的标题/摘要/正文默认中文；仅当用户明确要求或目标系统强制时才用英文
+> 片段：p0-trust · 远端查询成功必须有 CLI JSON 证据；失败不得伪装为已读取历史
 
 ## 执行日志
 
@@ -161,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` · 成功记录命中摘要，失败记录远端错误码且不做本地回退

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

@@ -21,7 +21,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=0c4a64243d3f7bfb; overlay=java; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=63cbdcb9833a5c07; overlay=java; agent=claude-code; do not edit -->
 # harness-package — 增量模块打包（Java overlay）
 
 ## Purpose
@@ -50,7 +50,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
@@ -70,6 +70,11 @@ disallowed-tools:
 - 命令结果不得靠猜测；普通 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]]
+
+## 生成内容语言约定
+
+- sync/ingest 等生成的文档、规则、知识条目、架构说明一律**优先使用中文**撰写（标识符、命令、代码、API 字段名保持原文）
+- 面向平台展示的标题/摘要/正文默认中文；仅当用户明确要求或目标系统强制时才用英文
 > 片段：p0-trust
 
 ## 渐进披露

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

@@ -21,14 +21,14 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=0c4a64243d3f7bfb; overlay=java; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=63cbdcb9833a5c07; overlay=java; agent=claude-code; do not edit -->
 # harness-plan — 需求规划
 
 ## Purpose
 
 确定 change 后必须运行 `python <skills-root>/scripts/harness_gate.py classify --change <id> --stage plan --json`，并把脚本返回的 risk tier、默认阶段、条件阶段和必需验证写入计划；不得凭模型印象另建风险分级。
 
-需求 → 设计文档 → 任务拆分 → 测试场景表（编码/测试唯一真相源）。存在 `.harness/archive/` 或 `.harness/knowledge/` 时须先 `harness-knowledge-query`。
+需求 → 设计文档 → 任务拆分 → 测试场景表（编码/测试唯一真相源）。项目已绑定远端平台时先执行一次 `harness-knowledge-query`；远端不可用则记录 issue 并继续，不做本地回退。
 
 ## When to Use
 
@@ -46,7 +46,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 · plan 额外写 `meta/worktree.json`、`meta/change-context.json`
@@ -86,7 +86,7 @@ disallowed-tools:
 |------|------|
 | 0 | 用当前解释器运行 `harness_runtime.py doctor`，后续消费绝对 argv；git status；脏工作区 → baseline 隔离 + `decision`，不询问 |
 | 0.5 | 先执行 `harness_context.py prepare --phase plan --executor <tool> [--change <id>] --json`，以其唯一 change/executionRoot 初始化 plan-run-id 与 attempt（首次为 1），用同一身份追加 `phase.start`；从第一条知识查询起保留事件证据，并在 finalizer 中复用该身份 |
-| 1 | `harness-knowledge-query` 单次 query（内部 ensure-current；失败记 `issue`） |
+| 1 | `harness-knowledge-query` 单次远端 query（失败记 `issue`，不建立本地索引或离线回退） |
 | 2 | 歧义优先检查 + 复杂度分级；先确认会改变实现方向的语义歧义 |
 | 3 | 按复杂度执行有预算的代码探索；简单修复不得扩散到无关模块 |
 | 4 | **设计审批包** blocking user confirmation；确认事件早于 approved 设计文档和 `meta/worktree.json` |
@@ -101,6 +101,11 @@ change-name 范围变更 → 提示重命名或记 🟡WARN（→ `reference.md`
 - 命令结果不得靠猜测；普通 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]]
+
+## 生成内容语言约定
+
+- sync/ingest 等生成的文档、规则、知识条目、架构说明一律**优先使用中文**撰写（标识符、命令、代码、API 字段名保持原文）
+- 面向平台展示的标题/摘要/正文默认中文；仅当用户明确要求或目标系统强制时才用英文
 > 片段：p0-trust
 
 ## 关键规则

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

@@ -15,8 +15,8 @@ description: harness-plan 的阶段检查清单和覆盖检查列表。仅在执
 ## 阶段 0.5：事件初始化与知识查询
 
 - [ ] 先确定 change-name、稳定的 plan-run-id 与 attempt（首次为 1），立即用 `harness_events.py append ... --phase plan --type phase.start --run-id <plan-run-id> --attempt <attempt>` 追加开始事件
-- [ ] 再执行一次 knowledge `query`；由 query 内部 ensure-current，不另跑前置 sync
-- [ ] 查询失败追加 `issue`，不得重跑“sync + query”循环或假装已读取历史
+- [ ] 项目已绑定平台时执行一次远端 knowledge `query`；不另跑前置 sync，不创建本地索引
+- [ ] 查询失败追加 `issue`，不得回退本地 archive/SQLite、重跑“sync + query”循环或假装已读取历史
 
 ## 阶段 2：歧义优先检查与复杂度分级