Skip to content
Back to search

novel-claude-ai

SkillWorks with Claude CodeGitHub

中文长篇小说全流程创作技能(v1.0.0)。当用户想写小说、创作故事、续写章节、构思剧情、搭建世界观、设计人物关系、提取写作风格、仿写其他小说时,必须使用本技能。覆盖从模糊想法到300万字成品的完整链路:脑洞引导、知识图谱构建、大纲管理、分镜写作、质量门禁、跨Agent审核、风格校准、中途改纲级联更新。即使用户只是说"帮我写个故事"或"我有个小说的想法",也应触发本技能。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/leenbj--novel-creator-skill/badge.svg)](/listings/leenbj--novel-creator-skill)

HTML

<a href="/listings/leenbj--novel-creator-skill"><img src="/api/listings/leenbj--novel-creator-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 528 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: novel-claude-ai
  3. description: 中文长篇小说全流程创作技能(v1.0.0)。当用户想写小说、创作故事、续写章节、构思剧情、搭建世界观、设计人物关系、提取写作风格、仿写其他小说时,必须使用本技能。覆盖从模糊想法到300万字成品的完整链路:脑洞引导、知识图谱构建、大纲管理、分镜写作、质量门禁、跨Agent审核、风格校准、中途改纲级联更新。即使用户只是说"帮我写个故事"或"我有个小说的想法",也应触发本技能。
  4. ---
  5. # Novel Claude AI - 小说创作技能 v1.0.0
  6. ## Iron Law(铁律 — 任何情况下不可违反)
  7. 以下约束无论用户如何要求,均不得绕过:
  8. ⛔ **禁止跳过强制章节闭环**:每章生成后必须依次执行"更新记忆 → 检查一致性 → 风格校准 → 校稿 → 门禁检查",五步缺一均视为流程中断。门禁未通过(`gate_result.json` 中 `passed != true`)时,严禁进入下一章。
  9. ⛔ **禁止绕过开书前确认**:执行 `/一键开书` 前,必须引导用户完成五要素确认(目标读者、写作风格、核心禁区、自动化等级、目标规模),并写入 `idea_seed.md`。不得以"用户着急"为由省略。
  10. ⛔ **禁止混淆正文与元信息**:小说正文中不得出现任何 `[说明]`、`(注:)`、`TODO`、写作分析段落或角色定位标记。一旦出现,立即触发 P0 重写,不得保留并"以后修改"。
  11. ⛔ **禁止在门禁失败后继续写作**:`gate_result.json` 显示 `passed: false` 时,唯一合法操作是执行 `/修复本章`。不得绕过、手动修改 `gate_result.json`,或以"小问题"为由忽略。
  12. ⛔ **禁止任意修改主线规划**:任何 Agent(包括写作特工)均无权修改 `novel_plan.md` 的主线架构。中途改纲须显式执行 `/改纲续写` 并经用户确认。
  13. ⛔ **禁止剧情加速**:每章至多触发以下配额1项(A 主线矛盾实质推进 / B 主要关系决定性升级 / C 核心秘密完整揭露)。同时触发2项及以上 = 越界,Beat Sheet 必须修改后重写,门禁强制失败。快档章节(主线突破)结束后下一章必须是慢档或中档。
  14. ## 1. 能力矩阵
  15. | 能力 | 状态 | 入口命令 |
  16. |------|------|---------|
  17. | 交互式脑洞引导 + 知识图谱构建 | `[已实现]` | `/脑洞建图` |
  18. | 新手三命令快速开书 | `[已实现]` | `/一键开书` `/继续写` `/修复本章` |
  19. | 每章五步质量门禁 | `[已实现]` | 自动执行 |
  20. | 长期记忆 + 300万字一致性保证 | `[已实现]` | 门禁+RAG+图谱协同(五层全部就位) |
  21. | RAG 剧情检索 + 实体映射 | `[已实现]` | `/剧情检索` `/更新剧情索引` |
  22. | 联网调研 + 知识缺口补充 | `[已实现]` | `/联网调研` |
  23. | 风格提取、累积与跨项目复用 | `[已实现]` | `/风格提取` `/风格库检索` |
  24. | 续写前引导 + 无人干预自动推进 | `[已实现]` | `/继续写` |
  25. | 全自动写书调度(断点续写) | `[部分实现]` | `/一键写书` |
  26. | 小说仿写(联网拆解 + 魔改) | `[部分实现]` | `/仿写` `/拆书` |
  27. | 中途改纲 + 级联更新 | `[已实现]` | `/改纲续写` |
  28. | 大纲锚点 + 进度配额强约束 | `[已实现]` | 自动集成 |
  29. | 多步流水线写作(Beat Sheet) | `[已实现]` | 自动集成 |
  30. | 反向刹车(Anti-Resolution) | `[已实现]` | 自动集成 |
  31. | 事件矩阵 + 冷却机制 | `[已实现]` | 自动集成 |
  32. | 跨Agent双智能体审核 | `[已实现]` | `/双审` |
  33. | 读者群体 + 写作风格强制确认 | `[已实现]` | `/一键开书 --target-audience --writing-style` |
  34. ### 300万字一致性保证机制
  35. 长期记忆不是单一功能,而是多层机制协同:
  36. | 层级 | 机制 | 状态 |
  37. |------|------|------|
  38. | 第1层 | 每章5步门禁(记忆同步+一致性+风格+校稿+门禁脚本) | `[已实现]` |
  39. | 第2层 | RAG 剧情检索(两级粗筛精排,写前自动回读相关片段) | `[已实现]` |
  40. | 第3层 | 知识图谱(节点+边+版本,每章回写,改纲级联) | `[已实现]` |
  41. | 第4层 | 大纲锚点(全局进度条,章节推进配额,越界即失败) | `[已实现]` |
  42. | 第5层 | 跨Agent审核(独立审稿官交叉验证,批处理10章体检) | `[已实现]` |
  43. 5层全部就位,可支撑300万字规模的剧情一致性。知识图谱每章自动回写 + 大纲锚点强约束 + 跨Agent审核三重保障,从根本上消除全局性剧情漂移。
  44. ## 2. 新手三命令
  45. | 命令 | 说明 |
  46. |------|------|
  47. | `/一键开书` | 输入题材与剧情种子,自动完成建模 + 建库 + 首章准备 |
  48. | `/继续写` | 自动执行"检索 → 写作 → 门禁 → 索引更新"全链路 |
  49. | `/修复本章` | 门禁失败后自动生成最短修复路径 |
  50. 新手模式:`/新手模式 开启`(默认);高级用户:`/新手模式 关闭`
  51. ## 3. 开书前强制确认(写前必过)
  52. 执行 `/一键开书` 或 `/脑洞建图` 前,必须引导用户确认以下要素并写入 `00_memory/idea_seed.md`:
  53. 1. **目标读者**:年龄段、渠道(起点/番茄/出版)、口味偏好
  54. 2. **写作风格**:历史正文 / 网文爽文 / 文艺 / 悬疑推理 / 言情细腻(参照题材风格矩阵)
  55. 3. **核心禁区**:不能写什么(敏感题材、读者雷点)
  56. 4. **自动化等级**:手动(每章确认)/ 半自动(每10章确认)/ 全自动
  57. 5. **目标规模**:总字数、预期卷数、单章字数范围
  58. 用户回答"不确定"时:基于题材和读者群体,给出 2-3 个推荐选项供选择。
  59. 确认结果直接绑定后续生成参数(温度、对话占比、句长节奏、爽点密度等)。
  60. ## 4. 强制章节闭环
  61. 每次生成新章节后固定执行,按顺序逐项勾选,任何一项未通过都 ⛔ 禁止进入下一章:
  62. - [ ] `/更新记忆` ⚠️ — 同步章节变化到状态追踪器。**跳过后果**:角色状态、伏笔、时间线等关键信息失去追踪,后续章节将产生设定冲突。
  63. - [ ] `/检查一致性` ⚠️ — 检查剧情/设定/角色/时间线冲突。**跳过后果**:矛盾在后续章节累积,到百章后几乎无法修复。
  64. - [ ] `/节奏审查` ⛔ — **语义级节奏审查**(Claude Code 自身执行,无需外部 API)。读章节正文,完成四项判断并写入 `04_editing/gate_artifacts/<chapter_id>/pacing_review.md`。**跳过后果**:关键词脚本无法检测的隐性剧情加速将溜过门禁。详见下方《节奏审查执行规范》。
  65. - [ ] `/风格校准` ⚠️ — 检测并修正文风偏移(题材基调、句长节奏、对话比例)。**跳过后果**:风格逐章漂移,读者流失率上升。
  66. - [ ] `/校稿` ⛔ — 两遍式去AI味润色:清除24类AI模式 → 自审剩余AI感 → 二次修改。解决翻译腔、过度总结、对话同质化。**跳过后果**:正文保留明显AI痕迹,读者识别后丧失沉浸感,直接影响完结率。详见 `references/humanizer-guide.md`。
  67. - [ ] `/门禁检查` ⛔ — 脚本化校验发布标准(`gate_result.json` `passed: true` 方可解锁下一章)。**跳过后果**:违反 Iron Law,流程强制中断。
  68. **为什么不能跳过**:长篇小说的设定矛盾和风格漂移会随章节指数级放大。门禁每章多花10分钟,可以避免后期30章的全面返工。
  69. ### `/节奏审查` 执行规范(Claude Code 自身作为审查 Agent)
  70. 执行 `/节奏审查` 时,**不需要任何外部 API**,由当前 Claude Code 实例直接读取章节正文并执行以下四项语义判断,将结果写入产物文件:
  71. **产物路径**:`04_editing/gate_artifacts/<chapter_id>/pacing_review.md`
  72. **输出模板**(严格按格式填写,便于脚本解析):
  73. ```markdown
  74. # 节奏审查报告
  75. ## 一、档位判断
  76. - **本章档位**:[慢档 / 中档 / 快档]
  77. - **判断依据**:[1-2句:主要场景类型、核心矛盾推进幅度]
  78. ## 二、A/B/C 配额核查
  79. - **A(主线矛盾实质推进)**:[触发 / 未触发] — [简要说明]
  80. - **B(主要关系决定性升级)**:[触发 / 未触发] — [简要说明]
  81. - **C(核心秘密完整揭露)**:[触发 / 未触发] — [简要说明]
  82. - **配额违规**:[是 / 否](同时触发 ≥2项 = 违规)
  83. ## 三、章末悬念质量
  84. - **悬念等级**:[强 / 中 / 弱 / 无]
  85. - **具体悬念内容**:[用一句话描述章末留下的钩子]
  86. ## 四、隐性加速检测
  87. - **是否存在关键词未覆盖的隐性加速**:[是 / 否]
  88. - **说明**:[如有,描述具体表现;无则写"无"]
  89. ## 综合结论
  90. 节奏审查: [通过 / 失败]
  91. 失败原因: [若失败,填写具体原因;通过则填"无"]
  92. ```
  93. **审查判断标准**:
  94. - A 触发 = 本章主线格局发生实质性、不可逆的改变(非小摩擦)
  95. - B 触发 = 主要角色关系到达决定性节点(结盟/决裂/告白/宣战等)
  96. - C 触发 = 核心秘密在本章被完整揭露(非暗示)
  97. - **结论为"失败"的条件**:A/B/C 同时触发 ≥2项 **或** 存在隐性加速 **或** 章末悬念等级为"无"且非慢档收尾
  98. ## 5. 低上下文策略
  99. - 写前默认只读:`00_memory/novel_plan.md`、`00_memory/novel_state.md`
  100. - 新剧情优先执行 `/剧情检索`,只读取 `next_plot_context.md` 推荐的 Top 片段
  101. - 单章前置读取上限:**最多 4 个文件**
  102. - 每 10 章做一次深度压缩与深度风格校准
  103. ## 6. 五大工作模式
  104. | 模式 | 流程 | 适用场景 | 状态 |
  105. |------|------|---------|------|
  106. | 从模糊想法 | `/脑洞建图` → `/一键开书` → `/继续写` → 章节闭环 | 只有一个灵感 | `/脑洞建图` 规划中,其余已实现 |
  107. | 从样章仿写 | `/仿写` → `/风格提取` → `/题材选风格` → `/继续写` → 章节闭环 | 模仿已有作品 | 部分实现 |
  108. | 已有项目续写 | `/续写` → `/继续写` 或 `/批量写作` → 章节闭环 | 中断后恢复 | 已实现 |
  109. | 中途改纲 | `/改纲续写` → 级联更新 → `/继续写` → 章节闭环 | 剧情走向需要调整 | 已实现 |
  110. | 全自动 | `/一键写书` → 系统自动循环至目标字数 | 完全托管 | 部分实现(调度框架就绪) |
  111. 详细步骤教程见 `references/user-guide.md`。
  112. ## 7. 长篇强约束机制
  113. 以下机制为300万字级别长篇的核心保障,详细规范见各参考文档。
  114. ### 7.1 知识图谱(替代平面文件)
  115. 用图结构(节点+边+版本)管理角色、事件、伏笔、世界观规则。每章写后自动提取信息回写图谱,改纲时级联更新。
  116. → 详见 `references/story-graph-schema.md`
  117. ### 7.2 大纲锚点与进度配额
  118. 每章写前读取全局进度条,动态注入约束("当前第X章,距离目标还有200章,本章严禁超过当前节点剧情")。越界直接触发门禁失败。
  119. → 详见 `references/outline-anchor-quota-spec.md`
  120. ### 7.3 多步流水线写作
  121. 将"写一章"拆解为:生成 Beat Sheet(分镜头)→ 按 Beat 扩写血肉 → 串联合成。强制限制单次生成的剧情跨度,让每个场景充分展开。
  122. → 详见 `references/beat-pipeline-spec.md`
  123. ### 7.4 反向刹车 + 事件冷却 + 节奏配额
  124. - **节奏三档制**:慢档(铺垫/羁绊,每3-4章≥1章,主线零推进)/ 中档(次要矛盾升温未爆发,≥60%)/ 快档(主线突破,每卷≤2-3次,快档后必须有慢/中档缓冲)
  125. - **配额硬上限**(Iron Law第6条):每章至多触发 A/B/C 中1项;触发后逐章冷却
  126. - **章末强制自检**:① 主线核心矛盾仍未解决?② 章末具体悬念是什么(不得模糊)?
  127. - 非终局章节禁止解决主线核心冲突;事件分类池冷却;非冲突场景强制埋微型伏笔
  128. → 详见 `references/anti-resolution-cooldown-spec.md`
  129. ### 7.5 跨Agent双智能体审核
  130. - 逐章审核:写作工具完成 → 不同工具审核(Claude写Codex审,反之亦然)
  131. - 批处理审核:每10章由"极严苛老书虫"人设审核官做三维度体检(逻辑硬伤/阅读体验/去AI化)
  132. - 防死循环:单章最多3轮审核,连续3章"有条件通过"则强制暂停请求人工介入
  133. → 详见 `references/cross-agent-review-protocol.md`
  134. ## 8. 命令表
  135. ### 新手命令
  136. | 命令 | 功能 | 何时使用 |
  137. |------|------|---------|
  138. | `/一键开书` | 自动完成开书全流程 | 第一次开项目 |
  139. | `/继续写` | 引导剧情走向 → 自动串行完整章节流程 | 日常推进章节 |
  140. | `/修复本章` | 门禁失败后自动修复 | 门禁返回失败后 |
  141. | `/新手模式` | 切换简化/高级交互层 | 按需 |
  142. ### `/继续写` 的续写前引导机制
  143. 每次执行 `/继续写` 时,系统在写作前自动执行:
  144. 1. **引导提问**:向用户询问本章的剧情走向偏好("你希望本章发生什么?有什么新的脑洞吗?")
  145. 2. **脑洞拓展**:基于当前大纲和知识库,提供 2-3 个可能的剧情走向供选择
  146. 3. **用户确认**:用户选择一个方向,或提供自己的想法
  147. 4. **兜底机制**:如果用户回复"不确定"/"随便"/"自动",则按 `novel_plan.md` 当前节点自动推进,无需人工干预
  148. 5. **全自动模式**:如果在开书确认卡中选择了"全自动"等级,跳过引导直接按大纲写作
  149. 6. **节奏预检(⛔ BLOCKING,写作开始前必须声明)**:① 本章节奏档位(慢档/中档/快档)及依据;② 近3章配额触发记录,确认本章 A/B/C 至多触发1项;③ 章末保留的具体悬念是什么。预检未通过时禁止进入写作。
  150. ### 创作命令
  151. | 命令 | 功能 | 何时使用 |
  152. |------|------|---------|
  153. | `/写全篇` | 模糊想法 → 百万字路线图 | 开新书或大纲重建 |
  154. | `/写作` | 生成单章草稿并触发闭环 | 手动推进单章 |
  155. | `/续写` | 恢复会话状态并继续 | 中断后恢复 |
  156. | `/批量写作` | 连续生成多章 | 快速推进 |
  157. | `/修改章节` | 修订已写章节并级联更新 | 章节返工 |
  158. | `/改纲续写` | 中途改纲 + 锚点重算 + 图谱级联 + RAG 重建 | 调整主线走向后继续写作 |
  159. | `/一键写书` | 全自动写作调度 | 完全托管 |
  160. ### `/改纲续写` 使用说明
  161. **适用场景**:发现主线走向需要调整,修改了 `novel_plan.md` 之后,必须通过此命令重新对齐系统的三层索引(大纲锚点 + 知识图谱 + RAG 索引),然后才能继续写作。
  162. **执行前置条件**(顺序不可颠倒):
  163. 1. 手动编辑 `00_memory/novel_plan.md`,完成改纲内容
  164. 2. 确认改纲影响的起始章节(`--from-chapter`),即从第几章开始剧情走向已发生变化
  165. **三步级联流程**:
  166. 1. **锚点重算**(必须成功,否则中止):备份当前 `outline_anchors.json` → 从修改后的 `novel_plan.md` 重新计算所有大纲锚点
  167. 2. **图谱级联标记**(依赖锚点重算成功):将 `last_updated >= from_chapter` 的知识图谱节点标记为 `cascade_pending=True`,生成级联影响报告
  168. 3. **RAG 索引重建**(依赖锚点重算成功):调用 `plot_rag_retriever.py build` 全量重建检索索引
  169. **脚本执行**:
  170. ```bash
  171. python3 scripts/novel_flow_executor.py revise-outline \
  172. --project-root <项目目录> \
  173. --from-chapter <起始章节号> \
  174. --change-description "<本次改纲的简要说明>" \
  175. [--emit-json]
  176. ```
  177. **参数说明**:
  178. | 参数 | 类型 | 必选 | 说明 |
  179. |------|------|------|------|
  180. | `--project-root` | 路径 | 是 | 小说项目根目录 |
  181. | `--from-chapter` | 整数(≥1) | 是 | 改纲影响的起始章节号 |
  182. | `--change-description` | 字符串 | 否 | 本次改纲的简要说明(写入报告) |
  183. | `--emit-json` | 开关 | 否 | 追加输出 JSON 结果到 stdout |
  184. **成功判定**:`ok = anchors_recalculated AND report_written`(图谱标记失败和 RAG 构建失败为软失败,不影响 `ok`)
  185. **产物**:
  186. - `.flow/backup_anchors_<时间戳>.json`:改纲前的锚点备份
  187. - `00_memory/outline_anchors.json`:重算后的新锚点
  188. - `00_memory/revise_outline_report.md`:本次改纲影响范围报告(卷章总数、级联节点数、RAG 状态)
  189. **改纲后续操作**:检查报告确认级联节点无误 → 对 `cascade_pending=True` 的节点做人工审核或自动修正 → 执行 `/继续写` 恢复正常写作流程
  190. ### 质量命令(每章必经)
  191. | 命令 | 功能 |
  192. |------|------|
  193. | `/更新记忆` | 同步状态追踪器 |
  194. | `/检查一致性` | 检查剧情/设定/时间线冲突 |
  195. | `/节奏审查` | 语义级节奏审查,写入 pacing_review.md(Claude Code 自身执行,无需外部 API) |
  196. | `/风格校准` | 检测文风偏移 |
  197. | `/校稿` | 去AI味润色 |
  198. | `/门禁检查` | 脚本化校验发布标准 |
  199. ### 检索与记忆命令
  200. | 命令 | 功能 | 何时使用 |
  201. |------|------|---------|
  202. | `/更新剧情索引` | 扫描章节建立索引 | 门禁通过后 |
  203. | `/剧情检索` | RAG 检索相关片段 | 每章写前 |
  204. | `/检索记忆` | 按关键词搜索记忆 | 定位历史设定 |
  205. | `/伏笔状态` | 查看伏笔埋设/回收/超期 | 写前确认 |
  206. | `/角色状态` | 汇总角色当前状态 | 群像章节前 |
  207. | `/时间线` | 查看事件时间顺序 | 跨章跳时叙事 |
  208. | `/联网调研` | 联网搜索补充知识库 | 知识缺口补充 |
  209. ### 风格命令
  210. | 命令 | 功能 | 何时使用 |
  211. |------|------|---------|
  212. | `/题材选风格` | 按题材矩阵选择基线风格 | 开书定风格 |
  213. | `/风格提取` | 从样章提取风格到库 | 用户提供样章 |
  214. | `/风格迁移` | 将风格档案应用到章节 | 切换文风 |
  215. | `/风格库检索` | 检索可复用风格 | 选风格困难时 |
  216. ### 分析命令
  217. | 命令 | 功能 | 何时使用 |
  218. |------|------|---------|
  219. | `/拆书` | 拆解作品结构,提炼爽点钩子 | 学习目标作品 |
  220. | `/仿写` | 提取写法模板与风格特征 | 模仿样章文风 |
  221. ### 规划中命令
  222. | 命令 | 功能 | 何时使用 |
  223. |------|------|---------|
  224. | `/脑洞建图` | 交互式脑洞拓展 + 知识图谱构建 | 只有模糊想法时 |
  225. | `/双审` | 跨Agent双智能体审核 | 每10章或手动触发 |
  226. | `/完整流程` | 串联全链路 | 一次性跑通 |
  227. ## 9. 脚本入口
  228. | 脚本 | 用途 |
  229. |------|------|
  230. | `python3 scripts/novel_flow_executor.py one-click` | `/一键开书` |
  231. | `python3 scripts/novel_flow_executor.py continue-write --project-root <目录> --query "<新剧情>"` | `/继续写`(全功能默认开启,无需额外参数) |
  232. | `python3 scripts/novel_flow_executor.py revise-outline --project-root <目录> --from-chapter <N> --change-description "<说明>"` | `/改纲续写`(锚点重算 + 图谱级联 + RAG 重建) |
  233. | `python3 scripts/plot_rag_retriever.py build/query` | `/更新剧情索引` `/剧情检索` |
  234. | `python3 scripts/chapter_gate_check.py` | `/门禁检查` |
  235. | `python3 scripts/gate_repair_plan.py` | `/修复本章` |
  236. | `python3 scripts/auto_novel_writer.py` | `/一键写书` |
  237. | `python3 scripts/style_fingerprint.py` | `/风格提取` |
  238. | `python3 scripts/research_agent.py` | `/联网调研` |
  239. | `python3 scripts/benchmark_novel_flow.py` | `/评测基线` |
  240. | `python3 scripts/story_graph_builder.py` | 知识图谱 CRUD / 校验 / Mermaid 导出 |
  241. | `python3 scripts/outline_anchor_manager.py` | 大纲锚点初始化 / 配额检查 / 推进 |
  242. | `python3 scripts/event_matrix_scheduler.py` | 事件矩阵冷却 / 推荐 / 记录 |
  243. | `python3 scripts/anti_resolution_guard.py` | 反向刹车校验 / 约束 prompt 生成 |
  244. | `python3 scripts/beat_sheet_generator.py` | Beat Sheet 生成 / 扩写提示 / 校验 |
  245. | `python3 scripts/chapter_synthesizer.py` | 章节合成 / 合成稿质量校验 |
  246. | `python3 scripts/cross_agent_reviewer.py` | 跨Agent审核任务生成 / 结果记录 |
  247. | `python3 scripts/story_graph_updater.py` | 章节完成后自动提取信息更新图谱 |
  248. | `python3 scripts/interactive_ideation_engine.py` | 交互式脑洞引导 5 轮收敛 / 产出物生成 |
  249. | `python3 scripts/text_humanizer.py` | AI痕迹检测 / 两遍式润色 prompt 生成(自动集成到章节写作流程) |
  250. | `python3 scripts/editorial_team_manager.py` | 编辑团队状态管理:快照/审核记录/状态查询/人工介入检测 |
  251. **`continue-write` 标准用法(v1.0.0,全功能默认开启):**
  252. ```bash
  253. # 标准用法:知识图谱/大纲锚点/Beat Sheet/AI痕迹纠正/风格更新均自动激活
  254. python3 scripts/novel_flow_executor.py continue-write \
  255. --project-root <项目目录> --query "<新剧情>"
  256. # 高级用户:按需关闭部分功能
  257. python3 scripts/novel_flow_executor.py continue-write \
  258. --project-root <项目目录> --query "<新剧情>" \
  259. --no-beat-sheet --no-constraints --no-graph-update
  260. ```
  261. 完整参数说明见 `references/command-playbook.md`。
  262. ## 10. 参考文档导航
  263. 根据你的场景选择对应文档:
  264. | 你想做什么 | 读哪个文档 |
  265. |-----------|-----------|
  266. | 第一次使用,从零开书 | `references/user-guide.md` |
  267. | 查看某个命令的完整参数 | `references/command-playbook.md` |
  268. | 理解门禁产物和通过标准 | `references/gate-artifacts-spec.md` |
  269. | 规划百万字级别的卷章结构 | `references/million-word-roadmap.md` |
  270. | 选择合适的写作风格 | `references/genre-style-matrix.md` |
  271. | 理解 RAG 检索的设计原理 | `references/rag-consistency-design.md` |
  272. | 使用联网调研功能 | `references/research-guide.md` |
  273. | 使用全自动写书功能 | `references/auto-write-guide.md` |
  274. | 执行 /校稿 去AI味润色 | `references/humanizer-guide.md` |
  275. | 了解知识图谱数据结构 | `references/story-graph-schema.md` |
  276. | 了解大纲锚点与进度配额 | `references/outline-anchor-quota-spec.md` |
  277. | 了解多步流水线写作 | `references/beat-pipeline-spec.md` |
  278. | 了解反向刹车与事件冷却 | `references/anti-resolution-cooldown-spec.md` |
  279. | 了解跨Agent审核协议 | `references/cross-agent-review-protocol.md` |
  280. | 了解脑洞引导流程 | `references/interactive-brainstorming-playbook.md` |
  281. | 仿写或魔改已有小说 | `references/adaptation-workflow.md` |
  282. | 了解编辑团队架构与工作协议 | `references/editorial-team-protocol.md` |
  283. ## 11. Agent 编辑团队(`/启动编辑团队`)
  284. ### 11.1 为什么需要编辑团队
  285. 单 Agent 写作存在三个根性问题:
  286. 1. **AI 幻觉**:写作 Agent 可能捏造从未出现过的地名、人名、设定规则
  287. 2. **角色错乱**:角色被放错位置、被赋予其不具备的能力、或语气风格全部雷同
  288. 3. **Agent 思路污染正文**:写作过程中的分析思路、角色定位说明、meta注记渗入小说正文
  289. 编辑团队通过职责严格分离,在生产流程中内建三道防火墙。
  290. ### 11.2 团队架构(真实报社模型)
  291. ```
  292. 用户
  293. │
  294. ▼
  295. 总编辑(Claude Code 主 Agent)
  296. │ 协调所有子 Agent,汇总报告,作最终裁判
  297. ├──► 策划主编(planning-editor)
  298. │ 读规划文件 → 生成 Chapter Brief → 传给写作特工
  299. │
  300. ├──► 写作特工(novelist)
  301. │ 只接收 Brief,只输出纯正文,严格隔离 meta 信息
  302. │
  303. ├──► 反AI编辑(anti-ai-editor) ┐ 并行
  304. └──► 连载核实官(consistency-reviewer)┘ 审核
  305. ```
  306. ### 11.3 触发命令
  307. ```
  308. /启动编辑团队 [--项目路径 <路径>] [--章节 <N>] [--模式 单章|批量]
  309. ```
  310. **单章模式**(默认):完整走一章的生产+审核流程。
  311. **批量模式**:连续生产并审核多章(每章之间等待门禁通过)。
  312. ### 11.4 执行步骤(Claude Code 按此流程操作)
  313. 当收到 `/启动编辑团队` 时,Claude Code 执行:
  314. ```
  315. 步骤 0:准备上下文快照
  316. python3 scripts/editorial_team_manager.py snapshot --project-root <路径>
  317. → 读取输出中的 context_file 路径和 current_chapter_no
  318. 步骤 1:创建团队
  319. TeamCreate(team_name="editorial-team-ch{N}", description="第N章编辑生产")
  320. 步骤 2:召唤策划主编
  321. Agent(subagent_type="planning-editor", team_name=..., name="planning-editor",
  322. prompt="请读取以下文件并生成第N章 Chapter Brief:
  323. novel_plan.md={路径}
  324. novel_state.md={路径}
  325. character_tracker.md={路径}")
  326. → 等待 CHAPTER_BRIEF_START...CHAPTER_BRIEF_END
  327. 步骤 3:召唤写作特工
  328. Agent(subagent_type="novelist", team_name=..., name="novelist",
  329. prompt="[将完整 CHAPTER_BRIEF 原文粘贴于此]")
  330. → 等待 NOVEL_TEXT_START...NOVEL_TEXT_END
  331. 步骤 4:并行召唤审核者(同时发起)
  332. Agent(subagent_type="anti-ai-editor", team_name=..., name="anti-ai-editor",
  333. prompt="请对以下章节正文执行去AI化审核:\n[NOVEL_TEXT]")
  334. Agent(subagent_type="consistency-reviewer", team_name=..., name="consistency-reviewer",
  335. prompt="请核查以下章节正文,项目路径:<路径>\n[NOVEL_TEXT]")
  336. → 等待两份报告
  337. 步骤 5:总编辑汇总判定
  338. - 如有 P0 → 返工(最多2次)
  339. - 无 P0 → 使用反AI编辑润色后的版本
  340. - 记录结果:
  341. python3 scripts/editorial_team_manager.py record-review \
  342. --project-root <路径> --chapter N --stage final --verdict pass/conditional/rewrite \
  343. --p0 X --p1 Y --p2 Z
  344. 步骤 6:输出最终章节包
  345. 将 FINAL_CHAPTER_PACKAGE 写入 03_manuscript/第N章-[标题].md
  346. 步骤 7:检查是否需要人工介入
  347. python3 scripts/editorial_team_manager.py need-human --project-root <路径>
  348. → 如 need_human=true,暂停并向用户汇报
  349. 步骤 8:关闭团队
  350. SendMessage(type="shutdown_request") × 各子 Agent
  351. TeamDelete()
  352. ```
  353. ### 11.5 正文隔离协议(防止 Agent 思路污染正文)
  354. 这是最关键的安全机制:
  355. | Agent | 允许的输出内容 | 严禁的输出内容 |
  356. |-------|--------------|--------------|
  357. | 写作特工 | `NOVEL_TEXT_START` 到 `NOVEL_TEXT_END` 之间的纯小说正文 | 分析说明、角色定位、写作思路、meta注记、括号说明 |
  358. | 反AI编辑 | 报告 + `HUMANIZED_TEXT` 标记内的净化正文 | 在润色后正文中插入任何注释 |
  359. | 连载核实官 | 结构化核查报告 | 直接修改正文 |
  360. | 总编辑 | 最终章节包(正文与报告分区) | 将审核意见混入正文区 |
  361. **P0 检测触发器**:正文中出现以下任意内容,立即触发 P0 强制重写:
  362. - `[` `]` 括号包裹的说明文字(如 `[此处填写]`、`[角色A]`)
  363. - `(注:)`、`【写作说明】`、`TODO`、`作者按`等元信息标记
  364. - 写作 Agent 的推理过程或分析性段落出现在正文区域内
  365. ### 11.6 角色一致性强制校验清单
  366. 连载核实官每章必须核查的项目(不得省略):
  367. - [ ] 所有出场角色的当前地理位置与 character_tracker 一致
  368. - [ ] 所有出场角色的能力边界未被违反
  369. - [ ] 已确认死亡/离开的角色未在正文中复活(非明确的回忆/幻觉场景)
  370. - [ ] 本章时间点与上一章时间点的推进逻辑合理
  371. - [ ] 正文中未出现规划文件和角色档案中从未注册的新地名/人名/组织
  372. ### 11.7 自由创作与规划遵守的平衡机制
  373. 编辑团队在以下两类规则之间保持严格分工:
  374. **策划主编负责遵守(硬约束)**:
  375. - 当前章节的情节任务必须推进
  376. - 本章禁区(不得提前触碰的剧情)必须遵守
  377. - 角色位置和状态的真实性
  378. **写作特工负责创新(软自由)**:
  379. - 章节入口角度(8种模式轮换,不重复)
  380. - 场景的具体呈现方式
  381. - 对话的具体内容和节奏
  382. - 细节描写的选择
  383. **没有任何 Agent 有权限做的事**:
  384. - 改变小说主线规划
  385. - 让角色提前到达不该到的地方
  386. - 发明规划文件外的重要设定
  387. ### 11.8 状态管理脚本
  388. ```bash
  389. # 生成上下文快照(团队启动前必须运行)
  390. python3 scripts/editorial_team_manager.py snapshot --project-root <路径>
  391. # 记录单次审核结果
  392. python3 scripts/editorial_team_manager.py record-review \
  393. --project-root <路径> --chapter N --stage final \
  394. --verdict pass --p0 0 --p1 2 --p2 3
  395. # 查看最近10章审核历史
  396. python3 scripts/editorial_team_manager.py status --project-root <路径>
  397. # 检测是否需要人工介入
  398. python3 scripts/editorial_team_manager.py need-human --project-root <路径>
  399. ```
