fiction-query

name	fiction-query
description	查询项目设定、角色、力量体系、势力、伏笔等信息。支持角色历史状态、实体关系、 世界规则、伏笔/open-loop 查询。只读操作，不修改任何项目文件。 触发方式：/fiction-query {查询内容}、「查角色」「查伏笔」「查设定」「什么状态」「那个角色叫啥来着」「进展到哪了」。

fiction-query：信息查询

查询项目中的设定、状态、关系信息。只读，不修改任何文件。

查询分类

查询类型	关键词	工具
角色历史状态	某角色在第 N 章时的境界/状态变化	entity-state
实体关系	关系/敌友/师徒/阵营归属	relationships
世界规则	力量规则/设定铁律/境界体系约束	query-rules
伏笔 / open loop	伏笔/紧急伏笔/未闭合悬念	get-open-loops
综合 / 复杂	跨多种类型	load-context
静态设定	角色卡/力量体系/世界观/标签格式	Grep + Read 设定集

执行流程

1. 解析项目根

export PROJECT_ROOT="$(python -X utf8 "${SCRIPTS_DIR}/fiction.py" --project-root "${CODEX_PROJECT_DIR:-${CLAUDE_PROJECT_DIR:-$PWD}}" where)"

2. 识别查询类型

按关键词匹配上表分类。

3. 调用对应工具

# 角色历史状态
# knowledge 查询由 AI agent 直接读取追踪文件完成
# memory-contract 查询由 AI agent 直接读取底本文件完成

静态设定直接用 Grep + Read 从设定集读取，不走 memory-contract。

4. 格式化输出

按结构化模板输出，包含：匹配类型、数据源（真源/投影层）、详细信息（含文件路径和行号）。

数据源优先顺序

查询时按以下顺序定位真源：

1. .story-system/MASTER_SETTING.json — 全局主设定
2. .story-system/volumes/*.json — 卷级底本
3. .story-system/chapters/*.json — 章级底本
4. .story-system/commits/chapter_*.commit.json — 写后事实
5. memory-contract 系列查询 — 记忆编排结果
6. .novel/state.json / 设定集 — 投影层（fallback/read-model）

如果 .story-system/ 底本缺失，必须显式说明查询已降级到投影层。

边界

• 只读操作，不修改任何项目文件
• 数据源缺失时明确告知用户缺什么文件
• 查询无匹配时返回空结果并建议检查范围
• 不同时加载两个以上 reference，除非用户请求明确跨多种类型
• 静态设定不加载到 context，直接用 Grep 定位行号再 Read 片段
• 不带入上下文窗口，仅输出结果

---

参考

数据流优先序来自 system-data-flow 参考。 伏笔分析来自 foreshadowing 参考。 标签规范来自 tag-specification 参考。 Strand 模式分析来自 strand-weave-pattern 参考。 以上参考按查询类型按需加载，不预读。 参考路径规则：references/ 指 skill 私有，shared/ 指全局共享。 当前版本私有参考目录暂无，先按上述硬编码查询路径。 私有参考在增加时放在 skills/fiction-query/references/ 下。 全局共享参考从 story-* 或 webnovel-* 系列引用路径复制。

fiction-query/            # 本技能目录
├─ SKILL.md
├─ references/          # 按需加载的参考文件
│   ├─ foreshadowing.md # 伏笔分析（可选，从 webnovel-query 复制）
│   └─ tag-specification.md # 标签规范
└─ (共享参考从共用位置读取)

查询时的参考加载遵循"识别类型后才加载"原则，不预读全部。 综合/复杂查询才会同时加载多于一个 reference。 静态设定查询不加载 reference，直接用 Grep 定位。

---

使用示例

> /fiction-query 沈夜在第 10 章时的境界

查询结果：沈夜

概要
- 匹配类型：角色历史状态
- 数据源：memory-contract query-entity-state
- 匹配数量：1 条

详细信息
- 第 10 章时：筑基期三层
- 第 8 章时：筑基期二层（提升）
- 驱动事件：吸收灵脉（第 9 章）

> /fiction-query 未回收的伏笔

查询结果：未回收伏笔

概要
- 匹配类型：伏笔 / open loop
- 数据源：memory-contract get-open-loops
- 匹配数量：3 条

详细信息
1. 李四的会计是谁 → 已回收（第 7 章）
2. 主角父亲的死因 → 未回收（埋设于第 5 章）
3. 神秘的匿名信 → 未回收（埋设于第 10 章）

> /fiction-query 世界观/力量体系

查询结果：力量体系

详细信息（从设定集/力量体系.md 读取）
- 境界划分：练气 → 筑基 → 金丹 → 元婴
- 当前主角境界：筑基期三层（从追踪/角色状态.md 读取）

---

致谢

本 skill 的开发参考了以下开源项目的思路与实现：

• lingfengQAQ/webnovel-writer
• worldwonderer/oh-story-claudecode

感谢原作者的开源贡献。