Epic Novel Writer
by @sunshinejnjn
Novel writing full workflow — from world-building and character design to chapter planning, manuscript writing, version archiving, and HTML guide generation....
clawhub install epic-novel-writer📖 About This Skill
name: epic-novel-writer description: Novel writing full workflow — from world-building and character design to chapter planning, manuscript writing, version archiving, and HTML guide generation. Covers medium (100-250k words) to super-long (600k-1.5m words), proven with 420k words / 300 chapters / 10 volumes. Supports global continuous numbering, read-only archives, character JSON, and HTML guides. metadata: openclaw: emoji: "🖊️" version: "1.1.1" compatibility: Pure Markdown workflow, no external dependencies. Requires OpenClaw file I/O and shell execution capabilities. allowed-tools: Read, Write, Edit, Exec
epic-novel-writer — 史诗级长篇写作 Skill
BSD 3-Clause License
Copyright (c) 2026, sunshinejnjn@github
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
项目结构
[小说标题]/
├── 在编辑稿/ ← 所有编辑工作在此目录
│ ├── 01-story-premise.md # 故事设定
│ ├── 02-world-setting.md # 世界观设定
│ ├── 03-chapters-written.md # 章节完成状态
│ ├── 03-outline/ # 大纲（卷级 + 章级蓝图）
│ ├── 04-chapters/ # 章节正文（按卷分目录）
│ ├── 05-reports/ # 过程报告
│ ├── 06-validation/ # 验证报告
│ ├── references/ # 参考（人物卡、关系、线索台账）
│ └── media/ # 图片/media
├── [小说标题]_v1/ ← 存档版本（只读）
├── [小说标题]_v2/ ← 存档版本（只读）
├── [小说标题]_v3/ ← 存档版本（只读）
└── ……
⚠️ 核心规则
所有编辑必须在 在编辑稿 目录上完成
在编辑稿/ 下的文件在编辑稿/ 之外的任何文件存档版本（v1/v2/v3...）是只读的
阶段性存档规则
仅在用户明确要求某个版本作为阶段性成果时，才创建存档版本：
[小说标题]_v1/、[小说标题]_v2/ 等，按创建顺序递增📦 版本存档
存档流程模板
存档的完整流程定义在以下模板文件中，存档时严格参照执行：
> 模板路径：references/archive-template.md（本 SKILL 内）
该模板包含：
存档时的工作方式
1. 先读 references/archive-template.md 获取完整流程
2. 按模板中的步骤逐项执行
3. 模板中每个步骤都有对应的命令示例，可直接参考执行
4. 完成后用模板中的「完成检查」清单逐项验证
命名规则（文件编号 = 章编号）
> 这是存档流程中的核心规则，已同步到模板中：
chapter-001.md（第 1 章）、chapter-300.md（第 300 章）chapter-001.md，卷 2 第 1 章 = chapter-031.md（假设卷 1 有 30 章）人物画像生成
存档时应生成 char_data.json，包含主要角色画像：
主要角色定义：在正文中出现频率高、推动主线或关键剧情的角色。至少包含：
每个角色的画像字段：
| 字段 | 说明 |
|------|------|
| name | 角色名 |
| role | 角色定位（主角/灵体/引导者等） |
| portrait | 角色图片路径（media 目录） |
| description | 简要描述（1-3 句话） |
| key_arc | 角色关键成长线（→ 分隔） |
| first_appearance | 首次出场章节号（如"第 1 章"） |
| affinity | 简称/昵称（用于图片文件匹配） |
次要角色（每卷单元灵）可在 minor_characters 数组中补充。
HTML 导引文件
存档时生成 [小说标题]_导引.html，这是存档的核心导航页：
页面必须包含四个区域：
1. 页面头部 — 标题 + 版本 + 统计数据（如"[小说标题] v3 · N 角色 · M 章"）
2. 全文简要介绍 — 从 01-story-premise.md 和 02-world-setting.md 提取，写一段 200-300 字的小说概述，包含核心主题、故事走向、整体氛围
3. 人物卡区域 — 响应式网格，每人一张卡片（图片 + 名字 + 角色定位 + 简述），暗色主题，hover 高亮
4. 章节目录区域 — 按卷分组，章节号全局连续编号（不是每卷从 1 开始！），每章超链接指向对应 txt 文件
样式要求：
#0a0a0f，卡片 #12121a）PingFang SC, Microsoft YaHei, sans-serif关键检查：章节号是否全局连续？每个链接是否能正确导航？
📐 写作流程（完整生命周期）
> 以下为标准写作流程，按阶段顺序执行。每个阶段输出明确文件，下游阶段依赖上游产出。
阶段 1：构思沟通
与用户深入沟通，确定以下核心要素：
> 篇幅估算参考：每章约 4,000 字，每卷约 10 章（~40,000 字）。用户给定总字数后，按此标准反推总章数和卷数。例如：12 万字 → 约 30 章 → 3 卷。
产出：01-story-premise.md
阶段 2：人物设定（含时间线）
根据构思创建角色设定，包含：
产出：references/characters/角色名.md（每个角色一张卡片）+ references/character-relationships.md
阶段 3：核对修订人物与时间线（2 遍）
第 1 遍核对：
第 2 遍修订：
产出：修订后的人物卡片 + 关系表（时间线锁定，后续不再变动基础设定）
阶段 4：分卷规划
产出：03-outline/00-master-outline.md（总纲）
阶段 5：卷级大纲
为每一卷撰写大纲，包含：
产出：03-outline/vol-{N}-outline.md（每卷一个）
阶段 6：章级蓝本
为每卷的每一个章节撰写蓝本（blueprint），包含：
产出：03-outline/vol-{N}/chapter-{XX}-blueprint.md（每章一个）
阶段 7：撰写前三章（开篇定调）
先写而非先写全卷，确保文风和叙事基调正确： 1. 按章级蓝本撰写第 1-3 章正文 2. 每章完成后进行 2 遍校验与润色： - 第 1 遍：逻辑校验（与蓝本是否一致、时间线是否正确） - 第 2 遍：文笔润色（节奏、对话、描写质量） 3. 用户确认前三章定调无误
产出：04-chapters/vol-1/chapter-001.md ~ chapter-003.md（校验润色后的定稿）
阶段 8：分卷并行撰写（Sub-Agent 并行）
产出：04-chapters/vol-{N}/chapter-{XX}.md
阶段 9：整卷校验与蓝本核对
卷内所有章节完成后，执行： 1. 整卷校验：通读全卷，检查剧情连贯性、角色一致性、伏笔回收情况 2. 蓝本核对：对比蓝本与正文，检查是否偏离预设、是否有遗漏的伏笔/设定 3. 修正发现的问题 4. 用户确认本卷定稿
产出：修订后的正文 + 06-validation/vol-{N}-validation-report.md（校验报告）
阶段 10：重复阶段 4-9，依次完成各卷
阶段 11：全卷并行修订（Sub-Agent 并行，2 遍）
所有卷完成后，使用 Sub-Agent 并行执行修订：
产出：修订后的各卷正文
阶段 12：全文校验（3 遍）
全书完成后，执行全文级别校验：
产出：全文定稿 + 06-validation/full-book-validation-report.md
阶段 13：存档 v0
全书定稿后，执行第一次完整存档：
references/archive-template.md 执行 8 步存档流程[小说标题]_v0/（v0 表示全书完成的首个存档）产出：[小说标题]_v0/ 完整存档目录
📏 适用篇幅
| 篇幅 | 章节数 | 字数范围 | 推荐程度 | |------|--------|---------|---------| | 中篇 | 30-80 章 | 10-25 万字 | ✅ 完全覆盖 | | 长篇 | 80-200 章 | 25-60 万字 | ✅ 完美匹配 | | 超长篇 | 200-500 章 | 60-150 万字 | ✅ 完全胜任 |
> 💡 实测标杆：本项目已用于生成 420,000 字（300 章，10 卷），验证了全局连续编号、防崩设定体系、HTML 导引页生成等核心功能在超长篇场景下的可靠性。
📏 适用篇幅
| 篇幅 | 章节数 | 字数范围 | 推荐程度 | |------|--------|---------|---------| | 中篇 | 30-80 章 | 10-25 万字 | ✅ 完全覆盖 | | 长篇 | 80-200 章 | 25-60 万字 | ✅ 完美匹配 | | 超长篇 | 200-500 章 | 60-150 万字 | ✅ 完全胜任 |
> 💡 实测标杆：本项目已用于生成 420,000 字（300 章，10 卷），验证了全局连续编号、防崩设定体系、HTML 导引页生成等核心功能在超长篇场景下的可靠性。