README.md · README · 704 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Novel Claude AI - 小说创作大师
  2. > **版本**: v1.0.0
  3. > **状态**: 生产可用
  4. > **支持工具**: Claude Code / Codex / OpenCode / Gemini CLI / Antigravity
  5. 中文长篇小说全流程创作技能,覆盖从模糊想法到300万字成品的完整链路。
  6. ---
  7. ## 目录
  8. - [核心亮点](#核心亮点)
  9. - [框架设计特点](#框架设计特点)
  10. - [长期记忆解决方案](#长期记忆解决方案)
  11. - [去AI味道解决方案](#去ai味道解决方案)
  12. - [快速开始](#快速开始)
  13. - [安装指南](#安装指南)
  14. - [新手三命令](#新手三命令)
  15. - [完整命令参考](#完整命令参考)
  16. - [项目目录结构](#项目目录结构)
  17. - [多LLM配置](#多llm配置)
  18. - [常见问题](#常见问题)
  19. ---
  20. ## 核心亮点
  21. ### 300万字一致性保证
  22. 通过**五层协同机制**确保长篇写作不跑偏:
  23. | 层级 | 机制 | 作用 |
  24. |------|------|------|
  25. | 第1层 | 五步质量门禁 | 每章强制闭环:记忆同步→一致性检查→风格校准→校稿→门禁脚本 |
  26. | 第2层 | RAG剧情检索 | 两级检索(粗筛+精排),写前自动回读相关片段 |
  27. | 第3层 | 知识图谱 | 节点+边+版本管理,每章自动回写,改纲级联更新 |
  28. | 第4层 | 大纲锚点 | 全局进度条,章节推进配额约束,越界即失败 |
  29. | 第5层 | 跨Agent审核 | 独立审稿官交叉验证,批处理10章体检 |
  30. ### 去AI味润色
  31. 基于 [humanizer skill](https://github.com/blader/humanizer) 方法论定制:
  32. - **两遍式润色**:第一遍清除AI模式 → 第二遍AI自审残留问题
  33. - **7大类问题检测**:AI高频词、弱化副词、意义膨胀、通用套话、论文结构、正式语体、排比三连
  34. - **最小化改动原则**:只改有问题的地方,不破坏原有叙事
  35. ### 编辑团队协作
  36. 仿真实报社流程的多人设协作:
  37. ```
  38. 策划主编 → 写作特工 → 反AI编辑 + 连载核实官(并行)→ 总编辑判定
  39. ```
  40. 职责严格分离,从根本上消除AI幻觉、角色错乱、Agent思路污染正文三大顽疾。
  41. ---
  42. ## 框架设计特点
  43. ### 1. 铁律约束(Iron Law)
  44. 以下规则任何情况下不可违反:
  45. | 铁律 | 说明 |
  46. |------|------|
  47. | 禁止跳过强制章节闭环 | 每章必须完成五步门禁 |
  48. | 禁止绕过开书前确认 | 必须引导用户确认五要素 |
  49. | 禁止混淆正文与元信息 | 正文不得出现 `[说明]`、`TODO` 等标记 |
  50. | 禁止门禁失败后继续写作 | 唯一合法操作是执行 `/修复本章` |
  51. | 禁止任意修改主线规划 | 改纲须显式执行 `/改纲续写` |
  52. ### 2. 反向刹车机制
  53. 解决AI过度"帮助解决问题"的倾向:
  54. - **非终局章节禁止解决主线核心冲突**
  55. - **每章必须新增至少一个未解决的次要问题**
  56. - **章末必须留下悬念钩子**(疑问型/危机型/转折型)
  57. ### 3. 事件矩阵与冷却
  58. 防止剧情模式化(主角走到哪都踩人):
  59. | 事件类型 | 说明 | 冷却期 |
  60. |----------|------|--------|
  61. | `conflict_thrill` | 冲突爽点 | 2章 |
  62. | `bond_deepening` | 人物羁绊 | 1章 |
  63. | `faction_building` | 势力经营 | 2章 |
  64. | `world_painting` | 风土人情 | 3章 |
  65. | `tension_escalation` | 危机升级 | 2章 |
  66. 规则:刚用过的类型在冷却期内不得作为主Beat,每5章必须至少出现一次羁绊或风土人情。
  67. ### 4. 多步流水线写作
  68. 将"写一章"拆解为多步协作:
  69. ```
  70. Beat Sheet生成 → Beat扩写(填血肉)→ 章节合成 → 门禁流程
  71. ```
  72. 强制限制单次生成的剧情跨度,让每个场景充分展开。
  73. ### 5. 低上下文策略
  74. - 写前默认只读:`novel_plan.md` + `novel_state.md`
  75. - 单章前置读取上限:**最多4个文件**
  76. - RAG检索只返回Top-K片段,不回读整章
  77. - 每10章做一次深度压缩与风格校准
  78. ---
  79. ## 长期记忆解决方案
  80. ### 问题背景
  81. 长篇小说(100万字以上)面临的核心挑战:
  82. 1. **设定遗忘**:写到后面忘记前面的设定
  83. 2. **角色漂移**:角色性格、位置、能力前后矛盾
  84. 3. **剧情断裂**:伏笔忘记回收,支线悬而未决
  85. 4. **时间线错乱**:故事时间推进不合理
  86. ### 解决架构
  87. #### 第一层:五步质量门禁(每章强制)
  88. ```
  89. /更新记忆 → /检查一致性 → /风格校准 → /校稿 → /门禁检查
  90. ```
  91. 每一步都产出对应的门禁产物文件,`gate_result.json` 显示 `passed: true` 才能解锁下一章。
  92. #### 第二层:RAG剧情检索
  93. **两级检索算法**:
  94. 1. **粗筛(BM25风格TF-IDF)**:从所有章节中筛选候选池(默认8个)
  95. 2. **精排(语义重排)**:对候选池进行语义分析,返回Top-K(默认4个)
  96. **条件触发**:
  97. - 轻场景(日常/过渡)自动跳过检索
  98. - 复杂剧情才执行检索
  99. **文件位置**:
  100. ```
  101. 00_memory/retrieval/
  102. ├── story_index.json # 章节检索索引
  103. ├── entity_chapter_map.json # 实体-章节映射
  104. ├── next_plot_context.md # 当前写前上下文建议
  105. └── chapter_meta/*.meta.json # 章节元数据侧车文件
  106. ```
  107. #### 第三层:知识图谱
  108. 用图结构管理角色、事件、伏笔、世界观:
  109. ```json
  110. {
  111. "nodes": [
  112. {"id": "char_001", "type": "character", "name": "李承乾", "status": "alive", ...}
  113. ],
  114. "edges": [
  115. {"type": "ally", "source": "char_001", "target": "char_003", "strength": 0.8}
  116. ],
  117. "timeline": [...]
  118. }
  119. ```
  120. **节点类型**:角色、地点、势力、物品、事件、伏笔、世界观规则、力量体系
  121. **边类型**:同盟、敌对、师徒、从属、情感、归属、位于、引发、铺垫、持有
  122. **自动更新**:每章写后自动提取信息回写图谱
  123. **改纲级联**:修改大纲时自动计算影响范围并更新关联节点
  124. #### 第四层:大纲锚点
  125. **进度配额约束**:
  126. ```json
  127. {
  128. "total_chapters": 300,
  129. "current_chapter": 42,
  130. "current_arc": "第二卷:朝堂博弈",
  131. "chapters_in_arc": 40,
  132. "quota": {
  133. "min_progress": 0.14,
  134. "max_progress": 0.15
  135. }
  136. }
  137. ```
  138. 每章写前读取全局进度条,动态注入约束。越界直接触发门禁失败。
  139. #### 第五层:跨Agent审核
  140. **双智能体交叉验证**:
  141. | 写作工具 | 审核工具 |
  142. |---------|---------|
  143. | Claude Code | Codex |
  144. | OpenCode | Claude Code |
  145. | Codex | Claude Code |
  146. **三维度审核**:
  147. 1. 逻辑与连续性硬伤
  148. 2. 阅读体验与节奏把控
  149. 3. 文笔去AI化
  150. **防死循环机制**:
  151. - 单章最多3轮审核
  152. - 连续3章"有条件通过"强制暂停请求人工介入
  153. ---
  154. ## 去AI味道解决方案
  155. ### 核心原理
  156. AI文本之所以"有AI味",是因为大语言模型的统计算法倾向于选择"在最多情况下都说得过去"的表达——导致文字安全、中性、可预测,缺乏人类写作的具体性和个人性。
  157. **去AI味不是删词,而是用具体细节替代抽象套话,用行动替代状态描述。**
  158. ### 两遍式润色流程
  159. 执行 `/校稿` 时必须完成两遍:
  160. #### 第一遍:清除AI模式
  161. 逐段扫描,针对7类模式逐一处理。
  162. #### 第二遍:AI自审
  163. 完成第一遍后,对修改稿提问:
  164. > "这段文字哪些地方还是明显AI生成的感觉?"
  165. 列出3-5条具体问题,再次修改后输出最终版。
  166. ### 7大AI写作模式
  167. #### 1. AI高频词汇(直接替换)
  168. | 词/短语 | 问题 | 改法 |
  169. |---------|------|------|
  170. | 不禁 | 剥夺角色主动性 | 直接写角色的行动 |
  171. | 仿佛/宛如/宛若 | 过度比喻 | 用具体感知描写替代 |
  172. | 映入眼帘 | 陈词滥调 | 直接写看到了什么 |
  173. | 心中暗道/暗自思忖 | 内心独白套话 | 删除或改为行动 |
  174. | 沉声道/淡淡地说 | 对话标签膨胀 | 统一用"说"或删标签 |
  175. | 脸色一变/身形一顿 | 反应套话 | 写具体的生理反应 |
  176. | 嘴角微扬/勾起一抹弧度 | 微笑套话(AI特征极强) | "他笑了"或删掉 |
  177. | 不由自主/情不自禁 | 主体性剥夺 | 改为角色主动行动 |
  178. | 只见/此时此刻 | 场景过渡套话 | 直接切换场景 |
  179. | 目光如炬/目光深邃 | 眼睛描写套话 | 写眼睛看向哪里 |
  180. **示例**:
  181. ```
  182. ❌ 他不禁感到一阵心悸
  183. ✅ 他的手抖了一下
  184. ❌ 只见她嘴角微扬,勾起一抹弧度
  185. ✅ 她笑了
  186. ❌ 此时此刻,他心中暗道
  187. ✅ (删除,直接写下一个行动)
  188. ```
  189. #### 2. 弱化副词泛滥
  190. "微微"、"淡淡"、"缓缓"、"轻轻"、"悄然"、"默默"、"隐隐"……
  191. **原则**:删除大部分,每千字不超过3个。
  192. ```
  193. ❌ 他微微点了点头
  194. ✅ 他点了点头
  195. ❌ 她轻轻叹了口气
  196. ✅ 她叹气
  197. ```
  198. #### 3. 意义膨胀
  199. AI喜欢给普通事件加上"意义深远"、"前所未有"、"可谓"等宏大标签。
  200. **原则**:删除标签,用具体的后续影响替代。
  201. ```
  202. ❌ 这次会面意义深远
  203. ✅ 从那以后,他改变了用兵的方式
  204. ```
  205. #### 4. 通用结论套话
  206. "未来可期"、"前途无量"、"充满希望"等空洞结语。
  207. **原则**:用具体的悬念、未解决的冲突、角色的下一步行动结尾。
  208. ```
  209. ❌ 展望未来,他充满希望
  210. ✅ 他把那封信折好,放进了锁匣。还有一件事没做完。
  211. ```
  212. #### 5. 论文式段落结构
  213. 段落以"不难看出"、"由此可见"、"事实上"、"值得注意的是"开头。
  214. ```
  215. ❌ 不难看出,他已下定决心。接下来,他走向了马厩……
  216. ✅ 他走向了马厩,没有回头。
  217. ```
  218. #### 6. 正式语体入侵小说
  219. "于是乎"、"与此同时"、"从而"、"因而"、"诚然"、"一方面……另一方面……"
  220. **原则**:全部删除或改为口语化/行动化表达。
  221. #### 7. 排比三连过多
  222. AI喜欢把事物凑成三个一组制造"全面感"。
  223. ```
  224. ❌ 他展现出了勇气、智慧和决断力
  225. ✅ 他很果断
  226. ❌ 这场战斗充满了激烈、残酷和牺牲
  227. ✅ 这场战斗死了很多人
  228. ```
  229. ### 有灵魂的写作
  230. 避免了AI模式但仍然无聊,同样是失败。好的写作特征:
  231. - **有观点**:叙述者对事件有态度,不只是中性记录
  232. - **节奏变化**:短句与长句交替使用
  233. - **具体感受**:不是"他感到担忧",而是"他的后背出了一层冷汗"
  234. - **细节代替判断**:不是"她很聪明",而是写她做了什么具体的聪明事
  235. ### 脚本用法
  236. ```bash
  237. # 检测章节的AI痕迹
  238. python3 scripts/text_humanizer.py detect --chapter-file 03_manuscript/第15章.md
  239. # 获取可读报告
  240. python3 scripts/text_humanizer.py report --chapter-file 03_manuscript/第15章.md
  241. # 生成两遍式润色prompt
  242. python3 scripts/text_humanizer.py prompt --chapter-file 03_manuscript/第15章.md
  243. ```
  244. ---
  245. ## 快速开始
  246. ### 3分钟上手
  247. ```bash
  248. # 步骤1:安装技能
  249. bash scripts/install-portable-skill.sh --tool claude-code --force
  250. # 步骤2:一键开书
  251. /一键开书 书名="穿越大唐之我是皇帝" 题材=历史 剧情种子="现代大学生穿越到唐朝成为太子,利用现代知识治国平天下"
  252. # 步骤3:继续写
  253. /继续写 "太子在朝堂上首次发言,引起百官震动"
  254. ```
  255. 系统会自动完成:世界观建模 → 知识库初始化 → 章节写作 → 门禁校验 → 索引更新。
  256. ---
  257. ## 安装指南
  258. ### 支持的AI工具
  259. | 工具 | 安装命令 |
  260. |------|----------|
  261. | Claude Code | `bash scripts/install-portable-skill.sh --tool claude-code --force` |
  262. | OpenCode | `bash scripts/install-portable-skill.sh --tool opencode --force` |
  263. | Codex | `bash scripts/install-portable-skill.sh --tool codex --force` |
  264. | Gemini CLI | `bash scripts/install-portable-skill.sh --tool gemini-cli --force` |
  265. | Antigravity | `bash scripts/install-portable-skill.sh --tool antigravity --force` |
  266. ### 安装验证
  267. 安装后在对话中输入 `/一键开书`,如果系统识别命令并提示参数,说明安装成功。
  268. ### 手动安装
  269. 1. 复制以下目录到目标工具的skill目录:
  270. - `SKILL.md`
  271. - `novel-creator.md`
  272. - `novel-creator.json`
  273. - `templates/`
  274. - `references/`
  275. - `scripts/`
  276. 2. Claude Code 额外需要复制 `.claude/agents/` 中的Agent定义文件。
  277. 3. 安装目录命名建议:`novel-claude-ai`
  278. ---
  279. ## 新手三命令
  280. ### `/一键开书`
  281. 初始化一个完整的小说项目。
  282. ```
  283. /一键开书 书名="书名" 题材=历史 剧情种子="一句话概述核心剧情"
  284. ```
  285. **执行内容**:
  286. 1. 引导确认五要素(目标读者、写作风格、核心禁区、自动化等级、目标规模)
  287. 2. 创建项目目录结构
  288. 3. 生成主线计划(novel_plan.md)
  289. 4. 建立知识库骨架
  290. 5. 构建初始检索索引
  291. ### `/继续写`
  292. 执行完整的写作-校验流程。
  293. ```
  294. /继续写 "本章要写的剧情方向"
  295. ```
  296. **执行内容**(全自动串联):
  297. 1. 续写前引导(询问剧情走向偏好)
  298. 2. RAG检索相关章节上下文
  299. 3. 大纲锚点配额检查
  300. 4. Beat Sheet生成与扩写
  301. 5. 章节合成与门禁校验
  302. 6. 知识图谱回写与索引更新
  303. ### `/修复本章`
  304. 门禁失败后的修复命令。
  305. ```
  306. /修复本章
  307. ```
  308. 系统根据 `repair_plan.md` 中的修复建议,自动修复章节问题并重新提交门禁。
  309. ---
  310. ## 完整命令参考
  311. ### 新手命令
  312. | 命令 | 功能 | 何时使用 |
  313. |------|------|---------|
  314. | `/一键开书` | 自动完成开书全流程 | 第一次开项目 |
  315. | `/继续写` | 引导剧情走向并完成章节流程 | 日常推进章节 |
  316. | `/修复本章` | 门禁失败后自动修复 | 门禁返回失败后 |
  317. | `/新手模式` | 切换简化/高级交互层 | 按需 |
  318. ### 创作命令
  319. | 命令 | 功能 |
  320. |------|------|
  321. | `/写全篇` | 模糊想法→百万字路线图 |
  322. | `/写作` | 生成单章草稿并触发闭环 |
  323. | `/续写` | 恢复会话状态并继续 |
  324. | `/批量写作` | 连续生成多章 |
  325. | `/修改章节` | 修订已写章节并级联更新 |
  326. | `/一键写书` | 全自动写作调度 |
  327. | `/改纲续写` | 中途改纲+级联更新 |
  328. ### 质量命令(每章必经)
  329. | 命令 | 功能 |
  330. |------|------|
  331. | `/更新记忆` | 同步状态追踪器 |
  332. | `/检查一致性` | 检查剧情/设定/时间线冲突 |
  333. | `/风格校准` | 检测文风偏移 |
  334. | `/校稿` | 去AI味润色 |
  335. | `/门禁检查` | 脚本化校验发布标准 |
  336. ### 检索与记忆命令
  337. | 命令 | 功能 |
  338. |------|------|
  339. | `/更新剧情索引` | 扫描章节建立索引 |
  340. | `/剧情检索` | RAG检索相关片段 |
  341. | `/检索记忆` | 按关键词搜索记忆 |
  342. | `/伏笔状态` | 查看伏笔埋设/回收/超期 |
  343. | `/角色状态` | 汇总角色当前状态 |
  344. | `/时间线` | 查看事件时间顺序 |
  345. | `/联网调研` | 联网搜索补充知识库 |
  346. ### 风格命令
  347. | 命令 | 功能 |
  348. |------|------|
  349. | `/题材选风格` | 按题材矩阵选择基线风格 |
  350. | `/风格提取` | 从样章提取风格到库 |
  351. | `/风格迁移` | 将风格档案应用到章节 |
  352. | `/风格库检索` | 检索可复用风格 |
  353. ### 分析命令
  354. | 命令 | 功能 |
  355. |------|------|
  356. | `/拆书` | 拆解作品结构,提炼爽点钩子 |
  357. | `/仿写` | 提取写法模板与风格特征 |
  358. | `/双审` | 跨Agent双智能体审核 |
  359. ---
  360. ## 项目目录结构
  361. ```
  362. <project-root>/
  363. ├── 00_memory/ # 记忆系统
  364. │ ├── novel_plan.md # 主线计划(写前必读)
  365. │ ├── novel_state.md # 当前状态(写前必读)
  366. │ ├── idea_seed.md # 开书确认卡
  367. │ ├── story_graph.json # 知识图谱
  368. │ ├── outline_anchors.json # 大纲锚点
  369. │ ├── event_matrix_state.json # 事件冷却状态
  370. │ └── retrieval/ # 检索索引
  371. │ ├── story_index.json # 章节检索索引
  372. │ ├── entity_chapter_map.json
  373. │ └── next_plot_context.md
  374. ├── 02_knowledge_base/ # 知识库(设定+资料)
  375. │ ├── 10_worldbuilding.md # 世界观设定
  376. │ ├── 11_research_data.md # 调研资料
  377. │ ├── 12_style_skills.md # 写作手法
  378. │ ├── 13_reference_materials.md # 参考资料
  379. │ ├── character_tracker.md # 角色追踪器
  380. │ ├── timeline.md # 时间线
  381. │ └── foreshadowing_tracker.md # 伏笔追踪器
  382. ├── 03_manuscript/ # 章节正文
  383. │ └── 第NNN章_标题.md
  384. ├── 04_editing/ # 编辑与门禁
  385. │ └── gate_artifacts/<chapter_id>/
  386. │ ├── memory_update.md
  387. │ ├── consistency_report.md
  388. │ ├── style_calibration.md
  389. │ ├── copyedit_report.md
  390. │ ├── publish_ready.md
  391. │ ├── gate_result.json
  392. │ └── repair_plan.md
  393. └── .flow/ # 执行状态(内部)
  394. ├── auto_write_state.json # 一键写书状态
  395. ├── continue_write_cache.json # 幂等缓存
  396. └── snapshots/ # 快照备份
  397. ```
  398. ---
  399. ## 多LLM配置
  400. 在项目根目录创建 `.novel_writer_config.yaml`:
  401. ### OpenAI(默认)
  402. ```yaml
  403. ai_provider: openai
  404. model: gpt-4
  405. openai_api_key: "sk-..."
  406. ```
  407. ### Anthropic (Claude)
  408. ```yaml
  409. ai_provider: anthropic
  410. model: claude-3-sonnet-20240229
  411. ```
  412. ### Kimi 2.5
  413. ```yaml
  414. ai_provider: kimi
  415. model: moonshot-v1-auto
  416. ```
  417. ### GLM-5
  418. ```yaml
  419. ai_provider: glm
  420. model: glm-4-plus
  421. ```
  422. ### 本地模型
  423. ```yaml
  424. ai_provider: local
  425. model: qwen2.5:72b
  426. local_api_url: "http://localhost:11434/api/generate"
  427. ```
  428. ### 环境变量
  429. | LLM | 环境变量 |
  430. |-----|----------|
  431. | OpenAI | `OPENAI_API_KEY` |
  432. | Anthropic | `ANTHROPIC_API_KEY` |
  433. | Kimi | `MOONSHOT_API_KEY` |
  434. | GLM | `GLM_API_KEY` |
  435. | MiniMax | `MINIMAX_API_KEY` |
  436. ---
  437. ## 常见问题
  438. ### Q: 安装后命令不生效?
  439. A: 确认安装脚本输出无错误。重启AI工具后重试。检查SKILL.md是否被正确链接。
  440. ### Q: 门禁一直不通过?
  441. A: 使用 `/修复本章` 自动修复。查看 `04_editing/gate_artifacts/<章节>/gate_result.json` 了解具体失败原因。
  442. ### Q: 如何切换大模型?
  443. A: 修改项目根目录的 `.novel_writer_config.yaml`,更改 `ai_provider` 和 `model` 字段。
  444. ### Q: 一键写书中断了怎么办?
  445. A: 直接再次执行 `/一键写书`,系统会自动检测断点并恢复。状态保存在 `.flow/auto_write_state.json`。
  446. ### Q: 目标字数设多少合适?
  447. A:
  448. - 短篇试水:5-10万字
  449. - 中篇:30-50万字
  450. - 长篇:100-200万字
  451. - 超长篇:200万字以上
  452. 系统自动计算卷/章结构,每章约3500字。
  453. ### Q: 支持哪些题材?
  454. A: 内置调研维度的题材:历史、玄幻、科幻、都市、仙侠、游戏、悬疑、言情、军事。其他题材使用通用调研维度。
  455. ---
  456. ## 参考文档索引
  457. | 文档 | 内容 |
  458. |------|------|
  459. | `references/user-guide.md` | 从零开书用户指南 |
  460. | `references/command-playbook.md` | 完整命令手册 |
  461. | `references/gate-artifacts-spec.md` | 门禁产物规范 |
  462. | `references/million-word-roadmap.md` | 百万字路线图 |
  463. | `references/genre-style-matrix.md` | 题材风格矩阵 |
  464. | `references/rag-consistency-design.md` | RAG一致性设计 |
  465. | `references/story-graph-schema.md` | 知识图谱数据结构 |
  466. | `references/outline-anchor-quota-spec.md` | 大纲锚点规范 |
  467. | `references/beat-pipeline-spec.md` | 多步流水线写作 |
  468. | `references/anti-resolution-cooldown-spec.md` | 反向刹车与事件冷却 |
  469. | `references/cross-agent-review-protocol.md` | 跨Agent审核协议 |
  470. | `references/editorial-team-protocol.md` | 编辑团队架构与协议 |
  471. | `references/humanizer-guide.md` | 去AI味润色指南 |
  472. | `references/research-guide.md` | 联网调研指南 |
  473. | `references/auto-write-guide.md` | 一键写书指南 |
  474. ---
  475. ## 开发与测试
  476. ### 运行回归测试
  477. ```bash
  478. PYTHONDONTWRITEBYTECODE=1 python3 scripts/test_novel_flow_executor.py
  479. ```
  480. ### 脚本入口速查
  481. ```bash
  482. # 一键开书
  483. python3 scripts/novel_flow_executor.py one-click \
  484. --project-root ./我的小说 --title "书名" --genre 历史 --idea "剧情种子"
  485. # 继续写作
  486. python3 scripts/novel_flow_executor.py continue-write \
  487. --project-root ./我的小说 --query "新剧情"
  488. # 门禁检查
  489. python3 scripts/chapter_gate_check.py \
  490. --project-root ./我的小说 --chapter-file ./我的小说/03_manuscript/第15章.md
  491. # RAG检索
  492. python3 scripts/plot_rag_retriever.py build --project-root ./我的小说
  493. python3 scripts/plot_rag_retriever.py query --project-root ./我的小说 --query "剧情关键词"
  494. # 联网调研
  495. python3 scripts/research_agent.py plan --genre 历史 --topic "唐朝安史之乱"
  496. # 一键写书
  497. python3 scripts/auto_novel_writer.py plan --synopsis "简介" --target-chars 2000000
  498. python3 scripts/auto_novel_writer.py run --project-root ./我的小说
  499. # 基线评测
  500. python3 scripts/benchmark_novel_flow.py --project-root ./我的小说 --rounds 5
  501. ```
  502. ---
  503. ## License
  504. MIT License

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.