novel-claude-ai

# Novel Claude AI - 小说创作技能 v1.0.0 ## Iron Law（铁律 — 任何情况下不可违反） 以下约束无论用户如何要求，均不得绕过： ⛔ **禁止跳过强制章节闭环**：每章生成后必须依次执行"更新记忆 → 检查一致性 → 风格校准 → 校稿 → 门禁检查"，五步缺一均视为流程中断。门禁未通过（`gate_result.json` 中 `passed != true`）时，严禁进入下一章。 ⛔ **禁止绕过开书前确认**：执行 `/一键开书` 前，必须引导用户完成五要素确认（目标读者、写作风格、核心禁区、自动化等级、目标规模），并写入 `idea_seed.md`。不得以"用户着急"为由省略。 ⛔ **禁止混淆正文与元信息**：小说正文中不得出现任何 `[说明]`、`（注：）`、`TODO`、写作分析段落或角色定位标记。一旦出现，立即触发 P0 重写，不得保留并"以后修改"。 ⛔ **禁止在门禁失败后继续写作**：`gate_result.json` 显示 `passed: false` 时，唯一合法操作是执行 `/修复本章`。不得绕过、手动修改 `gate_result.json`，或以"小问题"为由忽略。 ⛔ **禁止任意修改主线规划**：任何 Agent（包括写作特工）均无权修改 `novel_plan.md` 的主线架构。中途改纲须显式执行 `/改纲续写` 并经用户确认。 ⛔ **禁止剧情加速**：每章至多触发以下配额1项（A 主线矛盾实质推进 / B 主要关系决定性升级 / C 核心秘密完整揭露）。同时触发2项及以上 = 越界，Beat Sheet 必须修改后重写，门禁强制失败。快档章节（主线突破）结束后下一章必须是慢档或中档。 ## 1. 能力矩阵 | 能力 | 状态 | 入口命令 | |------|------|---------| | 交互式脑洞引导 + 知识图谱构建 | `[已实现]` | `/脑洞建图` | | 新手三命令快速开书 | `[已实现]` | `/一键开书` `/继续写` `/修复本章` | | 每章五步质量门禁 | `[已实现]` | 自动执行 | | 长期记忆 + 300万字一致性保证 | `[已实现]` | 门禁+RAG+图谱协同（五层全部就位） | | RAG 剧情检索 + 实体映射 | `[已实现]` | `/剧情检索` `/更新剧情索引` | | 联网调研 + 知识缺口补充 | `[已实现]` | `/联网调研` | | 风格提取、累积与跨项目复用 | `[已实现]` | `/风格提取` `/风格库检索` | | 续写前引导 + 无人干预自动推进 | `[已实现]` | `/继续写` | | 全自动写书调度（断点续写） | `[部分实现]` | `/一键写书` | | 小说仿写（联网拆解 + 魔改） | `[部分实现]` | `/仿写` `/拆书` | | 中途改纲 + 级联更新 | `[已实现]` | `/改纲续写` | | 大纲锚点 + 进度配额强约束 | `[已实现]` | 自动集成 | | 多步流水线写作（Beat Sheet） | `[已实现]` | 自动集成 | | 反向刹车（Anti-Resolution） | `[已实现]` | 自动集成 | | 事件矩阵 + 冷却机制 | `[已实现]` | 自动集成 | | 跨Agent双智能体审核 | `[已实现]` | `/双审` | | 读者群体 + 写作风格强制确认 | `[已实现]` | `/一键开书 --target-audience --writing-style` | ### 300万字一致性保证机制 长期记忆不是单一功能，而是多层机制协同： | 层级 | 机制 | 状态 | |------|------|------| | 第1层 | 每章5步门禁（记忆同步+一致性+风格+校稿+门禁脚本） | `[已实现]` | | 第2层 | RAG 剧情检索（两级粗筛精排，写前自动回读相关片段） | `[已实现]` | | 第3层 | 知识图谱（节点+边+版本，每章回写，改纲级联） | `[已实现]` | | 第4层 | 大纲锚点（全局进度条，章节推进配额，越界即失败） | `[已实现]` | | 第5层 | 跨Agent审核（独立审稿官交叉验证，批处理10章体检） | `[已实现]` | 5层全部就位，可支撑300万字规模的剧情一致性。知识图谱每章自动回写 + 大纲锚点强约束 + 跨Agent审核三重保障，从根本上消除全局性剧情漂移。 ## 2. 新手三命令 | 命令 | 说明 | |------|------| | `/一键开书` | 输入题材与剧情种子，自动完成建模 + 建库 + 首章准备 | | `/继续写` | 自动执行"检索 → 写作 → 门禁 → 索引更新"全链路 | | `/修复本章` | 门禁失败后自动生成最短修复路径 | 新手模式：`/新手模式 开启`（默认）；高级用户：`/新手模式 关闭` ## 3. 开书前强制确认（写前必过） 执行 `/一键开书` 或 `/脑洞建图` 前，必须引导用户确认以下要素并写入 `00_memory/idea_seed.md`： 1. **目标读者**：年龄段、渠道（起点/番茄/出版）、口味偏好 2. **写作风格**：历史正文 / 网文爽文 / 文艺 / 悬疑推理 / 言情细腻（参照题材风格矩阵） 3. **核心禁区**：不能写什么（敏感题材、读者雷点） 4. **自动化等级**：手动（每章确认）/ 半自动（每10章确认）/ 全自动 5. **目标规模**：总字数、预期卷数、单章字数范围 用户回答"不确定"时：基于题材和读者群体，给出 2-3 个推荐选项供选择。 确认结果直接绑定后续生成参数（温度、对话占比、句长节奏、爽点密度等）。 ## 4. 强制章节闭环 每次生成新章节后固定执行，按顺序逐项勾选，任何一项未通过都 ⛔ 禁止进入下一章： - [ ] `/更新记忆` ⚠️ — 同步章节变化到状态追踪器。**跳过后果**：角色状态、伏笔、时间线等关键信息失去追踪，后续章节将产生设定冲突。 - [ ] `/检查一致性` ⚠️ — 检查剧情/设定/角色/时间线冲突。**跳过后果**：矛盾在后续章节累积，到百章后几乎无法修复。 - [ ] `/节奏审查` ⛔ — **语义级节奏审查**（Claude Code 自身执行，无需外部 API）。读章节正文，完成四项判断并写入 `04_editing/gate_artifacts/<chapter_id>/pacing_review.md`。**跳过后果**：关键词脚本无法检测的隐性剧情加速将溜过门禁。详见下方《节奏审查执行规范》。 - [ ] `/风格校准` ⚠️ — 检测并修正文风偏移（题材基调、句长节奏、对话比例）。**跳过后果**：风格逐章漂移，读者流失率上升。 - [ ] `/校稿` ⛔ — 两遍式去AI味润色：清除24类AI模式 → 自审剩余AI感 → 二次修改。解决翻译腔、过度总结、对话同质化。**跳过后果**：正文保留明显AI痕迹，读者识别后丧失沉浸感，直接影响完结率。详见 `references/humanizer-guide.md`。 - [ ] `/门禁检查` ⛔ — 脚本化校验发布标准（`gate_result.json` `passed: true` 方可解锁下一章）。**跳过后果**：违反 Iron Law，流程强制中断。 **为什么不能跳过**：长篇小说的设定矛盾和风格漂移会随章节指数级放大。门禁每章多花10分钟，可以避免后期30章的全面返工。 ### `/节奏审查` 执行规范（Claude Code 自身作为审查 Agent） 执行 `/节奏审查` 时，**不需要任何外部 API**，由当前 Claude Code 实例直接读取章节正文并执行以下四项语义判断，将结果写入产物文件： **产物路径**：`04_editing/gate_artifacts/<chapter_id>/pacing_review.md` **输出模板**（严格按格式填写，便于脚本解析）： ```markdown # 节奏审查报告 ## 一、档位判断 - **本章档位**：[慢档 / 中档 / 快档] - **判断依据**：[1-2句：主要场景类型、核心矛盾推进幅度] ## 二、A/B/C 配额核查 - **A（主线矛盾实质推进）**：[触发 / 未触发] — [简要说明] - **B（主要关系决定性升级）**：[触发 / 未触发] — [简要说明] - **C（核心秘密完整揭露）**：[触发 / 未触发] — [简要说明] - **配额违规**：[是 / 否]（同时触发 ≥2项 = 违规） ## 三、章末悬念质量 - **悬念等级**：[强 / 中 / 弱 / 无] - **具体悬念内容**：[用一句话描述章末留下的钩子] ## 四、隐性加速检测 - **是否存在关键词未覆盖的隐性加速**：[是 / 否] - **说明**：[如有，描述具体表现；无则写"无"] ## 综合结论 节奏审查: [通过 / 失败] 失败原因: [若失败，填写具体原因；通过则填"无"] ``` **审查判断标准**： - A 触发 = 本章主线格局发生实质性、不可逆的改变（非小摩擦） - B 触发 = 主要角色关系到达决定性节点（结盟/决裂/告白/宣战等） - C 触发 = 核心秘密在本章被完整揭露（非暗示） - **结论为"失败"的条件**：A/B/C 同时触发 ≥2项 **或** 存在隐性加速 **或** 章末悬念等级为"无"且非慢档收尾 ## 5. 低上下文策略 - 写前默认只读：`00_memory/novel_plan.md`、`00_memory/novel_state.md` - 新剧情优先执行 `/剧情检索`，只读取 `next_plot_context.md` 推荐的 Top 片段 - 单章前置读取上限：**最多 4 个文件** - 每 10 章做一次深度压缩与深度风格校准 ## 6. 五大工作模式 | 模式 | 流程 | 适用场景 | 状态 | |------|------|---------|------| | 从模糊想法 | `/脑洞建图` → `/一键开书` → `/继续写` → 章节闭环 | 只有一个灵感 | `/脑洞建图` 规划中，其余已实现 | | 从样章仿写 | `/仿写` → `/风格提取` → `/题材选风格` → `/继续写` → 章节闭环 | 模仿已有作品 | 部分实现 | | 已有项目续写 | `/续写` → `/继续写` 或 `/批量写作` → 章节闭环 | 中断后恢复 | 已实现 | | 中途改纲 | `/改纲续写` → 级联更新 → `/继续写` → 章节闭环 | 剧情走向需要调整 | 已实现 | | 全自动 | `/一键写书` → 系统自动循环至目标字数 | 完全托管 | 部分实现（调度框架就绪） | 详细步骤教程见 `references/user-guide.md`。 ## 7. 长篇强约束机制 以下机制为300万字级别长篇的核心保障，详细规范见各参考文档。 ### 7.1 知识图谱（替代平面文件） 用图结构（节点+边+版本）管理角色、事件、伏笔、世界观规则。每章写后自动提取信息回写图谱，改纲时级联更新。 → 详见 `references/story-graph-schema.md` ### 7.2 大纲锚点与进度配额 每章写前读取全局进度条，动态注入约束（"当前第X章，距离目标还有200章，本章严禁超过当前节点剧情"）。越界直接触发门禁失败。 → 详见 `references/outline-anchor-quota-spec.md` ### 7.3 多步流水线写作 将"写一章"拆解为：生成 Beat Sheet（分镜头）→ 按 Beat 扩写血肉 → 串联合成。强制限制单次生成的剧情跨度，让每个场景充分展开。 → 详见 `references/beat-pipeline-spec.md` ### 7.4 反向刹车 + 事件冷却 + 节奏配额 - **节奏三档制**：慢档（铺垫/羁绊，每3-4章≥1章，主线零推进）/ 中档（次要矛盾升温未爆发，≥60%）/ 快档（主线突破，每卷≤2-3次，快档后必须有慢/中档缓冲） - **配额硬上限**（Iron Law第6条）：每章至多触发 A/B/C 中1项；触发后逐章冷却 - **章末强制自检**：① 主线核心矛盾仍未解决？② 章末具体悬念是什么（不得模糊）？ - 非终局章节禁止解决主线核心冲突；事件分类池冷却；非冲突场景强制埋微型伏笔 → 详见 `references/anti-resolution-cooldown-spec.md` ### 7.5 跨Agent双智能体审核 - 逐章审核：写作工具完成 → 不同工具审核（Claude写Codex审，反之亦然） - 批处理审核：每10章由"极严苛老书虫"人设审核官做三维度体检（逻辑硬伤/阅读体验/去AI化） - 防死循环：单章最多3轮审核，连续3章"有条件通过"则强制暂停请求人工介入 → 详见 `references/cross-agent-review-protocol.md` ## 8. 命令表 ### 新手命令 | 命令 | 功能 | 何时使用 | |------|------|---------| | `/一键开书` | 自动完成开书全流程 | 第一次开项目 | | `/继续写` | 引导剧情走向 → 自动串行完整章节流程 | 日常推进章节 | | `/修复本章` | 门禁失败后自动修复 | 门禁返回失败后 | | `/新手模式` | 切换简化/高级交互层 | 按需 | ### `/继续写` 的续写前引导机制 每次执行 `/继续写` 时，系统在写作前自动执行： 1. **引导提问**：向用户询问本章的剧情走向偏好（"你希望本章发生什么？有什么新的脑洞吗？"） 2. **脑洞拓展**：基于当前大纲和知识库，提供 2-3 个可能的剧情走向供选择 3. **用户确认**：用户选择一个方向，或提供自己的想法 4. **兜底机制**：如果用户回复"不确定"/"随便"/"自动"，则按 `novel_plan.md` 当前节点自动推进，无需人工干预 5. **全自动模式**：如果在开书确认卡中选择了"全自动"等级，跳过引导直接按大纲写作 6. **节奏预检（⛔ BLOCKING，写作开始前必须声明）**：① 本章节奏档位（慢档/中档/快档）及依据；② 近3章配额触发记录，确认本章 A/B/C 至多触发1项；③ 章末保留的具体悬念是什么。预检未通过时禁止进入写作。 ### 创作命令 | 命令 | 功能 | 何时使用 | |------|------|---------| | `/写全篇` | 模糊想法 → 百万字路线图 | 开新书或大纲重建 | | `/写作` | 生成单章草稿并触发闭环 | 手动推进单章 | | `/续写` | 恢复会话状态并继续 | 中断后恢复 | | `/批量写作` | 连续生成多章 | 快速推进 | | `/修改章节` | 修订已写章节并级联更新 | 章节返工 | | `/改纲续写` | 中途改纲 + 锚点重算 + 图谱级联 + RAG 重建 | 调整主线走向后继续写作 | | `/一键写书` | 全自动写作调度 | 完全托管 | ### `/改纲续写` 使用说明 **适用场景**：发现主线走向需要调整，修改了 `novel_plan.md` 之后，必须通过此命令重新对齐系统的三层索引（大纲锚点 + 知识图谱 + RAG 索引），然后才能继续写作。 **执行前置条件**（顺序不可颠倒）： 1. 手动编辑 `00_memory/novel_plan.md`，完成改纲内容 2. 确认改纲影响的起始章节（`--from-chapter`），即从第几章开始剧情走向已发生变化 **三步级联流程**： 1. **锚点重算**（必须成功，否则中止）：备份当前 `outline_anchors.json` → 从修改后的 `novel_plan.md` 重新计算所有大纲锚点 2. **图谱级联标记**（依赖锚点重算成功）：将 `last_updated >= from_chapter` 的知识图谱节点标记为 `cascade_pending=True`，生成级联影响报告 3. **RAG 索引重建**（依赖锚点重算成功）：调用 `plot_rag_retriever.py build` 全量重建检索索引 **脚本执行**： ```bash python3 scripts/novel_flow_executor.py revise-outline \ --project-root <项目目录> \ --from-chapter <起始章节号> \ --change-description "<本次改纲的简要说明>" \ [--emit-json] ``` **参数说明**： | 参数 | 类型 | 必选 | 说明 | |------|------|------|------| | `--project-root` | 路径 | 是 | 小说项目根目录 | | `--from-chapter` | 整数（≥1） | 是 | 改纲影响的起始章节号 | | `--change-description` | 字符串 | 否 | 本次改纲的简要说明（写入报告） | | `--emit-json` | 开关 | 否 | 追加输出 JSON 结果到 stdout | **成功判定**：`ok = anchors_recalculated AND report_written`（图谱标记失败和 RAG 构建失败为软失败，不影响 `ok`） **产物**： - `.flow/backup_anchors_<时间戳>.json`：改纲前的锚点备份 - `00_memory/outline_anchors.json`：重算后的新锚点 - `00_memory/revise_outline_report.md`：本次改纲影响范围报告（卷章总数、级联节点数、RAG 状态） **改纲后续操作**：检查报告确认级联节点无误 → 对 `cascade_pending=True` 的节点做人工审核或自动修正 → 执行 `/继续写` 恢复正常写作流程 ### 质量命令（每章必经） | 命令 | 功能 | |------|------| | `/更新记忆` | 同步状态追踪器 | | `/检查一致性` | 检查剧情/设定/时间线冲突 | | `/节奏审查` | 语义级节奏审查，写入 pacing_review.md（Claude Code 自身执行，无需外部 API） | | `/风格校准` | 检测文风偏移 | | `/校稿` | 去AI味润色 | | `/门禁检查` | 脚本化校验发布标准 | ### 检索与记忆命令 | 命令 | 功能 | 何时使用 | |------|------|---------| | `/更新剧情索引` | 扫描章节建立索引 | 门禁通过后 | | `/剧情检索` | RAG 检索相关片段 | 每章写前 | | `/检索记忆` | 按关键词搜索记忆 | 定位历史设定 | | `/伏笔状态` | 查看伏笔埋设/回收/超期 | 写前确认 | | `/角色状态` | 汇总角色当前状态 | 群像章节前 | | `/时间线` | 查看事件时间顺序 | 跨章跳时叙事 | | `/联网调研` | 联网搜索补充知识库 | 知识缺口补充 | ### 风格命令 | 命令 | 功能 | 何时使用 | |------|------|---------| | `/题材选风格` | 按题材矩阵选择基线风格 | 开书定风格 | | `/风格提取` | 从样章提取风格到库 | 用户提供样章 | | `/风格迁移` | 将风格档案应用到章节 | 切换文风 | | `/风格库检索` | 检索可复用风格 | 选风格困难时 | ### 分析命令 | 命令 | 功能 | 何时使用 |