novel-writer

name novel-writer description 小说创作引擎（v3.0）。强制验证+检查点+进化机制。支持长篇小说从创意到完稿的全流程。触发：用户说"写小说"、"创作故事"、"连载"等。 metadata {"clawdbot":{"emoji":"📚"}} novel-writer v3.0 核心理念 ：文字规范抵不过代码约束。用脚本强制验证，用检查点保证可恢复，用进化机制持续改进。 项目输出路径 路径规则 ： ~/Documents/{书名}/ 目录名使用 纯中文字符 ，与书名完全一致 示例：《他养大了皇帝》→ ~/Documents/他养大了皇帝/ 示例：《隐相》→ ~/Documents/隐相/ 目录结构 ： ~/Documents/{书名}/ ├── config/ │ ├── project_info.md # 项目元信息 │ ├── worldbuilding.md # 世界观设定 │ ├── characters.md # 人物小传 │ └── volume_outline.md # 卷纲 ├── memory/ │ ├── character_cards.md # 角色卡（YAML格式） │ ├── relationship_map.md # 人物关系图谱 │ ├── foreshadowing.md # 伏笔追踪 │ ├── lessons_learned.md # 创作经验积累 │ └── checkpoints/ # 检查点快照 ├── chapters/ │ ├── vol1_chapter_01.md │ ├── vol1_chapter_02.md │ └── ... ├── deliverables/ │ ├── final.md # 合并稿 │ └── final.docx # 导出文档 └── status.md # 当前状态（唯一真相源） 核心架构 用户 ←→ novel-writer（调度器） │ ├── scripts/validate_step.py（强制验证） ├── scripts/checkpoint.py（快照/回滚） └── 子Skill（执行具体任务） 铁律 ： 每一步完成必须运行验证脚本 验证失败 = 阻断，不可跳过 关键节点自动创建检查点 状态机（带强制验证） Step 0: init 动作：初始化项目 验证：scripts/validate_step.py --step 0 产出：status.md（初始状态） Step 1: brainstorm（创意构思）⚠️ 必须与用户讨论 动作：与用户讨论并确认以下六个要素 1. 书名（提供3-5个选项让用户选择，或接受用户自己的命名） 2. 篇幅（短篇/中篇/长篇，说明字数范围） 3. 叙事视角（第三人称/第一人称/双视角，说明优劣） 4. 故事范围（聚焦某段/完整人生） 5. 情感基调（如：悬疑、感人、热血、轻松等） 6. 文风（见下方【文风选择指南】） 【文风选择指南】 文风是写作的核心规范，必须在创意阶段确定。常见选项： A. 动词驱动型（推荐网文） - 特点：短句、快节奏、信息密集、动作先行 - 禁用：形容词堆砌、长句从句、心理形容词 - 示例：《大奉打更人》《诡秘之主》 - 适用：悬疑、权谋、生存类 B. 克制典雅型 - 特点：情感内敛、留白艺术、古典韵味 - 禁用：直白抒情、现代口语、过度解释 - 示例：《琅琊榜》《庆余年》 - 适用：历史正剧、权谋、情感类 C. 幽默吐槽型 - 特点：主角内心戏丰富、现代梗、轻松化解紧张 - 禁用：过度煽情、沉重压抑 - 示例：《我师兄实在太稳健了》《大奉打更人》 - 适用：爽文、穿越、系统流 D. 热血燃向型 - 特点：金句频出、情绪高涨、对抗性强 - 禁用：拖沓、犹豫、过度算计 - 示例：《斗破苍穹》《雪中悍刀行》 - 适用：玄幻、武侠、升级流 E. 悬疑压抑型 - 特点：氛围营造、信息差、层层揭秘 - 禁用：过早解密、平铺直叙 - 示例：《诡秘之主》《盗墓笔记》 - 适用：悬疑、惊悚、探案类 【文风规范模板】（确定后写入 project_info.md） - 文风类型：xxx型 - 核心原则：（一句话概括） - 句式规范：（段落长度、句子长度） - 禁用词汇：（列出具体禁用词） - 心理描写：（如何表达） - 对话规范：（格式要求） - 章节钩子：（结尾要求） 状态锁（写入 status.md）： "当前任务：等待用户确认{要素名称}" 每确认一个要素，更新： "- [x] 书名已确认：xxx" "- [x] 篇幅已确认：xxx" "- [x] 文风已确认：xxx" ... 验证： scripts/validate_step.py --step 1 --book-name "{书名}" 检查项： □ status.md 中包含"书名已确认" □ status.md 中包含"篇幅已确认" □ status.md 中包含"视角已确认" □ status.md 中包含"范围已确认" □ status.md 中包含"基调已确认" □ status.md 中包含"文风已确认" □ project_info.md 中包含完整的【文风规范模板】 阻断规则：六个要素全部确认后，才能进入 Step 2 Step 2: project_init ⚠️ 第一个强制阻断点 动作：创建项目目录 命令： mkdir -p ~/Documents/{书名}/{config,memory,chapters,deliverables} echo "# {书名}" > ~/Documents/{书名}/config/project_info.md 验证（必须全部通过）： scripts/validate_step.py --step 2 --book-name "{书名}" 检查项： □ 目录存在：~/Documents/{书名}/ □ 子目录齐全：config/, memory/, chapters/, deliverables/ □ project_info.md 存在且非空 失败处理：报错并停止，不进入 Step 3 检查点：验证通过后自动创建 step_2_complete.checkpoint Step 3: world_building ⚠️ 第二个强制阻断点 动作：构建世界观、人物设定 产出（缺一不可）： 1. config/worldbuilding.md - 时代背景、核心场景、制度礼仪 2. config/characters.md - 主角、配角人物小传 3. memory/character_cards.md - 结构化角色卡（YAML） 4. memory/relationship_map.md - 人物关系图谱 验证： scripts/validate_step.py --step 3 --book-name "{书名}" 检查项： □ 四个文件全部存在 □ 每个文件字数 > 500 □ character_cards.md 包含至少3个角色的YAML结构 失败处理：列出缺失文件，禁止进入 Step 4 检查点：验证通过后创建 step_3_complete.checkpoint Step 4: volume_outline（卷纲设计） 动作：设计三卷主题、核心冲突、情感弧线 产出：config/volume_outline.md 确认：用户审阅并明确确认 验证： scripts/validate_step.py --step 4 --book-name "{书名}" 检查项： □ volume_outline.md 存在 □ 包含至少3卷的规划 □ 用户已确认（status.md 中有确认记录） 检查点：确认后创建 step_4_complete.checkpoint Step 5: volume_chapter_outline（整卷章节大纲）⚠️ 每卷开始前必须执行 触发条件： - 新项目开始第一卷 - 上一卷完成，进入下一卷 动作：为当前卷生成所有章节的情节概述 产出：config/volume_{X}_chapter_outline.md 【章节情节推进四大原则】⚠️ 绝对不可违反 **原则一：因果链原则** - 每一章的危机必须从上一章的隐患发展而来 - 禁止独立事件——每一章都必须承接上一章，不能凭空出现新危机 - 格式要求：每章细纲必须写明"危机来源"（来自上一章的哪个隐患） **原则二：抉择+代价原则** - 主角每章必须做出明确的抉择（不是被动承受，而是主动选择） - 每个抉择都有代价，这个代价成为下一章的危机 - 格式要求：每章细纲必须写明"主角抉择"和"埋下隐患" **原则三：升级递进原则** - 危机必须层层升级，像一根绳子越绷越紧 - 从"可能暴露"→"即将暴露"→"已经暴露"逐步推进 - 禁止同一级别的危机重复出现 **原则四：节奏权重原则** ⚠️ 用章节数量体现节奏 - **过渡阶段**：快速推进，每年/每件事只用1章，甚至合并多件事到1章 - **铺垫阶段**：积累张力，每章比前一章更接近危机核心 - **高潮阶段**：详细展开，一个大事件拆成3-6章，占全卷40%以上篇幅 - **结尾阶段**：情感释放，快速收尾，每章解决一个问题 【权重标记规范】 | 权重 | 含义 | 章节数建议 | 用途 | |-----|------|-----------|------| | ⭐ | 过渡 | 1章/年或更少 | 时间推进、日常交代 | | ⭐⭐ | 铺垫 | 1-2章 | 张力积累、危机初现 | | ⭐⭐⭐ | 转折 | 2-3章 | 重大变化、局势恶化 | | ⭐⭐⭐⭐ | 高潮前奏 | 3-4章 | 决战准备、正面对峙 | | ⭐⭐⭐⭐⭐ | 大高潮 | 4-6章 | 全书最精彩段落，详细展开 | 【细纲格式要求】 每章必须包含以下要素： 第X章：章节标题 时间：具体时间点 权重：⭐-⭐⭐⭐⭐⭐ 危机来源：来自上一章的哪个隐患 核心冲突：本章要解决什么问题 主角抉择：主角做了什么选择 埋下隐患：这个抉择埋下了什么新危机 接下一章：如何引出下一章 【强制约束】⚠️ 绝对不可违反 1. **只写当前卷内容**：严格限定在 volume_outline.md 中定义的当前卷时间范围和情节内 2. **不写上一卷内容**：前一卷的情节只在"前情衔接"中简要提及，不重复展开 3. **不写下一卷内容**：下一卷的情节完全不留入当前卷细纲 4. **做好卷间衔接**： - 当前卷首章：简要说明承接自上一卷的什么状态 - 当前卷末章：明确结尾状态，为下一卷做好铺垫 5. **时间线清晰**：每章的时间点必须落在当前卷定义的时间范围内 违规示例（禁止）： ❌ 第一卷细纲中出现第二卷"掖庭岁月"的章节 ❌ 第一卷末章直接写到登基（这是第三卷内容） ❌ 当前卷细纲中出现"详见下一卷"的依赖 正确示例： ✅ 第一卷末章：刘病已获赦出狱，结束在掖庭门口（为第二卷铺垫） ✅ 第二卷首章：从掖庭生活开始，简要提及"前年获赦" 流程： 1. 读取 config/volume_outline.md，了解本卷主题和情节范围 2. 【检查时间边界】确认本卷的起止时间，绝不越界 3. 根据本卷章节数量，为每章分配情节 4. 【自查】检查是否有超出本卷范围的内容 5. 写入 config/volume_{X}_chapter_outline.md 6. ⚠️【自动审查循环】调用 scripts/validate_volume_outline.py 进行审查 - 使用优秀网文 10 大标准审查大纲 - 审查不通过时，自动调用大模型修改 - 循环执行"审查→修改→再审查"，最多 5 次 - 审查通过后，才能进入下一步 7. 用户确认后才能进入 Step 6 验证： scripts/validate_step.py --step 5 --book-name "{书名}" --volume {X} 检查项： □ volume_{X}_chapter_outline.md 存在 □ scripts/validate_volume_outline.py 执行成功 □ 审查结果为"通过"（或有审查报告） □ 用户已确认 □ 包含本卷所有章节的情节概述 □ 【新增】无上一卷内容的重复展开 □ 【新增】无下一卷内容的提前泄露 □ 【新增】时间线完全在本卷范围内 □ 用户已确认 检查点：确认后创建 volume_{X}_outline_complete.checkpoint Step 6: chapter_loop（逐章循环） 进入时检查： - 是否是本卷第一章？ - 是否已存在本卷的 volume_{X}_chapter_outline.md？ - 如果不存在，先执行 Step 5 进入时更新 status.md： "当前任务：第{X}卷第{Y}章 - 等待章纲讨论" ├─ 6.1: chapter_outline（单章章纲） │ 【前置检查】 │ 1. 读取 config/volume_{X}_chapter_outline.md，确认本章情节 │ 2. 如果不是第一章，读取前一章 chapters/vol{X}_chapter_{Y-1}.md │ 3. 【连续性检查】确认与前章的时间线、人物状态、情节衔接 │ - 时间：本章是前章的什么时候？（当日/次日/数日后） │ - 人物：前章结束时的位置、状态是否与本章开头一致？ │ - 情节：前章的结尾是否有伏笔需要在本章回收？ │ 【节奏约束】严格按照章节大纲写作，禁止压缩或扩展 │ │ 产出：memory/chapter_{X}_{Y}_outline.md │ 验证：文件存在 + 字数 > 300 │ │ 【强制确认】⚠️ 必须执行 │ - 创建章纲后，必须停下来向用户展示章纲内容 │ - 明确询问："请确认章纲，确认后开始写作" │ - 用户确认后，更新 status.md = "第{X}卷第{Y}章 - 章纲已确认，等待写作" │ - ❌ 禁止：未确认就直接进入 Step 6.2 写作 │ ├─ 6.2: chapter_write（章节写作） │ 前置：检查 status.md 状态必须是"章纲已确认" │ │ 【验证脚本】⚠️ 写作前必须通过 │ python3 scripts/validate_outline_confirmation.py <书名> <章节号> │ - 验证失败 = 阻断流程，必须先确认章纲 │ │ 【上下文准备】⚠️ 写作前必须读取以下内容 │ │ 1. 章节大纲定位：config/volume_{X}_chapter_outline.md │ - 读取前三章（第Y-3、Y-2、Y-1章）的情节概述（如果存在） │ - 读取本章（第Y章）的情节概述 │ - 读取后三章（第Y+1、Y+2、Y+3章）的情节概述（如果存在） │ - ⚠️ 明确边界：本章写什么，前几章已写什么，后几章要写什么 │ - ⚠️ 避免重复：不要写前几章已写的内容 │ - ⚠️ 避免超前：不要提前写后几章的内容 │ │ 2. 前一章完整内容（如果不是第一章）：chapters/vol{X}_chapter_{Y-1}.md │ - 已包含结尾，无需额外读取 │ - 确保时间线衔接、人物状态一致 │ │ 3. 角色卡：memory/character_cards.md（本章出场角色） │ │ 4. 伏笔追踪：memory/foreshadowing.md（如有） │ │ 5. 【文风规范】⚠️ 必须读取并严格遵守 │ 读取：config/project_info.md 中的【文风规范模板】 │ - 文风类型：确认本章使用的文风 │ - 句式规范：段落长度、句子长度 │ - 禁用词汇：绝对禁止使用 │ - 心理描写：按文风要求表达 │ - 对话规范：格式必须符合 │ - 章节钩子：结尾必须留下钩子 │ │ 【文风检查清单】（写作时自检） │ □ 每段不超过3句话 │ □ 每句话不超过15个字 │ □ 没有使用禁用词汇 │ □ 心理描写用动作/场景表达，不用形容词 │ □ 对话一句一换行，最多两句 │ □ 章节结尾有强钩子 │ □ 每100字有新信息或新动作 │ │ 【范围约束】⚠️ 必须遵守 │ - 只写本章大纲规定的内容 │ - 不要写前章已写的内容 │ - 不要提前写后章的内容 │ - 结尾要留有悬念，为下一章铺垫 │ │ 产出：chapters/vol{X}_chapter_{Y}.md │ 字数：3000-4000字（强制） │ │ 【写作原则】⚠️ 必须遵守 │ │ 【去AI味强制要求】⚠️ 绝对禁止以下AI特征句式 │ │ 一、禁止"不是……而是……"句式 │ - ❌ 绝对禁止："不是……而是……"、"并非……而是……"、"与其说是……不如说是……" │ - ❌ 错误示例："他不是害怕，而是愤怒"、"这不是结束，而是开始" │ - ✅ 正确写法：直接用动作和神态表现，"他握紧拳头，额头青筋暴起" │ - ✅ 正确写法：用具体场景呈现，"门关上，新的风暴才刚刚开始" │ │ 二、禁止其他AI特征表达 │ - ❌ 禁止："从某种意义上说"、"从某种角度来看"、"换句话说" │ - ❌ 禁止："值得注意的是"、"关键在于"、"核心在于" │ - ❌ 禁止："一方面……另一方面……"、"既……又……"（过度使用） │ - ❌ 禁止："正如……所说"、"就像……一样"（过度比喻） │ - ❌ 禁止："或许"、"也许"、"可能"（过度使用弱化确定性） │ - ❌ 禁止："突然"、"忽然"、"猛然"（过度使用制造紧张） │ - ❌ 禁止："然而"、"但是"、"可是"（每段都用转折） │ - ❌ 禁止："最终"、"最后"、"结局是"（过度总结） │ │ 一、画面感优先 │ - 用细节和场景描写，让读者"看到"而不是"被告知" │ - ❌ 错误：他很紧张。 │ - ✅ 正确：他的手指不自觉地敲击着桌面，额头上渗出细密的汗珠。 │ - 用五感：视觉、听觉、嗅觉、触觉、味觉 │ │ 二、代入感营造 │ - 让读者身临其境，感受人物的情绪和处境 │ - 描写环境氛围：光线、温度、气味、声音 │ - 通过人物的感官体验来传递信息 │ │ 三、冲突张力 │ - 每一场景都要有冲突或悬念 │ - 冲突类型：人与人的冲突、人与环境的冲突、内心的冲突 │ - 场景结束时留下悬念或钩子 │ │ 四、对话有戏 │ - 对话要推动情节，揭示人物性格 │ - ❌ 错误："你觉得怎么样？""我觉得不太好。" │ - ✅ 正确："你觉得怎么样？"他端起茶杯，目光却没落在对方身上。 │ - 用动作和神态打断对话，避免"你一句我一句" │ - 对话中要有潜台词，不要把所有意思都说出来 │ │ 五、节奏控制 │ - 长短句交替，避免单调 │ - 动作场景用短句，营造紧张感 │ - 情感场景用长句，营造氛围 │ - 段落不要过长，便于阅读 │ │ 六、留白艺术 │ - 不要把所有东西都写出来 │ - 让读者自己想象和推理 │ - 用暗示代替直说 │ │ 七、开场抓人 │ - 开头就要有钩子 │ - 可以用：悬念、冲突、对话、场景 │ - 避免开头就大段背景介绍 │ │ 八、情感共鸣 │ - 让读者关心人物的命运 │ - 展现人物的脆弱和困境 │ - 用具体的事件而不是抽象的描述 │ 九、结尾钩子 ⚠️ 必须为下一章留下钩子 - 结尾必须与下一章紧密衔接，为下一章留下明确的钩子 - 钩子类型： - 悬念钩子：一个未解决的问题（"门外传来脚步声，是谁？"） - 行动钩子：人物即将采取的行动（"他站起身，走向狱门"） - 对话钩子：以对话结束，暗示即将发生的事（"'大人，使者到了。'"） - 消息钩子：一个重要消息传来（"甘泉宫传来消息，望气者发现异常天象"） - 场景钩子：场景转换，暗示变化（"远处，马蹄声渐近"） - 结尾要具体，不要泛泛而谈（❌ "风暴要来了" → ✅ "远处传来马蹄声，郭穰的人马到了"） - 结尾要指向下一章的具体事件，让读者想知道"接下来会发生什么" - 不要总结本章，而要开启下一章的悬念 │ 验证（必须全部通过）： │ 1. 基础验证： │ scripts/validate_step.py --step 6 --chapter {X}_{Y} --book-name "{书名}" │ □ 文件存在 │ □ 字数在 3000-4000 范围内 │ □ 开场有标点符号/对话 │ □ 包含感官描写 │ □ 包含对话 │ │ 2. ⚠️【新增】优秀网文10大标准审查（强制）： │ scripts/validate_chapter_quality.py "{书名}" "{X}_{Y}" │ □ 开场抓人 (2分) - 前3段有悬念/冲突/情绪 │ □ 节奏紧凑 (2分) - 每3-5段有小高潮 │ □ 每章有冲突 (2分) - 至少2个冲突 │ □ 人物有动机 (2分) - 主角和反派动机清晰 │ □ 对话有戏 (2分) - 对话推动情节，有潜台词 │ □ 结尾有钩子 (2分) - 为下一章留悬念 │ □ 信息密度 (2分) - 每100字有新信息 │ □ 画面感 (2分) - 五感描写 │ □ 情感真实 (2分) - 情感有层次 │ □ 去AI味 (2分) - 自然流畅，无AI痕迹 │ │ 评分标准： │ - 80-100% (16-20分)：优秀 🌟 │ - 60-79% (12-15分)：良好 ✅ 可通过 │ - 40-59% (8-11分)：及格 ⚠️ 建议修改 │ - <40% (<8分)：不及格 ❌ 必须重写 │ │ 更新：status.md = "第{X}卷第{Y}章 - 已完成，等待审阅" │ 检查点：创建 chapter_{X}_{Y}_complete.checkpoint │ ⚠️ 完成后立即执行 6.3，不可跳过 │ ├─ 6.3: character_check（角色检查）⚠️ 每章完成后强制执行 │ 【触发时机】Step 6.2 完成后立即自动执行，不可跳过 │ 【动作】检查本章出场人物，为新角色创建角色卡 │ 【流程】 │ 1. 【提取人物】分析本章内容，提取所有出场人物名单 │ 2. 【对照角色卡】读取 memory/character_cards.md，标记没有角色卡的人物 │ 3. 【判断重要性】对于没有角色卡的人物： │ - 读取 config/volume_outline.md（卷纲） │ - 读取 config/volume_{X}_chapter_outline.md（本卷细纲） │ - 搜索该人物名字，判断是否在后续章节出现 │ - 如果出现 ≥2 次 → 重要角色，必须创建角色卡 │ - 如果只出现1次 → 工具人，可选创建 │ 4. 【创建角色卡】为重要角色创建角色卡，包含： │ - id: 拼音ID │ - name: 姓名 │ - roles: 身份列表 │ - significance: 在故事中的作用 │ - key_events: 关键事件（可选） │ 5. 【更新关系图】如有新的人物关系，更新 relationship_map.md │ 【产出】更新 memory/character_cards.md（如需要） │ 【验证】确认所有重要角色都有角色卡 │ 【完成后】进入 6.4 等待用户审阅 │ ├─ 6.4: user_review（用户审阅） │ 满意 → 进入下一章 │ 修改 → 返回 6.1 或 6.2 │ 进化：写入 lessons_learned.md（用户修改意见、改进方向） │ └─ 6.5: volume_complete（卷完成判断） 本卷未完 → 回到 6.1，讨论下一章 本卷结束 → 用户确认，创建卷检查点，进入下一卷（Step 5） Step 7: final_assemble（最终合稿） 动作：合并所有章节 产出： - deliverables/final.md - deliverables/final.docx（可选） 验证： scripts/validate_step.py --step 6 --book-name "{书名}" 检查项： □ final.md 存在 □ 包含所有章节 □ 总字数符合预期 验证脚本使用 每次步骤转换前必须运行 ： # 验证 Step 2（项目初始化） python3 scripts/validate_step.py --step 2 --book-name "他养大了皇帝" # 验证 Step 3（世界构建） python3 scripts/validate_step.py --step 3 --book-name "他养大了皇帝" # 验证 Step 5（章节写作） python3 scripts/validate_step.py --step 5 --chapter 1_01 --book-name "他养大了皇帝" 返回值 ： 0 = 验证通过 1 = 验证失败（会输出具体错误） 检查点机制 创建检查点 ： python3 scripts/checkpoint.py create --book-name "{书名}" --name "step_3_complete" 回滚到检查点 ： python3 scripts/checkpoint.py rollback --book-name "{书名}" --name "step_3_complete" 检查点存储位置 ： ~/Documents/{书名}/memory/checkpoints/ ├── step_2_complete.checkpoint ├── step_3_complete.checkpoint ├── step_4_complete.checkpoint └── chapter_1_01_complete.checkpoint 进化机制 每章完成后 ，写入 memory/lessons_learned.md ： ## 章节：第1卷第1章 ### 用户修改意见 - 开头节奏太慢 - 主角出场不够强势 ### 改进方向 - 下章开头3段内必须有冲突 - 人物对话要更有张力 ### 本次经验 - 伏笔埋设成功：神秘老人身份 - 字数控制良好：3200字 每卷完成后 ，生成 memory/volume_{X}_retrospective.md ： ## 第1卷复盘 ### 主题执行情况 - 核心冲突是否推进 - 情感弧线是否完成 ### 角色发展 - 主角成长轨迹 - 配角作用评估 ### 伏笔追踪 - 已埋设：5处 - 已回收：2处