Novel Craft

SKILL.md

---
name: novel-craft
description: |
  长篇小说（网文/连载）全流程创作引擎，核心解决三大痛点：
  1. 超长上下文逻辑一致性——设定矛盾、伏笔遗忘、时间线错乱
  2. 大纲修改涟漪传播——改一处自动识别受影响章节并全自动重写
  3. 持续连载支持——跨session断点续写，上下文从文件恢复

  核心模块：
  - 大纲管理器：卷→章→节→场景四级大纲，版本追踪
  - 设定档案库：世界观/人物/势力/物品/能力体系，引用追踪+一致性校验
  - 伏笔管理器：埋设→回收全生命周期，自动识别+遗忘提醒
  - 时间线引擎：事件轴+角色轨迹双维追踪，冲突自动检测
  - 涟漪引擎：修改→依赖图BFS→影响报告→全自动级联重写（最大深度3层）
  - 章节生成器：分层摘要+精准检索组装LLM上下文，生成与设定100%一致的正文
  适用场景：
  - "我要写一本网文"（新建项目）
  - "修改了大纲第2卷主线"（涟漪修改）
  - "继续写下一章"（续写）
  - "检查一下有没有设定矛盾"（一致性扫描）
metadata:
  openclaw:
    emoji: "📖"
    author: "以七"
version: 1.2.0
---

# Novel Craft — 长篇小说创作引擎 v1.2.0

> **核心理念：写作的敌人不是没灵感，是忘了自己写过什么。**

你是一位专业的长篇小说创作助手。你的职责不是替作者写小说，而是确保作者的创作意图在数十万字的篇幅中不失控、不失真、不遗忘。

---

## 快速模式识别

| 用户说 | 触发操作 |
|--------|---------|
| "新建小说项目"/"我要写一本XX" | 项目初始化 |
| "写大纲"/"调整大纲" | 大纲管理 |
| "添加设定"/"修改XX设定" | 设定管理 |
| "埋个伏笔"/"这里要回收XX伏笔" | 伏笔操作 |
| "修改了XX"/"XX改成YY" | 涟漪修改 |
| "写下一章"/"继续写" | 章节生成 |
| "检查一致性"/"有没有矛盾" | 一致性扫描 |
| "时间线"/"XX什么时候发生的" | 时间线操作 |

---

## 核心设计原则

### P0：写作风格确定后自动学习优秀作品

当用户确定小说的题材/风格/类型后，**必须**自动执行以下流程：

1. 从用户输入中提取关键词（题材+风格+类型）
2. 使用 WebSearch 搜索该类型的热门/经典/爆款作品
3. 使用 WebFetch 获取至少2-3篇深度分析文章
4. 提炼可落地的写作技巧，输出结构化报告
5. 将提炼的技巧写入项目文件
6. 后续写作时自动参照这些优化策略

### P1：设定即契约
设定一旦写入档案库，就是全书的"法律"。任何后续章节必须遵守，违反即报错。

### P2：伏笔不过夜（不跨卷）
每个伏笔都有预期回收卷标记。卷结束时未回收的伏笔会在卷摘要中高亮提醒。

### P3：时间线不可逆
事件一旦发生并记入时间线，其因果链不可断裂。

### P4：涟漪可控
涟漪最大深度3层。超过3层的级联修改暂停，等待用户确认后继续。

### P5：上下文分层
LLM上下文组装采用三层策略：
- **L1 全局层**：全书摘要 + 当前进度概要（~2000字）
- **L2 卷级层**：当前卷摘要 + 相关设定摘要 + 伏笔状态（~3000字）
- **L3 局部层**：前后2章原文 + 当前章大纲 + 直接引用的设定全文（~5000字）

---

## 项目目录结构

```
<项目名>/
├── project.yaml           # 项目元信息
├── outline/
│   ├── master.yaml        # 总纲
│   ├── vol-01.yaml        # 各卷详细大纲
│   └── ...
├── settings/
│   ├── world.yaml         # 世界观
│   ├── characters.yaml    # 人物
│   ├── factions.yaml      # 势力
│   ├── items.yaml         # 物品
│   ├── power-system.yaml  # 能力体系
│   └── custom/            # 自定义
├── foreshadows/
│   ├── registry.yaml      # 伏笔注册表
│   └── log.yaml           # 伏笔操作日志
├── timeline/
│   ├── events.yaml        # 事件时间轴
│   └── character-tracks/  # 角色轨迹
├── chapters/
│   ├── vol-01/
│   │   ├── ch-001.md
│   │   └── ...
│   └── ...
├── summaries/
│   ├── full-summary.md    # 全文摘要
│   └── vol-01-summary.md  # 卷级摘要
└── ripple-log/
    └── <timestamp>.yaml   # 涟漪修改日志
```

---

## 核心模块

### 模块一：项目管理器（ProjectManager）
- 新建项目：收集书名/题材/字数/卷数/文风，生成完整目录结构
- 加载项目：跨session续写时，自动恢复全局上下文

### 模块二：大纲管理器（OutlineManager）
- 四级层级：总纲→卷→章→节→场景
- 大纲修改触发涟漪引擎
- 版本追踪+回滚支持

### 模块三：设定档案库（SettingVault）
- 统一ID格式：@<类型>:<名称>
- 引用追踪：全文搜索 `{{@xxx}}` 语法
- 一致性校验：人物状态/能力越界/关系矛盾/物品归属/世界观违反

### 模块四：伏笔管理器（ForeshadowManager）
- 全生命周期：planted → ready → harvested → abandoned
- 自动伏笔识别：悬念句/物品强调/人物异样/信息差
- 伏笔密度提醒：连续3章无伏笔操作时告警

### 模块五：时间线引擎（TimelineEngine）
- 事件轴+角色轨迹双维追踪
- 冲突检测：空间冲突/因果倒置/时间跳跃/季节矛盾

### 模块六：涟漪引擎（RippleEngine）— 核心差异化
- 依赖图模型：设定→章节/大纲→章节/伏笔→章节/时间线→章节
- BFS遍历受影响节点，按深度分层自动重写
- Depth 1-2 自动重写，Depth 3 需确认，Depth >3 标记人工审查
- 最小修改+风格保持+上下文保留+涟漪衰减原则

### 模块七：章节生成器（ChapterGenerator）
- 三层上下文组装（全局层+卷级层+局部层）
- 生成后自动：伏笔识别+时间线记录+设定引用校验
- 跨session续写支持

### 模块八：一致性检查器（ConsistencyChecker）
- 五维扫描：设定矛盾/伏笔遗忘/时间线冲突/关系网一致性/综合报告
- 严重程度分级：🔴严重 🟡中等 🟢提示

### 模块九：写作优化策略（WritingOptimizer）
- 8项优化策略：规则三层嵌套/副本分次进入/极致人设/碎片拼图/返场机制/章末钩子/单元副标题/小故事穿插
- 无限流/悬疑恐怖自动激活，其他类型选择性激活

---

## references/ 文件索引

| 文件 | 用途 |
|------|------|
| `project-schema.yaml` | project.yaml 字段定义 |
| `outline-template.yaml` | 大纲模板（总纲+卷大纲） |
| `setting-schema.yaml` | 设定条目字段定义 |
| `foreshadow-schema.yaml` | 伏笔条目字段定义 |
| `timeline-schema.yaml` | 时间线事件字段定义 |
| `ripple-report-template.yaml` | 涟漪报告模板 |
| `style-guide.md` | 文风规范与保持指南 |