| name | webnovel-query |
| description | 查询项目设定、角色、力量体系、势力、伏笔等信息。支持紧急度分析与金手指状态查询。 |
| allowed-tools | Read Grep Bash AskUserQuestion |
用户询问关于故事设定、角色、力量体系、势力、伏笔、金手指、节奏等项目内信息时触发。
export WORKSPACE_ROOT="${CLAUDE_PROJECT_DIR:-$PWD}"
export SCRIPTS_DIR="${CLAUDE_PLUGIN_ROOT}/scripts"
export SKILL_ROOT="${CLAUDE_PLUGIN_ROOT}/skills/webnovel-query"
export PROJECT_ROOT="$(python "${SCRIPTS_DIR}/webnovel.py" --project-root "${WORKSPACE_ROOT}" where)"
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 |
先识别查询类型，再按需加载。路径说明：references/ 指 skill 私有 skills/webnovel-query/references/；../../references/ 指共享 references。
| 查询类型 | Reference | 实际路径 |
|---|---|---|
| 所有查询 | 数据流规范 | ${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 文件，除非用户请求明确跨多类型。
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" memory-contract load-context --chapter {chapter_num}
按优先级查询数据源（写前真源 → 写后真源 → 投影层）：
.story-system/MASTER_SETTING.json - 全书主设定（题材、调性、核心禁忌）.story-system/volumes/*.json - 卷级合同（本卷目标、节奏策略）.story-system/chapters/*.json - 章级合同（本章焦点、动态上下文）.story-system/commits/chapter_XXX.commit.json - 写后事实（已发布章节的定稿状态）memory-contract load-context - 记忆编排结果（长期记忆、伏笔、时间线）.webnovel/state.json / index.db - 投影层（仅 fallback/read-model，类比网文后台的"角色卡"、"章节列表"）优先级说明：
确认上下文充足：查询类型已识别 + 主链合同 / latest commit 已加载
执行查询：按类型检索对应数据源。若为时序查询，使用以下命令：
# 查询某实体在指定章节时的状态
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}
# 查询结果：{关键词}
## 概要
- **匹配类型**: {type}
- **数据源**: state.json + 设定集 + 大纲
- **匹配数量**: X 条
## 详细信息
{结构化数据，含文件路径和行号}
## 数据一致性检查
{state.json 与静态文件的差异，若无差异则省略}
.story-system/ 合同与 accepted commit 缺失，必须显式说明当前查询已降级到 legacy fallback产出可发布章节，完整执行上下文→起草→审查→润色→提交→备份。
深度初始化网文项目。通过分阶段交互收集完整创作信息，生成可直接进入规划与写作的项目骨架与约束文件。
基于总纲生成卷纲、时间线和章纲，并把新增设定增量写回现有设定集。
使用审查 Agent 评估章节质量，生成报告并写回审查指标。
从当前会话提取成功模式并写入 project_memory.json
启动只读小说管理面板，查看项目状态、实体图谱与章节内容。