refactor(query): classify-then-narrowest-tool; drop default full load-context

webnovel-writer/skills/webnovel-query/SKILL.md

@@ -23,66 +23,70 @@ export PROJECT_ROOT="$(python "${SCRIPTS_DIR}/webnovel.py" --project-root "${WOR
 - `PROJECT_ROOT` 必须包含 `.webnovel/state.json`
 - **禁止**在 `${CLAUDE_PLUGIN_ROOT}/` 下读取或写入项目文件
 
-## 查询类型识别
-
-| 关键词 | 查询类型 | 数据源 |
-|--------|---------|--------|
-| 角色/主角/配角 | 标准查询 | 主角卡.md, 角色库/ |
-| 境界/筑基/金丹 | 标准查询 | 力量体系.md |
-| 宗门/势力/地点 | 标准查询 | 世界观.md |
-| 伏笔/紧急伏笔 | 伏笔分析 | state.json + foreshadowing.md |
-| 金手指/系统 | 金手指状态 | state.json |
-| 节奏/Strand | 节奏分析 | state.json + strand-weave-pattern.md |
-| 标签/实体格式 | 格式查询 | tag-specification.md |
-| 某角色在第N章时/历史状态/时间点状态 | 时序查询 | knowledge query-entity-state / query-relationships |
+## 查询分类 → 最窄工具
+
+先识别查询类型，再用下表最窄工具。不默认全量加载，只在综合 / 跨多类型查询时用 `memory-contract load-context`。
+
+| 查询类型 | 关键词 | 最窄工具 |
+|---------|--------|---------|
+| 角色历史状态 | 某角色在第N章时 / 时间点状态 / 境界变化 | `knowledge query-entity-state` |
+| 实体关系 | 关系 / 敌友 / 师徒 / 阵营归属 | `knowledge query-relationships` |
+| 世界规则 | 力量规则 / 设定铁律 / 境界体系约束 | `memory-contract query-rules` |
+| 伏笔 / open loop | 伏笔 / 紧急伏笔 / 未闭合悬念 | `memory-contract get-open-loops` |
+| 综合 / 复杂 | 跨多类型、需要时间线 + 长期记忆联合 | `memory-contract load-context` |
+| 静态设定 | 角色卡 / 力量体系 / 世界观 / 势力 / 标签格式 | `Grep` + `Read` 设定集 |
 
 ## 引用加载策略
 
-先识别查询类型，再按需加载。路径说明：`references/` 指 skill 私有 `skills/webnovel-query/references/`；`../../references/` 指共享 references。
+按查询类型按需加载，先识别再加载。路径说明：`references/` 指 skill 私有 `skills/webnovel-query/references/`；`../../references/` 指共享 references。
 
 | 查询类型 | Reference | 实际路径 |
 |---------|-----------|---------|
-| 所有查询 | 数据流规范 | `${SKILL_ROOT}/references/system-data-flow.md` |
+| 数据流 / 优先级 | 数据流规范 | `${SKILL_ROOT}/references/system-data-flow.md` |
 | 伏笔分析 | 伏笔分析 | `${SKILL_ROOT}/references/advanced/foreshadowing.md` |
 | 节奏分析 | Strand 模式 | `${SKILL_ROOT}/../../references/shared/strand-weave-pattern.md` |
 | 格式查询 | 标签规范 | `${SKILL_ROOT}/references/tag-specification.md` |
 
-不得同时加载两个以上 L2 文件，除非用户请求明确跨多类型。
+不得同时加载两个以上 reference，除非用户请求明确跨多类型。
 
 ## 查询流程
 
-1. **识别查询类型**：根据用户关键词匹配上表
-2. **加载参考**：只加载该类型需要的 reference
-3. **加载主链上下文**：
-
-```bash
-python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" memory-contract load-context --chapter {chapter_num}
-```
-
-4. **按优先级查询数据源**（写前真源 → 写后真源 → 投影层）：
+1. **识别查询类型**：按「查询分类 → 最窄工具」表匹配关键词。
+2. **按优先级定位写前真源**（写前真源 → 写后真源 → 投影层）：
    1. `.story-system/MASTER_SETTING.json` - 全书主设定（题材、调性、核心禁忌）
    2. `.story-system/volumes/*.json` - 卷级合同（本卷目标、节奏策略）
    3. `.story-system/chapters/*.json` - 章级合同（本章焦点、动态上下文）
    4. latest accepted `.story-system/commits/chapter_XXX.commit.json` - 写后事实（已发布章节的定稿状态）
-   5. `memory-contract load-context` - 记忆编排结果（长期记忆、伏笔、时间线）
-   6. `.webnovel/state.json` / `index.db` - 投影层（仅 fallback/read-model，类比网文后台的"角色卡"、"章节列表"）
-   
+   5. `memory-contract` 系列查询 - 记忆编排结果（长期记忆、伏笔、时间线）
+   6. `.webnovel/state.json` / `index.db` - 投影层（仅 fallback / read-model，类比网文后台的"角色卡"、"章节列表"）
+
    **优先级说明**：
    - 写前真源（1-3）：作者开写前必须遵守的"大纲、设定、禁区"
    - 写后真源（4）：已发布章节的"定稿状态"，不可篡改
    - 投影层（5-6）：从写后真源自动生成的"查询视图"，方便快速检索
-5. **确认上下文充足**：查询类型已识别 + 主链合同 / latest commit 已加载
-6. **执行查询**：按类型检索对应数据源。若为时序查询，使用以下命令：
+
+3. **调用最窄工具检索**：按类型只调用所需命令，不默认全量 `load-context`。
 
 ```bash
-# 查询某实体在指定章节时的状态
+# 角色历史状态：某实体在指定章节时的状态
 python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" knowledge query-entity-state --entity "{entity_id}" --at-chapter {N}
 
-# 查询某实体在指定章节时的所有关系
+# 实体关系：某实体在指定章节时的所有关系
 python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" knowledge query-relationships --entity "{entity_id}" --at-chapter {N}
+
+# 世界规则
+python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" memory-contract query-rules --chapter {chapter_num}
+
+# 伏笔 / open loop
+python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" memory-contract get-open-loops
+
+# 仅综合 / 复杂查询：需要时间线 + 长期记忆联合时才用
+python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" memory-contract load-context --chapter {chapter_num}
 ```
 
-7. **格式化输出**：按下方模板输出
+   静态设定（角色卡 / 力量体系 / 世界观 / 标签格式）直接用 `Grep` 定位行号再 `Read` 取片段，不经 memory-contract。
+
+4. **格式化输出**：按下方模板输出。
 
 ## 输出格式
 
@@ -91,7 +95,7 @@ python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" kno
 
 ## 概要
 - **匹配类型**: {type}
-- **数据源**: state.json + 设定集 + 大纲
+- **数据源**: {实际命中的真源 / 投影层}
 - **匹配数量**: X 条
 
 ## 详细信息