菜单
查询项目设定、角色、力量体系、势力、伏笔等信息。支持角色历史状态、实体关系、 世界规则、伏笔/open-loop 查询。只读操作，不修改任何项目文件。 触发方式：/fiction-query {查询内容}、「查角色」「查伏笔」「查设定」「什么状态」「那个角色叫啥来着」「进展到哪了」。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
正文写作 + 章节修改。写作支持 Normal（标准四步）和 Deep（完整六步+底本同步+data-agent）双模式；修改支持 Re-craft（大改，自动传播）和 Rewrite（重写，全链路刷新）两种内建模式。Polish 模式请走 fiction-polish。 系统自动检测模式并提示用户确认。每章写完自动检测里程碑节点弹出建议。 写作前自动检查章纲是否存在，不存在则阻断。 触发方式：/fiction-write {章号}、「写第X章」「续写」「继续写」「日更」「下一章」「接着写」「开始写」。
网文拆解。分析爆款小说的结构、人设、爽点、节奏等。 自动按篇幅路由到长篇或短篇拆解管线。输出结构化分析报告。 触发方式：/fiction-analyze、「拆书」「拆文」「分析这本书」「深度拆解」「帮我拆一下」「学学这本书」。
小说构思与共创。引导用户与 AI 共同打磨小说核心构思，包括题材定位、角色设计、 世界观框架、核心冲突、文风定位等。在正式开书(fiction-start)前完成。 触发方式：/fiction-conceive、「聊聊构思」「帮我打磨设定」「讨论主角」「文风讨论」「构思共创」「我想写个什么样的故事」「帮我设计角色」。
项目体检诊断。只读检查项目目录、文件、JSON、底本体系完整性。 发现缺失或异常项时解释影响和修复建议，不自动修复。 触发方式：/fiction-doctor、「体检」「诊断」「检查项目」「项目状态」「帮我看看这个项目有没有问题」「检查一下文件」。
导出与完本归档。合并所有正文为 .txt/.docx 格式， 可选去格式、加目录、生成封面。完本后一键归档项目文件。 触发方式：/fiction-export、「导出」「完本」「归档」「下载」「导出txt」「我要完本了」。
逆向导入已有小说。将已写好的半成品或完本小说反向解析为标准项目目录结构， 兼容后续 fiction-plan、fiction-write 流程。内部复用 fiction-analyze 的拆解管线， 按篇幅自动分流。 触发方式：/fiction-import、「导入小说」「反向解析」「导入」「把我的书导进来」「我有现成的稿子」。
| name | fiction-query |
| description | 查询项目设定、角色、力量体系、势力、伏笔等信息。支持角色历史状态、实体关系、 世界规则、伏笔/open-loop 查询。只读操作，不修改任何项目文件。 触发方式：/fiction-query {查询内容}、「查角色」「查伏笔」「查设定」「什么状态」「那个角色叫啥来着」「进展到哪了」。 |
查询项目中的设定、状态、关系信息。只读，不修改任何文件。
| 查询类型 | 关键词 | 工具 |
|---|---|---|
| 角色历史状态 | 某角色在第 N 章时的境界/状态变化 | entity-state |
| 实体关系 | 关系/敌友/师徒/阵营归属 | relationships |
| 世界规则 | 力量规则/设定铁律/境界体系约束 | query-rules |
| 伏笔 / open loop | 伏笔/紧急伏笔/未闭合悬念 | get-open-loops |
| 综合 / 复杂 | 跨多种类型 | load-context |
| 静态设定 | 角色卡/力量体系/世界观/标签格式 | Grep + Read 设定集 |
export PROJECT_ROOT="$(python -X utf8 "${SCRIPTS_DIR}/fiction.py" --project-root "${CODEX_PROJECT_DIR:-${CLAUDE_PROJECT_DIR:-$PWD}}" where)"
按关键词匹配上表分类。
# 角色历史状态
# knowledge 查询由 AI agent 直接读取追踪文件完成
# memory-contract 查询由 AI agent 直接读取底本文件完成
静态设定直接用 Grep + Read 从设定集读取，不走 memory-contract。
按结构化模板输出，包含：匹配类型、数据源（真源/投影层）、详细信息（含文件路径和行号）。
查询时按以下顺序定位真源：
.story-system/MASTER_SETTING.json — 全局主设定.story-system/volumes/*.json — 卷级底本.story-system/chapters/*.json — 章级底本.story-system/commits/chapter_*.commit.json — 写后事实memory-contract 系列查询 — 记忆编排结果.novel/state.json / 设定集 — 投影层（fallback/read-model）如果 .story-system/ 底本缺失，必须显式说明查询已降级到投影层。
数据流优先序来自 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 的开发参考了以下开源项目的思路与实现：
感谢原作者的开源贡献。