---
name: novel-write
description: |
  Long-form novel writing skill covering the full pipeline: genre diagnosis → deep consultation → worldbuilding → outline co-creation → per-chapter pipeline (detailed outline → writing → quality inspection → evolution → approval).
  Use when writing novels, starting new books, continuing chapters, batch generating, editing chapters, creating outlines, worldbuilding, or quality checking.
---

# 小说写作技能

## 核心铁律（六条不可变规则）

**铁律一：展示而非讲述。**
用动作和对话表现，不要直接陈述。不是"她很悲伤"，而是"她把杯子放回桌上，瓷器发出一声脆响"。

**铁律二：冲突驱动剧情。**
每章必须有冲突或转折。Scene 三要素缺一不可：目标 → 阻碍 → 变化。没有变化的场景默认删除、合并或压缩。

**铁律三：悬念承上启下。**
每章结尾必须留下钩子。章末的目的不是"干净收束"，而是"留下后劲"。禁止以总结句、说教句、已消散的情绪、解释性文字结尾。

**铁律四：爽点密度决定留存。**
每 3000-5000 字必须有一个爽点/情绪释放点。爽点需要铺垫——铺垫越长，释放时爽感越强。

**铁律五：在类型框架内制造新鲜感。**
不否定类型化——而是在类型框架中注入信息增量。开篇用熟悉感留住读者，关键节点用陌生走向制造惊喜。

**铁律六：每次写作任务后自动进化。**
每次完成续写/修改已有章节/质检/批量生成后，必须执行进化脚本。进化结果写入 `evolution/` 文件夹。连续写作 3 章以上无进化 → 警告提示。

> **操作系统差异：** Linux/macOS 执行 `~/.claude/skills/novel-write/scripts/evolve.sh`，Windows 执行 `~/.claude/skills/novel-write/scripts/evolve.ps1`。

---

## 总写作流程

### 全书生命周期

```
题材诊断 → 深度问诊 → 设定 → 大纲共创（全书大纲+卷纲）→ 单章流水线
```

| 阶段 | 做什么 | 产出 |
|------|--------|------|
| 题材诊断 | 五句话 + 一句话钩子 + 黄金三章检查 | 题材可行性判断 |
| 深度问诊 | 五层决策树迭代提问 | `设定/题材定位.md` |
| 设定 | 世界观 + 角色 + 势力 + 项目铁律 | `设定/` + `项目铁律.md` |
| 大纲共创 | 全书结构 + 卷纲（爽点分布+情感弧线+伏笔清单） | `大纲/全書大纲.md` + `大纲/卷纲_第N卷.md` |
| 单章流水线 | 细纲 → 写前准备 → 写作 → 写后自检 → 更新追踪 → 质检 → 进化 → 审批 | 已锁定章节 |

**阶段不可跳跃。** 全书结构未定不写卷纲，卷纲未定不进单章流水线。

### 单章流水线

```
细纲 → 写前准备 → 写作 → 写后自检 → 更新追踪 → 质检 → 进化 → 审批
```

| 阶段 | 做什么 | 产出 |
|------|--------|------|
| 0. 细纲 | 核心事件+钩子+爽点+伏笔操作（前10章在大纲共创时已完成，后续按需追加） | `大纲/细纲_第NNN章.md` |
| 1. 写前准备 | 加载细纲 + 钩子账本 + 情感矩阵 + 上下文 + 出场角色 | 脑中场景就绪 |
| 2. 写作 | 边写边对照铁律 + 四维引擎检查 | 章节正文 |
| 3. 写后自检 | 章末钩子/爽点/字数/世界观/去AI味 + 长度标准化 | 标准化章节 |
| 4. 更新追踪 | 钩子账本 + 情感矩阵 + 时间线 + 上下文 | 追踪文件最新 |
| 5. 质检 | 自修正循环：五遍编辑评估 → 一致性 → 四维专项 → 去AI味 | 评分 ≥ 80 |
| 6. 进化 | 执行 evolve.sh --project | 提示词持续优化 |
| 7. 审批 | review 检查清单 → approved / rejected（仅单章续写和修改已有章节，批量跳过） | 章节锁定或退回 |

**铁律：** 阶段不可跳过、不可调换顺序。细纲未定不开写，质检不通过（< 80）不进入进化，进化不完成不进入审批。审批不通过 → 回到写作修改，重新走流水线。

---

## 章纲模板

