webnovel-query

Information Query Skill

Project Root Guard（必须先确认）

• Claude Code 的“工作区根目录”不一定等于“书项目根目录”。常见结构：工作区为 D:\wk\xiaoshuo，书项目为 D:\wk\xiaoshuo\凡人资本论。
• 必须先解析真实书项目根（必须包含 .webnovel/state.json），后续所有读写路径都以该目录为准。
• 禁止在插件目录 ${CLAUDE_PLUGIN_ROOT}/ 下读取或写入项目文件

环境设置（bash 命令执行前）：

export WORKSPACE_ROOT="${CLAUDE_PROJECT_DIR:-$PWD}"

if [ -z "${CLAUDE_PLUGIN_ROOT}" ] || [ ! -d "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-query" ]; then
  echo "ERROR: 未设置 CLAUDE_PLUGIN_ROOT 或缺少目录: ${CLAUDE_PLUGIN_ROOT}/skills/webnovel-query" >&2
  exit 1
fi
export SKILL_ROOT="${CLAUDE_PLUGIN_ROOT}/skills/webnovel-query"

if [ -z "${CLAUDE_PLUGIN_ROOT}" ] || [ ! -d "${CLAUDE_PLUGIN_ROOT}/scripts" ]; then
  echo "ERROR: 未设置 CLAUDE_PLUGIN_ROOT 或缺少目录: ${CLAUDE_PLUGIN_ROOT}/scripts" >&2
  exit 1
fi
export SCRIPTS_DIR="${CLAUDE_PLUGIN_ROOT}/scripts"

export PROJECT_ROOT="$(python "${SCRIPTS_DIR}/webnovel.py" --project-root "${WORKSPACE_ROOT}" where)"

Workflow Checklist

Copy and track progress:

信息查询进度：
- [ ] Step 1: 识别查询类型
- [ ] Step 2: 加载对应参考文件
- [ ] Step 3: 加载项目数据 (state.json)
- [ ] Step 4: 确认上下文充足
- [ ] Step 5: 执行查询
- [ ] Step 6: 格式化输出

---

Reference Loading Levels (strict, lazy)

• L0: 先识别查询类型，不预加载全部参考。
• L1: 所有查询仅加载基础数据流规范。
• L2: 仅按查询类型加载对应专题参考。

L1 (minimum)

• system-data-flow.md

L2 (conditional by query type)

• 伏笔查询：foreshadowing.md
• 节奏查询：strand-weave-pattern.md
• 标签格式查询：tag-specification.md

Do not load two or more L2 files unless the user request clearly spans multiple query types.

Step 1: 识别查询类型

关键词	查询类型	需加载
角色/主角/配角	标准查询	system-data-flow.md
境界/筑基/金丹	标准查询	system-data-flow.md
伏笔/紧急伏笔	伏笔分析	foreshadowing.md
金手指/系统	金手指状态	system-data-flow.md
节奏/Strand	节奏分析	strand-weave-pattern.md
标签/实体格式	格式查询	tag-specification.md

Step 2: 加载对应参考文件

所有查询必须执行：

cat "${SKILL_ROOT}/references/system-data-flow.md"

伏笔查询额外执行：

cat "${SKILL_ROOT}/references/advanced/foreshadowing.md"

节奏查询额外执行：

cat "${SKILL_ROOT}/../../references/shared/strand-weave-pattern.md"

标签格式查询额外执行：

cat "${SKILL_ROOT}/references/tag-specification.md"

Step 3: 加载项目数据

cat "$PROJECT_ROOT/.webnovel/state.json"

Step 4: 确认上下文充足

检查清单：

• 查询类型已识别
• 对应参考文件已加载
• state.json 已加载
• 知道在哪里搜索答案

如有缺失 → 返回对应 Step

Step 5: 执行查询

标准查询

关键词	搜索目标
角色/主角/配角	主角卡.md, 角色库/
境界/实力	力量体系.md
宗门/势力	世界观.md
物品/宝物	物品库/
地点/秘境	世界观.md

伏笔紧急度分析

三层分类（来自 foreshadowing.md）：

• 核心伏笔: 主线剧情 - 权重 3.0x
• 支线伏笔: 配角/支线 - 权重 2.0x
• 装饰伏笔: 氛围/细节 - 权重 1.0x

紧急度公式：

紧急度 = (已过章节 / 目标章节) × 层级权重

状态判定：

• 🔴 Critical: 超过目标 OR 核心 >20 章
• 🟡 Warning: >80% 目标 OR 支线 >30 章
• 🟢 Normal: 计划范围内

快速分析：

python "${SCRIPTS_DIR}/webnovel.py" --project-root "$PROJECT_ROOT" status -- --focus urgency

金手指状态

输出包含：

• 基本信息（名称/类型/激活章节）
• 当前等级和进度
• 已解锁技能及冷却
• 待解锁技能预览
• 升级条件
• 发展建议

Strand 节奏分析

快速分析：

python "${SCRIPTS_DIR}/webnovel.py" --project-root "$PROJECT_ROOT" status -- --focus strand

检查警告：

• Quest >5 连续章
• Fire >10 章未出现
• Constellation >15 章未出现

Step 6: 格式化输出

# 查询结果：{关键词}

## 📊 概要
- **匹配类型**: {type}
- **数据源**: state.json + 设定集 + 大纲
- **匹配数量**: X 条

## 🔍 详细信息

### 1. Runtime State (state.json)
{结构化数据}
**Source**: `.webnovel/state.json` (lines XX-XX)

### 2. 设定集匹配结果
{匹配内容，含文件路径和行号}

## ⚠️ 数据一致性检查
{state.json 与静态文件的差异}