Imported from leenbj/novel-creator-skill (SKILL.md). Install upstream with npx skills add leenbj/novel-creator-skill. Copyright stays with the author.

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万字一致性保证机制

长期记忆不是单一功能，而是多层机制协同：

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

输出模板（严格按格式填写，便于脚本解析）：

# 节奏审查报告

## 一、档位判断
- **本章档位**：[慢档 / 中档 / 快档]
- **判断依据**：[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项；③ 章末保留的具体悬念是什么。预检未通过时禁止进入写作。

创作命令

/改纲续写 使用说明

适用场景：发现主线走向需要调整，修改了 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 全量重建检索索引

脚本执行：

python3 scripts/novel_flow_executor.py revise-outline \
  --project-root <项目目录> \
  --from-chapter <起始章节号> \
  --change-description "<本次改纲的简要说明>" \
  [--emit-json]

参数说明：

成功判定：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 的节点做人工审核或自动修正 → 执行 /继续写 恢复正常写作流程

质量命令（每章必经）

检索与记忆命令

风格命令

分析命令

规划中命令

9. 脚本入口

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。

10. 参考文档导航

根据你的场景选择对应文档：

11. Agent 编辑团队（/启动编辑团队）

11.1 为什么需要编辑团队

单 Agent 写作存在三个根性问题：

1. AI 幻觉：写作 Agent 可能捏造从未出现过的地名、人名、设定规则
2. 角色错乱：角色被放错位置、被赋予其不具备的能力、或语气风格全部雷同
3. Agent 思路污染正文：写作过程中的分析思路、角色定位说明、meta注记渗入小说正文

编辑团队通过职责严格分离，在生产流程中内建三道防火墙。

11.2 团队架构（真实报社模型）

用户
  │
  ▼
总编辑（Claude Code 主 Agent）
  │  协调所有子 Agent，汇总报告，作最终裁判
  ├──► 策划主编（planning-editor）
  │     读规划文件 → 生成 Chapter Brief → 传给写作特工
  │
  ├──► 写作特工（novelist）
  │     只接收 Brief，只输出纯正文，严格隔离 meta 信息
  │
  ├──► 反AI编辑（anti-ai-editor）      ┐ 并行
  └──► 连载核实官（consistency-reviewer）┘ 审核

11.3 触发命令

/启动编辑团队 [--项目路径 <路径>] [--章节 <N>] [--模式 单章|批量]

单章模式（默认）：完整走一章的生产+审核流程。 批量模式：连续生产并审核多章（每章之间等待门禁通过）。

11.4 执行步骤（Claude Code 按此流程操作）

当收到 /启动编辑团队 时，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()

11.5 正文隔离协议（防止 Agent 思路污染正文）

这是最关键的安全机制：

P0 检测触发器：正文中出现以下任意内容，立即触发 P0 强制重写：

• [ ] 括号包裹的说明文字（如 [此处填写]、[角色A]）
• （注：）、【写作说明】、TODO、作者按等元信息标记
• 写作 Agent 的推理过程或分析性段落出现在正文区域内

11.6 角色一致性强制校验清单

连载核实官每章必须核查的项目（不得省略）：

• 所有出场角色的当前地理位置与 character_tracker 一致
• 所有出场角色的能力边界未被违反
• 已确认死亡/离开的角色未在正文中复活（非明确的回忆/幻觉场景）
• 本章时间点与上一章时间点的推进逻辑合理
• 正文中未出现规划文件和角色档案中从未注册的新地名/人名/组织

11.7 自由创作与规划遵守的平衡机制

编辑团队在以下两类规则之间保持严格分工：

策划主编负责遵守（硬约束）：

• 当前章节的情节任务必须推进
• 本章禁区（不得提前触碰的剧情）必须遵守
• 角色位置和状态的真实性

写作特工负责创新（软自由）：

• 章节入口角度（8种模式轮换，不重复）
• 场景的具体呈现方式
• 对话的具体内容和节奏
• 细节描写的选择

没有任何 Agent 有权限做的事：

• 改变小说主线规划
• 让角色提前到达不该到的地方
• 发明规划文件外的重要设定

11.8 状态管理脚本

# 生成上下文快照（团队启动前必须运行）
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 <路径>