每章必须定义。完整模板见 [WORKFLOWS.md#章纲模板](WORKFLOWS.md#章纲模板)。核心字段：核心事件、章首/末钩子（类型+期待感等级）、爽点（类型+模式+位置+铺垫起点）、笑点（如适用）、情感更新、钩子议程（推进/兑现/新种/stale）、局面变化。

---

## 场景路由

| 用户意图 | 触发词 | 路径 |
|----------|--------|------|
| 开新书 | "开新书""写小说" | 题材诊断 → 深度问诊 → 设定 → 大纲共创（全书大纲+卷纲）→ 单章流水线 |
| 续写 | "续写""日更""写第X章" | 续写流程（见下方） |
| 批量生成 | "批量写""一次写X章" | 批量生成流程（见下方） |
| 修改已有章节 | "修改第X章""重写" | 修改已有章节流程（见下方） |
| 导入已有 | "导入小说""导入章节" | 导入流程 → [WORKFLOWS.md](WORKFLOWS.md) |
| 全书重命名 | "改名""替换XX为YY" | 重命名流程 → [WORKFLOWS.md](WORKFLOWS.md) |
| 质检 | "检查""质检""一致性" | 质检完整体系 → [WORKFLOWS.md](WORKFLOWS.md) |
| 章节审批 | "审批""通过第X章" | 章节审批门 → [WORKFLOWS.md](WORKFLOWS.md) |
| 仪表板 | "仪表板""数据""统计" | 分析仪表板 → [WORKFLOWS.md](WORKFLOWS.md) |
| 风格分析 | "分析风格""风格模仿" | 风格模仿流程 → [WORKFLOWS.md](WORKFLOWS.md) |
| 新建角色 | "添加角色""创建角色" | 增量更新设定 |
| 调整大纲 | "调整大纲" | 增量更新大纲 → 受影响章节回退 draft → 重新单章流水线 |
| 自优化 | "/进化""自优化""进化" | evolution/ 文件夹 |

---

## 快速续写

日常续写走单章流水线全八步。详细展开见 [WORKFLOWS.md](WORKFLOWS.md)。

### Step 0 — 确认/创建细纲
细纲存在 → 加载。不存在 → 基于卷纲 + 上一章结尾创建。

### Step 1 — 加载上下文
`细纲 → 钩子账本 → 情感矩阵 → 上下文`（必读）。出场角色/世界观/卷纲/上一章正文（按需）。

### Step 2 — 写作
边写边检查：开头500字有钩子、POV/时态一致、对话三维标准、场景目标→阻碍→变化、禁用词、无元语言、去AI味。四维检查：爽点/笑点/代入感/反同质化。

### Step 3 — 写后自检 + 长度标准化
章末钩子、爽点兑现、字数达标、世界观无冲突、无AI味。长度超出/不足目标 30% → 单遍压缩/扩展。安全网：需删 75% 以上原文才能达标 → 标记"拆分两章"；扩展后信息密度显著下降 → 标记"合并到下一章"。

### Step 4 — 更新追踪
钩子账本、情感矩阵、时间线、上下文（每3章）。

### Step 5 — 质检
自修正循环（最多 5 轮）：
- 五遍编辑评估（P1→P5 按序）→ 综合评分
- ≥ 80 → 通过。60-79 → 修订。40-59 → 重写。 < 40 → 废弃回到 Step 0
- 通过后：一致性 + 四维专项 + 去AI味
- 5轮后仍 < 80 → 废弃

### Step 6 — 进化

```bash
# Linux/macOS
~/.claude/skills/novel-write/scripts/evolve.sh --project /path/to/novel
# Windows
~\\.claude\\skills\\novel-write\\scripts\\evolve.ps1 -Project /path/to/novel
```

### Step 7 — 审批
单章续写必须审批。批量跳过。详见 [WORKFLOWS.md#章节审批门](WORKFLOWS.md#章节审批门)。

---

## 修改已有章节

跳过细纲和写作，其他流程不变：

1. 读取目标章节 + 前后各一章 + 钩子账本 + 情感矩阵
2. 执行修改（精确编辑，不重印整章）
3. 更新钩子账本 + 情感矩阵，检查前后章衔接
4. **质检：** < 200 字且不影响情节 → P1+P5+一致性（任意不过→升级完整五遍）。≥ 200 字或涉及情节 → 完整五遍
5. **进化：** 执行 evolve.sh --project
6. **重新审批：** 状态回退到 review

---

## 批量生成

逐章走完整单章流水线（Step 0→1→2→3→4→5→6），跳过审批（Step 7）。Step 3 包含写后自检和长度标准化。每章质检通过 + 进化完成后才进入下一章。每 3 章连续性检查。完成后输出摘要，等待批量签收。

**铁律：** 不跳大纲、不跳追踪、不跳质检、不跳进化。签收不通过 → 逐章修复，走修改已有章节流程。

---

## 自优化系统

### 写前

```bash
# Linux/macOS
~/.claude/skills/novel-write/scripts/evolve.sh
# Windows
~\\.claude\\skills\\novel-write\\scripts\\evolve.ps1
```

自动 git pull + compile。加载题材最优提示词和阈值。

### 写后

```bash
~/.claude/skills/novel-write/scripts/evolve.sh --project /path/to/novel
```

反馈收集 → 分析 → 进化 → git add + commit + push。网络不通降级为纯本地模式。

### 题材映射

```
仙侠→xianxia  玄幻→xuanhuan  都市→urban
悬疑→suspense  科幻→sci-fi  恐怖→horror
历史→history  游戏→gaming  末世→system-apocalypse
轻小说→light-novel  无匹配→other
```

进化数据位于 `evolution/` 目录，题材级共享。加载优先级：题材级 `current_best.json` → 题材级 `thresholds.json` → 技能级通用回退。详见 [REFERENCE.md](REFERENCE.md#自优化系统详解)。

---

## 文件指南

- **[WORKFLOWS.md](WORKFLOWS.md)** — 完整流程：题材诊断、深度问诊、风格模仿、大纲共创、续写（完整展开）、修改已有章节、批量生成、导入、重命名、质检完整体系（五遍评估/一致性/四维专项/去AI味/审批门）、分析仪表板
- **[REFERENCE.md](REFERENCE.md)** — 理论与参考：项目文件结构、三根支柱（铁律/钩子账本/情感矩阵）、四维引擎（爽点/笑点/代入感/反同质化）、自优化系统详解、语言规则