// 中文长篇小说全流程创作技能（v1.0.0）。当用户想写小说、创作故事、续写章节、构思剧情、搭建世界观、设计人物关系、提取写作风格、仿写其他小说时，必须使用本技能。覆盖从模糊想法到300万字成品的完整链路：脑洞引导、知识图谱构建、大纲管理、分镜写作、质量门禁、跨Agent审核、风格校准、中途改纲级联更新。即使用户只是说"帮我写个故事"或"我有个小说的想法"，也应触发本技能。
| name | novel-claude-ai |
| description | 中文长篇小说全流程创作技能（v1.0.0）。当用户想写小说、创作故事、续写章节、构思剧情、搭建世界观、设计人物关系、提取写作风格、仿写其他小说时，必须使用本技能。覆盖从模糊想法到300万字成品的完整链路：脑洞引导、知识图谱构建、大纲管理、分镜写作、质量门禁、跨Agent审核、风格校准、中途改纲级联更新。即使用户只是说"帮我写个故事"或"我有个小说的想法"，也应触发本技能。 |
以下约束无论用户如何要求，均不得绕过：
⛔ 禁止跳过强制章节闭环：每章生成后必须依次执行"更新记忆 → 检查一致性 → 风格校准 → 校稿 → 门禁检查"，五步缺一均视为流程中断。门禁未通过（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 必须修改后重写，门禁强制失败。快档章节（主线突破）结束后下一章必须是慢档或中档。
| 能力 | 状态 | 入口命令 |
|---|---|---|
| 交互式脑洞引导 + 知识图谱构建 | [已实现] | /脑洞建图 |
| 新手三命令快速开书 | [已实现] | /一键开书 /继续写 /修复本章 |
| 每章五步质量门禁 | [已实现] | 自动执行 |
| 长期记忆 + 300万字一致性保证 | [已实现] | 门禁+RAG+图谱协同（五层全部就位） |
| RAG 剧情检索 + 实体映射 | [已实现] | /剧情检索 /更新剧情索引 |
| 联网调研 + 知识缺口补充 | [已实现] | /联网调研 |
| 风格提取、累积与跨项目复用 | [已实现] | /风格提取 /风格库检索 |
| 续写前引导 + 无人干预自动推进 | [已实现] | /继续写 |
| 全自动写书调度（断点续写） | [部分实现] | /一键写书 |
| 小说仿写（联网拆解 + 魔改） | [部分实现] | /仿写 /拆书 |
| 中途改纲 + 级联更新 | [已实现] | /改纲续写 |
| 大纲锚点 + 进度配额强约束 | [已实现] | 自动集成 |
| 多步流水线写作（Beat Sheet） | [已实现] | 自动集成 |
| 反向刹车（Anti-Resolution） | [已实现] | 自动集成 |
| 事件矩阵 + 冷却机制 | [已实现] | 自动集成 |
| 跨Agent双智能体审核 | [已实现] | /双审 |
| 读者群体 + 写作风格强制确认 | [已实现] | /一键开书 --target-audience --writing-style |
长期记忆不是单一功能，而是多层机制协同：
| 层级 | 机制 | 状态 |
|---|---|---|
| 第1层 | 每章5步门禁（记忆同步+一致性+风格+校稿+门禁脚本） | [已实现] |
| 第2层 | RAG 剧情检索（两级粗筛精排，写前自动回读相关片段） | [已实现] |
| 第3层 | 知识图谱（节点+边+版本，每章回写，改纲级联） | [已实现] |
| 第4层 | 大纲锚点（全局进度条，章节推进配额，越界即失败） | [已实现] |
| 第5层 | 跨Agent审核（独立审稿官交叉验证，批处理10章体检） | [已实现] |
5层全部就位，可支撑300万字规模的剧情一致性。知识图谱每章自动回写 + 大纲锚点强约束 + 跨Agent审核三重保障，从根本上消除全局性剧情漂移。
| 命令 | 说明 |
|---|---|
/一键开书 | 输入题材与剧情种子，自动完成建模 + 建库 + 首章准备 |
/继续写 | 自动执行"检索 → 写作 → 门禁 → 索引更新"全链路 |
/修复本章 | 门禁失败后自动生成最短修复路径 |
新手模式：/新手模式 开启（默认）；高级用户：/新手模式 关闭
执行 /一键开书 或 /脑洞建图 前，必须引导用户确认以下要素并写入 00_memory/idea_seed.md：
用户回答"不确定"时：基于题材和读者群体，给出 2-3 个推荐选项供选择。
确认结果直接绑定后续生成参数（温度、对话占比、句长节奏、爽点密度等）。
每次生成新章节后固定执行，按顺序逐项勾选，任何一项未通过都 ⛔ 禁止进入下一章：
/更新记忆 ⚠️ — 同步章节变化到状态追踪器。跳过后果：角色状态、伏笔、时间线等关键信息失去追踪，后续章节将产生设定冲突。/检查一致性 ⚠️ — 检查剧情/设定/角色/时间线冲突。跳过后果：矛盾在后续章节累积，到百章后几乎无法修复。/节奏审查 ⛔ — 语义级节奏审查（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
输出模板（严格按格式填写，便于脚本解析）：
# 节奏审查报告
## 一、档位判断
- **本章档位**：[慢档 / 中档 / 快档]
- **判断依据**：[1-2句：主要场景类型、核心矛盾推进幅度]
## 二、A/B/C 配额核查
- **A（主线矛盾实质推进）**：[触发 / 未触发] — [简要说明]
- **B（主要关系决定性升级）**：[触发 / 未触发] — [简要说明]
- **C（核心秘密完整揭露）**：[触发 / 未触发] — [简要说明]
- **配额违规**：[是 / 否]（同时触发 ≥2项 = 违规）
## 三、章末悬念质量
- **悬念等级**：[强 / 中 / 弱 / 无]
- **具体悬念内容**：[用一句话描述章末留下的钩子]
## 四、隐性加速检测
- **是否存在关键词未覆盖的隐性加速**：[是 / 否]
- **说明**：[如有，描述具体表现；无则写"无"]
## 综合结论
节奏审查: [通过 / 失败]
失败原因: [若失败，填写具体原因；通过则填"无"]
审查判断标准：
00_memory/novel_plan.md、00_memory/novel_state.md/剧情检索，只读取 next_plot_context.md 推荐的 Top 片段| 模式 | 流程 | 适用场景 | 状态 |
|---|---|---|---|
| 从模糊想法 | /脑洞建图 → /一键开书 → /继续写 → 章节闭环 | 只有一个灵感 | /脑洞建图 规划中，其余已实现 |
| 从样章仿写 | /仿写 → /风格提取 → /题材选风格 → /继续写 → 章节闭环 | 模仿已有作品 | 部分实现 |
| 已有项目续写 | /续写 → /继续写 或 /批量写作 → 章节闭环 | 中断后恢复 | 已实现 |
| 中途改纲 | /改纲续写 → 级联更新 → /继续写 → 章节闭环 | 剧情走向需要调整 | 已实现 |
| 全自动 | /一键写书 → 系统自动循环至目标字数 | 完全托管 | 部分实现（调度框架就绪） |
详细步骤教程见 references/user-guide.md。
以下机制为300万字级别长篇的核心保障，详细规范见各参考文档。
用图结构（节点+边+版本）管理角色、事件、伏笔、世界观规则。每章写后自动提取信息回写图谱，改纲时级联更新。
→ 详见 references/story-graph-schema.md
每章写前读取全局进度条，动态注入约束（"当前第X章，距离目标还有200章，本章严禁超过当前节点剧情"）。越界直接触发门禁失败。
→ 详见 references/outline-anchor-quota-spec.md
将"写一章"拆解为：生成 Beat Sheet（分镜头）→ 按 Beat 扩写血肉 → 串联合成。强制限制单次生成的剧情跨度，让每个场景充分展开。
→ 详见 references/beat-pipeline-spec.md
references/anti-resolution-cooldown-spec.mdreferences/cross-agent-review-protocol.md| 命令 | 功能 | 何时使用 |
|---|---|---|
/一键开书 | 自动完成开书全流程 | 第一次开项目 |
/继续写 | 引导剧情走向 → 自动串行完整章节流程 | 日常推进章节 |
/修复本章 | 门禁失败后自动修复 | 门禁返回失败后 |
/新手模式 | 切换简化/高级交互层 | 按需 |
/继续写 的续写前引导机制每次执行 /继续写 时，系统在写作前自动执行：
novel_plan.md 当前节点自动推进，无需人工干预| 命令 | 功能 | 何时使用 |
|---|---|---|
/写全篇 | 模糊想法 → 百万字路线图 | 开新书或大纲重建 |
/写作 | 生成单章草稿并触发闭环 | 手动推进单章 |
/续写 | 恢复会话状态并继续 | 中断后恢复 |
/批量写作 | 连续生成多章 | 快速推进 |
/修改章节 | 修订已写章节并级联更新 | 章节返工 |
/改纲续写 | 中途改纲 + 锚点重算 + 图谱级联 + RAG 重建 | 调整主线走向后继续写作 |
/一键写书 | 全自动写作调度 | 完全托管 |
/改纲续写 使用说明适用场景：发现主线走向需要调整，修改了 novel_plan.md 之后，必须通过此命令重新对齐系统的三层索引（大纲锚点 + 知识图谱 + RAG 索引），然后才能继续写作。
执行前置条件（顺序不可颠倒）：
00_memory/novel_plan.md，完成改纲内容--from-chapter），即从第几章开始剧情走向已发生变化三步级联流程：
outline_anchors.json → 从修改后的 novel_plan.md 重新计算所有大纲锚点last_updated >= from_chapter 的知识图谱节点标记为 cascade_pending=True，生成级联影响报告plot_rag_retriever.py build 全量重建检索索引脚本执行：
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 检索相关片段 | 每章写前 |
/检索记忆 | 按关键词搜索记忆 | 定位历史设定 |
/伏笔状态 | 查看伏笔埋设/回收/超期 | 写前确认 |
/角色状态 | 汇总角色当前状态 | 群像章节前 |
/时间线 | 查看事件时间顺序 | 跨章跳时叙事 |
/联网调研 | 联网搜索补充知识库 | 知识缺口补充 |
| 命令 | 功能 | 何时使用 |
|---|---|---|
/题材选风格 | 按题材矩阵选择基线风格 | 开书定风格 |
/风格提取 | 从样章提取风格到库 | 用户提供样章 |
/风格迁移 | 将风格档案应用到章节 | 切换文风 |
/风格库检索 | 检索可复用风格 | 选风格困难时 |
| 命令 | 功能 | 何时使用 |
|---|---|---|
/拆书 | 拆解作品结构，提炼爽点钩子 | 学习目标作品 |
/仿写 | 提取写法模板与风格特征 | 模仿样章文风 |
| 命令 | 功能 | 何时使用 |
|---|---|---|
/脑洞建图 | 交互式脑洞拓展 + 知识图谱构建 | 只有模糊想法时 |
/双审 | 跨Agent双智能体审核 | 每10章或手动触发 |
/完整流程 | 串联全链路 | 一次性跑通 |
| 脚本 | 用途 |
|---|---|
python3 scripts/novel_flow_executor.py one-click | /一键开书 |
python3 scripts/novel_flow_executor.py continue-write --project-root <目录> --query "<新剧情>" | /继续写（全功能默认开启，无需额外参数） |
python3 scripts/novel_flow_executor.py revise-outline --project-root <目录> --from-chapter <N> --change-description "<说明>" | /改纲续写（锚点重算 + 图谱级联 + RAG 重建） |
python3 scripts/plot_rag_retriever.py build/query | /更新剧情索引 /剧情检索 |
python3 scripts/chapter_gate_check.py | /门禁检查 |
python3 scripts/gate_repair_plan.py | /修复本章 |
python3 scripts/auto_novel_writer.py | /一键写书 |
python3 scripts/style_fingerprint.py | /风格提取 |
python3 scripts/research_agent.py | /联网调研 |
python3 scripts/benchmark_novel_flow.py | /评测基线 |
python3 scripts/story_graph_builder.py | 知识图谱 CRUD / 校验 / Mermaid 导出 |
python3 scripts/outline_anchor_manager.py | 大纲锚点初始化 / 配额检查 / 推进 |
python3 scripts/event_matrix_scheduler.py | 事件矩阵冷却 / 推荐 / 记录 |
python3 scripts/anti_resolution_guard.py | 反向刹车校验 / 约束 prompt 生成 |
python3 scripts/beat_sheet_generator.py | Beat Sheet 生成 / 扩写提示 / 校验 |
python3 scripts/chapter_synthesizer.py | 章节合成 / 合成稿质量校验 |
python3 scripts/cross_agent_reviewer.py | 跨Agent审核任务生成 / 结果记录 |
python3 scripts/story_graph_updater.py | 章节完成后自动提取信息更新图谱 |
python3 scripts/interactive_ideation_engine.py | 交互式脑洞引导 5 轮收敛 / 产出物生成 |
python3 scripts/text_humanizer.py | AI痕迹检测 / 两遍式润色 prompt 生成（自动集成到章节写作流程） |
python3 scripts/editorial_team_manager.py | 编辑团队状态管理：快照/审核记录/状态查询/人工介入检测 |
continue-write 标准用法（v1.0.0，全功能默认开启）：
# 标准用法：知识图谱/大纲锚点/Beat Sheet/AI痕迹纠正/风格更新均自动激活
python3 scripts/novel_flow_executor.py continue-write \
--project-root <项目目录> --query "<新剧情>"
# 高级用户：按需关闭部分功能
python3 scripts/novel_flow_executor.py continue-write \
--project-root <项目目录> --query "<新剧情>" \
--no-beat-sheet --no-constraints --no-graph-update
完整参数说明见 references/command-playbook.md。
根据你的场景选择对应文档：
| 你想做什么 | 读哪个文档 |
|---|---|
| 第一次使用，从零开书 | references/user-guide.md |
| 查看某个命令的完整参数 | references/command-playbook.md |
| 理解门禁产物和通过标准 | references/gate-artifacts-spec.md |
| 规划百万字级别的卷章结构 | references/million-word-roadmap.md |
| 选择合适的写作风格 | references/genre-style-matrix.md |
| 理解 RAG 检索的设计原理 | references/rag-consistency-design.md |
| 使用联网调研功能 | references/research-guide.md |
| 使用全自动写书功能 | references/auto-write-guide.md |
| 执行 /校稿 去AI味润色 | references/humanizer-guide.md |
| 了解知识图谱数据结构 | references/story-graph-schema.md |
| 了解大纲锚点与进度配额 | references/outline-anchor-quota-spec.md |
| 了解多步流水线写作 | references/beat-pipeline-spec.md |
| 了解反向刹车与事件冷却 | references/anti-resolution-cooldown-spec.md |
| 了解跨Agent审核协议 | references/cross-agent-review-protocol.md |
| 了解脑洞引导流程 | references/interactive-brainstorming-playbook.md |
| 仿写或魔改已有小说 | references/adaptation-workflow.md |
| 了解编辑团队架构与工作协议 | references/editorial-team-protocol.md |
/启动编辑团队）单 Agent 写作存在三个根性问题：
编辑团队通过职责严格分离，在生产流程中内建三道防火墙。
用户
│
▼
总编辑（Claude Code 主 Agent）
│ 协调所有子 Agent，汇总报告，作最终裁判
├──► 策划主编（planning-editor）
│ 读规划文件 → 生成 Chapter Brief → 传给写作特工
│
├──► 写作特工（novelist）
│ 只接收 Brief，只输出纯正文，严格隔离 meta 信息
│
├──► 反AI编辑（anti-ai-editor） ┐ 并行
└──► 连载核实官（consistency-reviewer）┘ 审核
/启动编辑团队 [--项目路径 <路径>] [--章节 <N>] [--模式 单章|批量]
单章模式（默认）：完整走一章的生产+审核流程。 批量模式：连续生产并审核多章（每章之间等待门禁通过）。
当收到 /启动编辑团队 时，Claude Code 执行：
步骤 0：准备上下文快照
python3 scripts/editorial_team_manager.py snapshot --project-root <路径>
→ 读取输出中的 context_file 路径和 current_chapter_no
步骤 1：创建团队
TeamCreate(team_name="editorial-team-ch{N}", description="第N章编辑生产")
步骤 2：召唤策划主编
Agent(subagent_type="planning-editor", team_name=..., name="planning-editor",
prompt="请读取以下文件并生成第N章 Chapter Brief：
novel_plan.md={路径}
novel_state.md={路径}
character_tracker.md={路径}")
→ 等待 CHAPTER_BRIEF_START...CHAPTER_BRIEF_END
步骤 3：召唤写作特工
Agent(subagent_type="novelist", team_name=..., name="novelist",
prompt="[将完整 CHAPTER_BRIEF 原文粘贴于此]")
→ 等待 NOVEL_TEXT_START...NOVEL_TEXT_END
步骤 4：并行召唤审核者（同时发起）
Agent(subagent_type="anti-ai-editor", team_name=..., name="anti-ai-editor",
prompt="请对以下章节正文执行去AI化审核：\n[NOVEL_TEXT]")
Agent(subagent_type="consistency-reviewer", team_name=..., name="consistency-reviewer",
prompt="请核查以下章节正文，项目路径：<路径>\n[NOVEL_TEXT]")
→ 等待两份报告
步骤 5：总编辑汇总判定
- 如有 P0 → 返工（最多2次）
- 无 P0 → 使用反AI编辑润色后的版本
- 记录结果：
python3 scripts/editorial_team_manager.py record-review \
--project-root <路径> --chapter N --stage final --verdict pass/conditional/rewrite \
--p0 X --p1 Y --p2 Z
步骤 6：输出最终章节包
将 FINAL_CHAPTER_PACKAGE 写入 03_manuscript/第N章-[标题].md
步骤 7：检查是否需要人工介入
python3 scripts/editorial_team_manager.py need-human --project-root <路径>
→ 如 need_human=true，暂停并向用户汇报
步骤 8：关闭团队
SendMessage(type="shutdown_request") × 各子 Agent
TeamDelete()
这是最关键的安全机制：
| Agent | 允许的输出内容 | 严禁的输出内容 |
|---|---|---|
| 写作特工 | NOVEL_TEXT_START 到 NOVEL_TEXT_END 之间的纯小说正文 | 分析说明、角色定位、写作思路、meta注记、括号说明 |
| 反AI编辑 | 报告 + HUMANIZED_TEXT 标记内的净化正文 | 在润色后正文中插入任何注释 |
| 连载核实官 | 结构化核查报告 | 直接修改正文 |
| 总编辑 | 最终章节包（正文与报告分区） | 将审核意见混入正文区 |
P0 检测触发器：正文中出现以下任意内容，立即触发 P0 强制重写：
[ ] 括号包裹的说明文字（如 [此处填写]、[角色A]）（注：）、【写作说明】、TODO、作者按等元信息标记连载核实官每章必须核查的项目（不得省略）：
编辑团队在以下两类规则之间保持严格分工：
策划主编负责遵守（硬约束）：
写作特工负责创新（软自由）：
没有任何 Agent 有权限做的事：
# 生成上下文快照（团队启动前必须运行）
python3 scripts/editorial_team_manager.py snapshot --project-root <路径>
# 记录单次审核结果
python3 scripts/editorial_team_manager.py record-review \
--project-root <路径> --chapter N --stage final \
--verdict pass --p0 0 --p1 2 --p2 3
# 查看最近10章审核历史
python3 scripts/editorial_team_manager.py status --project-root <路径>
# 检测是否需要人工介入
python3 scripts/editorial_team_manager.py need-human --project-root <路径>