# Novel Writer

长篇小说/网文连载创作：从世界观、人设和三级大纲写到逐章正文，并用文件化状态维护伏笔、前情和跨章一致性。...

- Repository: https://github.com/ZJU-REAL/Easel (4293 stars)
- Category: Writing
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add ZJU-REAL/Easel --skill novel-writer -g -a claude-code -y`
Codex: `npx skills add ZJU-REAL/Easel --skill novel-writer -g -a codex -y`
Cursor: `npx skills add ZJU-REAL/Easel --skill novel-writer -g -a cursor -y`
Gemini CLI: `npx skills add ZJU-REAL/Easel --skill novel-writer -g -a gemini-cli -y`

## Description

长篇小说/网文连载创作：从世界观、人设和三级大纲写到逐章正文，并用文件化状态维护伏笔、前情和跨章一致性。 当用户说“写小说/网文/盐选故事、连载、续写下一章、小说大纲、人物设定、世界观、黄金三章”时使用。 通用文章用 article-outline/social-content；单段改风格或润色用 style-transfer/text-polisher。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# AI 小说 / 网文连载创作

> 一句灵感 → 世界观/人设 → 三级大纲 → 逐章正文。核心是**长篇一致性**：
> 用「**文件即真相 + 按需加载**」, , AI 不靠上下文记忆，每写一章只加载相关切片，
> 状态全落文件、可 diff、可续写。确定性 IO（搭骨架/进度/机械查 AI 味）走
> `scripts/novel_ops.py`，**创意（设定/大纲/正文）由你 LLM 完成**。

> 只做单段风格改写见 **style-transfer**；只做润色去 AI 感见 **text-polisher**；
> 只做通用文章见 **social-content**；发知乎见 **skill-zhihu-publisher**。

## 输入

| 字段 | 必填 | 说明 |
|------|------|------|
| 灵感/题材 | 是 | 一句话创意，或已有设定（没给就问） |
| 平台 | 否 | 知乎盐选 / 番茄 / 起点 / 小红书图文（默认按 Profile 或问） |
| 书名 | 否 | 缺省由题材拟定，用作产物目录名 |
| 本次动作 | 否 | 立项 / 出大纲 / 写第 N 章 / 续写 / 改图文（默认按对话判断） |

## 产物结构（`outputs/书名/`）

```
bible/    world.md characters.md voice.md canon.md   ← 硬事实（写每章必读）
outline/  overview.md volumes.md chapters.md          ← 三级大纲
state/    summary.md character-state.md plot-arcs.md progress.json/md  ← 连载状态
chapters/ 001.md 002.md ...                            ← 章节正文
```

脚本路径（相对项目根）：`skills/builtin/novel-writer/scripts/novel_ops.py`。
字数校验复用：`skills/shared/scripts/wordcount.py`。

## 执行步骤（按对话选对应子流程，不必每次全跑）

### A. 立项（首次）

1. **搭骨架**：`python skills/builtin/novel-writer/scripts/novel_ops.py scaffold --book "<书名>"`
   （生成 bible/outline/state/chapters 模板，已存在的文件不覆盖）。
2. **定世界观 + 人设 + 文风**：读 `references/web-novel-methodology.md` 与 `references/platform-specs.md`，
   据题材写满 `bible/world.md`（力量体系/规则/硬约束）、`bible/characters.md`（主角+关键配角：身份/外貌/性格/目标/关系）、
   `bible/voice.md`（视角/时态/句式节奏/用词偏好 + 本书禁用词表）。设定要**可执行**（能约束后续正文），不写空话。

### B. 大纲（三级）

3. **overview → volumes → chapters**：写 `outline/overview.md`（一句话卖点+核心冲突+主线+结局向）、
   `outline/volumes.md`（分卷 arc：每卷目标/转折/卷末高潮）、`outline/chapters.md`（章节目录表：标题+一句话钩子+涉及伏笔）。
   大纲底座可参考 `skill-article-outline`，但必须扩成网文三级结构 + 伏笔埋点表（登记进 `bible/canon.md`）。

### C. 黄金三章（前 3 章单独强化）

4. 按 `references/web-novel-methodology.md` 的黄金三章模板，把前三章的**开局钩子、爽点、代入感、追读悬念**拉满
   （第 1 章 3 秒内给冲突/金手指信号；每章末留强钩子）。这三章决定留存，值得单独打磨。

### D. 写单章（连载主循环）

The rest: https://github.com/ZJU-REAL/Easel/blob/HEAD/skills/builtin/novel-writer/SKILL.md