小说工匠 Fiction Crafter

精细化小说创作工具，自动完善提示词并生成章节制通用化小说（支持爽文、都市、修仙、玄幻、科幻、悬疑、言情等多题材）。通过 .learnings/ 记忆系统维护故事连续性，确保角色、地点、情节前后一致。

> 数据存储位置：所有生成物（章节目录 output/ 与记忆目录 .learnings/）均存放于当前小说项目根目录（运行创作任务时 Agent 的工作目录 CWD），而非技能安装目录。这样每部小说都拥有独立、互不干扰的记忆空间。

> 致谢：本技能基于 novel-generator 进行二次开发，感谢原作者的贡献。

工作目录与初始化约定

本技能的所有生成物（章节目录 output/ 与记忆目录 .learnings/）均存放于当前小说项目根目录（即运行创作任务时 Agent 的工作目录 CWD），而非技能安装目录。这样每部小说都拥有独立、互不干扰的记忆空间与输出目录。

• 技能安装目录（webnovel-crafter-1.2.0/）只保留指令（SKILL.md）、模板（assets/）、参考（references/）、脚本（scripts/），属于只读资产，随技能分发。
• 小说项目目录（你的小说工程根目录）持有 output/ 与 .learnings/，随单部小说创建。

本文档中所有 output/... 与 .learnings/... 路径，若无特别说明，均相对于当前小说项目根目录。

启动时初始化（推荐由 Agent 执行）

每次开始一部小说创作前，Agent 应确认当前项目根目录下存在以下结构；若缺失则按 assets/LEARNINGS-TEMPLATE.md 的模板头创建对应文件：

<项目根目录>/
├── output/                      # 章节与提示词/大纲输出
│   └── (章节 md 文件)
└── .learnings/                  # 记忆系统（详见第七步）
    ├── CHARACTERS.md            # 角色档案
    ├── LOCATIONS.md             # 地点档案
    ├── PLOT_POINTS.md           # 关键情节/伏笔
    ├── STORY_BIBLE.md           # 世界观设定
    ├── 题材配置.md              # 启用专项类型及增减记录（多专项管理）
    ├── ERRORS.md                # 生成失败记录
    ├── 审查记录.md              # 九维度审查记录
    └── 章节规划_卷N.md          # 每卷章节规划（按需生成）

也可使用可选脚本一键初始化（见文末「初始化新小说」）。

> 旧数据迁移：若此前记忆被创建在技能安装目录的 .learnings/ 中，请将其整体移动到你的小说项目根目录，避免多部小说共享或覆盖彼此的记忆。

快速参考

工作流总览

用户提供方向（题材/关键词/灵感）
        ↓
  ┌─────────────────┐
  │ 1. 提示词生成    │ → 自动补全世界观、人设、冲突、节奏
  └────────┬────────┘
           ↓
  ┌─────────────────┐
  │ 2. 大纲规划      │ → 全局章节大纲 + 起承转合设计
  └────────┬────────┘
           ↓
  ┌─────────────────┐
  │ 3. 卷级章节规划   │ → 每卷的章节任务、高光分布、伏笔规划 【新增】
  └────────┬────────┘
           ↓
  ┌─────────────────┐     ┌─────────────────┐
  │ 4. 逐章生成      │ ←→  │ .learnings/ 记忆 │
  └────────┬────────┘     └─────────────────┘
           ↓
  ┌─────────────────┐
  │ 5. 格式化处理    │ → 调用 format_chapter.py 脚本 【新增】
  └────────┬────────┘
           ↓
  ┌─────────────────┐
  │ 6. 章节审查      │ → 九维度诊断，确保剧情不偏离 【新增】
  └────────┬────────┘
           ↓
  ┌─────────────────┐
  │ 7. 输出 & 图解   │ → output/第XX章.md + 关键情节图解
  └─────────────────┘

第一步：提示词生成与完善

用户只需提供一个方向，代理自动补全为完整的创作提示词。

用户输入示例

用户可能只给出一句话：

• "写一个都市修仙的小说"
• "重生回高中逆袭成商业大亨"
• "废柴少年获得系统后一路碾压"

提示词自动完善流程

收到用户方向后，按以下维度自动补全：

1. 题材定位    → 主类型 + 子类型（如：都市 + 修仙）
2. 世界观设定  → 力量体系、社会规则、时代背景
3. 主角人设    → 初始身份、性格、金手指/挂
4. 核心冲突    → 主线矛盾 + 前3章的即时冲突
5. 高光设计    → 打脸/反转/突破等情绪高点（爽文题材侧重打脸节奏）
6. 节奏规划    → 每N章一个小高潮、每M章一个大高潮
7. 配角框架    → 对手/盟友/红颜各至少1人
8. 开篇钩子    → 第一章用什么抓住读者

完善后的提示词保存到 output/提示词.md，并请用户确认或调整。

提示词质量检查

完善后自检以下项：

• [ ] 主角有清晰的起点、动机与困境（困境凸显成长弧光）
• [ ] 金手指/特殊能力/设定有清晰的规则和限制（如有）
• [ ] 前三章至少有一个"钩子"或高光场景设计
• [ ] 能力/力量体系有明确层级与成长空间（如有）
• [ ] 有至少一个"被低估 → 证明自己"的经典结构（通用）

专项题材确认与题材配置（多专项灵活增减）

本工具支持多题材专项（爽文、言情、悬疑、科幻、历史、西幻等），各专项的专属要素、套路、节奏、禁忌登记在 references/GENRES.md。

1. 首次确认（第一步）：补全提示词后，参考 references/GENRES.md 询问用户需要启用哪些专项题材，将启用列表与变更记录写入项目级 .learnings/题材配置.md（模板见 assets/LEARNINGS-TEMPLATE.md）。
2. 生成期加载：每次生成新章节前，读取 .learnings/题材配置.md，按启用列表加载对应专项参考（如 references/genre-shuangwen.md），指导该章基调、套路与节奏。
3. 灵活增减：编辑/续写期用户可随时要求新增或停用某专项。新增时创建/确认 references/genre-<slug>.md（参考 GENRES.md 的"如何新增"）并加入 .learnings/题材配置.md 启用列表；停用时从启用列表移除并附注停用日期。每次增减后立即同步 .learnings/题材配置.md。

第二步：大纲规划

在提示词确认后、正式写作前，先生成全局大纲。

大纲结构

# 《小说名》大纲

## 基本信息
- 题材：
- 预计章节数：
- 每章字数：可变（生成前与用户确认，默认约 5000 字）

## 力量/等级体系
（从低到高列出等级）

## 主线剧情走向
### 第一卷：[卷名]（第1-N章）
- 核心冲突：
- 主角成长：从XX到XX
- 高光设计：

### 第二卷：[卷名]（第N+1-M章）
...

## 关键转折点
1. 第X章：（描述转折）
2. 第X章：（描述转折）

大纲保存到 output/大纲.md。

第三步：卷级章节规划【新增】

在大纲确认后、正式写作前，为每一卷生成详细的章节规划。这是防止剧情写偏的关键步骤。

规划时机

章节规划内容

每卷的章节规划包含以下要素：

1. 本卷核心目标    → 本卷要达成的剧情目标
2. 章节分解表      → 每章的核心任务、高光类型、关键情节
3. 高潮节点规划    → 中高潮和卷终高潮的章节位置
4. 新角色/新地点   → 本卷将引入的新元素
5. 伏笔规划        → 本卷埋设和回收的伏笔

章节分解表示例

规划质量检查

规划完成后自检以下项：

• [ ] 每章都有明确的"核心任务"
• [ ] 高光分布均匀，没有连续3章无高光/情节推进
• [ ] 中高潮和卷终高潮位置合理
• [ ] 伏笔埋设和回收章节都已标注
• [ ] 本卷目标与大纲主线一致

输出文件

章节规划保存到 .learnings/章节规划_卷N.md。

详见 assets/VOLUME-PLAN-TEMPLATE.md。

第四步：逐章生成

确认本章目标字数（可变长度）

每次正式生成某章正文前，向用户确认本章目标字数，并给出以下建议档位：

• 用户未指定时默认 5000 字。
• 将确认值写入该章对应的章节规划（output/章节规划_卷N.md 或 .learnings/章节规划_卷N.md）与章节文件头部「本章字数」。
• 若启用了专项题材（references/GENRES.md 与 .learnings/题材配置.md），专项参考中的篇幅建议可覆盖默认档位。

生成前必读

每次生成新章节前，必须读取以下文件：

output/大纲.md              → 全局剧情走向
.learnings/章节规划_卷N.md   → 本卷每章的核心任务 【新增】
.learnings/CHARACTERS.md    → 当前所有角色的状态
.learnings/LOCATIONS.md     → 已出现的地点
.learnings/PLOT_POINTS.md   → 已发生的关键情节
.learnings/STORY_BIBLE.md   → 世界观设定和规则
.learnings/题材配置.md     → 启用专项题材列表（用于加载专项参考）【新增】

章节生成模板

每章按以下结构生成：

# 第XX章 [章节名]

> **本章概要**：一句话概括本章核心事件
> **本章高光（情绪爽点）**：本章的主要情绪高点来源
> **情绪曲线**：低开高走 / 层层递进 / 反转爆发

---

（正文内容，约 [本章目标字数] 字，默认 5000）

---

> **章末钩子**：留下的悬念，引导读者继续

章节质量标准

通用节奏公式

每 1-2 章：小冲突/小转折（维持阅读引力）
每 3-5 章：中高潮（反转、突破、关系进展）
每 8-12 章：大高潮（翻转局势、揭示真相、大规模进展）
每 15-20 章：卷终决战（解决卷级矛盾、主角阶段性质变）

> 写作爽文题材时，可参考 references/genre-shuangwen.md 获取打脸碾压、情绪爽感等专项节奏公式与禁忌。

第五步：格式化处理【新增】

每章生成完毕后，调用 format_chapter.py 脚本处理章节文件中的分隔符。

脚本位置

scripts/format_chapter.py

脚本功能

• 只保留章节文件首尾两个 --- 分隔符
• 删除中间所有多余的分隔符
• 确保章节格式统一规范

调用方式

# 处理单个文件（output/ 为当前小说项目根目录下的章节目录）
python3 <技能目录>/scripts/format_chapter.py output/第01章_章名.md

# 处理整个 output 目录
python3 <技能目录>/scripts/format_chapter.py output/

> 说明：scripts/format_chapter.py 是技能安装目录内的脚本，请使用其绝对路径或在技能目录上下文中引用；output/ 则是当前小说项目根目录下的章节目录。脚本本身路径无关，仅接收文件/目录参数。

处理时机

第六步：章节审查【新增】

每章生成并格式化后，立即执行审查，确保长篇小说剧情不偏离、不穿帮、不重复。

两种审查模式

模式选择指南

快速审查（3维度）

完整审查（9维度）

穿帮检测清单

角色状态穿帮：
- ❌ 死亡角色复活
- ❌ 受伤角色未说明已痊愈
- ❌ 角色位置矛盾
- ❌ 角色等级倒退

地点穿帮：
- ❌ 地点特征矛盾（东城变西城）
- ❌ 地点距离矛盾
- ❌ 已毁地点出现

能力/等级穿帮：
- ❌ 主角等级无故倒退
- ❌ 装备消失未说明
- ❌ 金手指状态矛盾

时间线穿帮：
- ❌ 时间倒流
- ❌ 间隔不合理

角色成长追踪

主角成长曲线：
- 等级、战斗力、社会地位、资产、人脉
- 连续5章无成长 = 预警

配角命运追踪：
- 出场后超过15章未出现 = 预警
- 需回收或说明去向

套路重复检测

与前5章对比，检测相似度：
- ⚠️ 高预警：相似度 > 80%
- ⚠️ 中预警：相似度 > 60%
- ✅ 正常：相似度 < 60%

长期伏笔预警

总体评级规则

• ✅ 优秀：全部维度正常
• ⚠️ 良好：1-2个维度预警
• ⚠️ 需调整：3-4个维度预警
• ❌ 需重写：严重问题或5+维度预警

审查记录

审查结果汇总保存到 .learnings/审查记录.md，包含历史趋势追踪。

详见 assets/REVIEW-TEMPLATE.md。

第七步：记忆管理

写入时机

读取时机

每次生成新章节前必须读取所有记忆文件（含 题材配置.md），确保：

• 不会让已死角色复活
• 不会把"东城"写成"西城"
• 不会忘记上一章埋的伏笔
• 不会重复已有的情节桥段

第八步：关键情节图解

当出现以下场景时，生成对应的图解：

图解使用 Mermaid 语法嵌入 md 文件，或使用图像生成工具生成。

图解示例（Mermaid）

人物关系图：

graph TD
    A[主角·林凡] -->|师徒| B[师父·苍老人]
    A -->|宿敌| C[反派·赵天罡]
    A -->|暧昧| D[女主·苏婉儿]
    C -->|从属| E[赵家]
    D -->|出身| F[苏家]
    E -->|对立| F

等级体系图：

graph BT
    L1[炼气期] --> L2[筑基期]
    L2 --> L3[金丹期]
    L3 --> L4[元婴期]
    L4 --> L5[化神期]
    L5 --> L6[大乘期]
    style L2 fill:#f9f,stroke:#333

第九步：失败记录

生成失败或质量不达标时，记录到 .learnings/ERRORS.md。

常见失败场景

失败记录格式

## [NOVEL-ERR-YYYYMMDD-XXX] 失败类型

**记录时间**: ISO-8601
**章节**: 第XX章
**严重程度**: low | medium | high | critical

### 问题描述
具体发生了什么

### 影响范围
影响了哪些章节、角色、情节线

### 修正方案
如何修复，是否需要重写

### 预防措施
如何避免同类问题再次发生

输出规范

文件结构

output/
├── 提示词.md           # 完善后的创作提示词
├── 大纲.md             # 全局章节大纲
├── 第01章_[章名].md    # 各章节独立文件
├── 第02章_[章名].md
├── 第03章_[章名].md
├── ...
├── 人物关系图.md        # 关键图解
├── 势力分布图.md
└── 等级体系图.md

文件命名规范

• 章节文件：第XX章_章节名.md（XX 用两位数字，如 01、02）
• 图解文件：[图解类型].md
• 如果超过 99 章，使用三位数字：第XXX章_章节名.md

创作原则

通用小说核心要素

1. 强代入感 — 读者能轻松代入主角视角与处境
2. 快节奏 — 不拖泥带水，每章有进展
3. 层层递进 — 冲突与张力逐级升级，主角不断成长
4. 高光时刻 — 被低估 → 证明实力/反转 → 众人震惊，循环往复（爽文侧重打脸）
5. 设定合理 — 金手指/特殊能力有规则与限制，不是无限制开挂
6. 伏笔呼应 — 前文埋下的线索后文要收回来

> 不同题材的专项要素、套路与禁忌见 references/GENRES.md 登记索引；爽文专项详见 references/genre-shuangwen.md。

禁忌事项

• 不要连续两章以上没有情节推进或高光
• 不要让反派/对手过于脸谱化（衬托不出主角的强）
• 不要忘记已有角色（出场后人间蒸发）
• 不要突然修改已确立的设定
• 不要让主角无缘无故变弱（除非有合理剧情需要）

续写与中断恢复【新增】

长篇小说创作过程中经常会中断，需要能够从断点继续。

续写前必读文件

续写时必须按顺序读取以下文件：

1. output/大纲.md              → 确认全局走向
2. .learnings/章节规划_卷N.md   → 确认当前卷的任务规划
3. .learnings/CHARACTERS.md    → 所有角色当前状态
4. .learnings/LOCATIONS.md     → 已出现的地点
5. .learnings/PLOT_POINTS.md   → 已发生的关键情节 + 待回收伏笔
6. .learnings/STORY_BIBLE.md   → 世界观设定
7. .learnings/审查记录.md       → 最近的问题和预警【新增】
8. output/第(最新)章.md        → 上一章内容，确保衔接

续写流程

1. 检查当前进度
   - 已完成章节：检查 output/ 目录中的章节数量
   - 当前卷：根据章节号确定当前卷
   - 待回收伏笔：检查 PLOT_POINTS.md 中状态为"进行中"的条目

2. 确认下一章任务
   - 从章节规划中提取下一章的"核心任务"
   - 检查是否有近期需要回收的伏笔
   - 检查是否有消失过久的配角需要回归

3. 生成下一章
   - 按标准章节生成流程执行
   - 注意与上一章的衔接

续写检查清单

续写前自检：

• [ ] 已读取所有记忆文件
• [ ] 已确认当前章节号
• [ ] 已确认下一章核心任务
• [ ] 已检查待回收伏笔
• [ ] 已检查配角消失情况

常见续写场景

初始化新小说

有两种方式创建一部新小说的工作区（记忆与章节都放在当前小说项目根目录）：

方式一：由 Agent 直接初始化（推荐，跨平台）

在小说项目根目录下，让 Agent 创建 output/ 与 .learnings/ 目录，并按 assets/LEARNINGS-TEMPLATE.md 写入六类记忆文件模板头。无需任何外部脚本，Windows / macOS / Linux 通用。

方式二：使用初始化脚本（可选）

# 在当前目录初始化（默认项目根目录 = 当前目录）
./scripts/init-novel.sh 小说名称

# 指定项目目录
./scripts/init-novel.sh 小说名称 --project /path/to/my-novel

# 清空旧数据后重新开始
./scripts/init-novel.sh 小说名称 --clean

脚本会在指定的项目目录（缺省为当前目录）下创建：

• output/ 目录
• .learnings/ 目录及六类记忆文件（已存在则保留，仅 --clean 时重置）
• 提示你输入小说方向

> Windows 用户：脚本为 bash 编写，请用 Git Bash / WSL / MSYS2 运行；或直接采用方式一由 Agent 初始化。

详见 scripts/init-novel.sh。

导入已有小说（反向初始化 .learnings）

当已有成稿 / 半成品小说（非本技能生成亦可）需要接入本技能的 .learnings/ 记忆系统以续写或复盘时，执行本流程。本流程为纯 Agent 工作流，无需脚本，跨平台。

> 详细抽取规则、字段映射、批处理算法与边界情况见 assets/IMPORT-NOVEL.md。下文为六步主流程。

触发场景

• 用户已有小说正文，希望用本技能继续创作或管理记忆。
• 用户希望把一部已完成小说导入为本技能"项目"，获得角色 / 地点 / 情节档案与续写能力。

第 1 步：定位与确认项目结构

• 确认当前小说项目根目录下 output/ 与 .learnings/ 结构（见「启动初始化」）；缺失则按 assets/LEARNINGS-TEMPLATE.md 创建模板头。
• 若 .learnings/ 已非空 → 询问用户「合并」还是「覆盖重建」，避免误清既有记忆（详见 assets/IMPORT-NOVEL.md 第 1 节）。

第 2 步：扫描与排序

• 定位源目录：用户指定优先；未指定且 output/ 已有 第XX章_* 则默认从此导入；否则询问。支持 .md / .txt 散文（无 front-matter 亦可）。
• 扫描章节文件，按文件名章节号排序；无法识别时按内容时间线索或询问。输出有序文件清单（章节号、文件名、字数估算）交用户确认。

第 3 步：分批抽取与回填（防溢出）

• 按每批 10~15 章切分（超长可缩至 8~10 章）。
• 每批：读取正文 → 读取已有 CHARACTERS.md / LOCATIONS.md / PLOT_POINTS.md 做增量去重 → 从散文抽取角色 / 地点 / 情节伏笔 / 世界观规则 → 落盘追加更新对应 .learnings/ 文件 → 释放本批上下文。
• 跨批一致性通过"下批前读取已落盘记忆"维持，禁止全书同上下文。字段映射见 assets/IMPORT-NOVEL.md 第 4~5 节。

第 4 步：补全世界观与题材推断（需用户确认）

• 全书读完后，综合抽取结果与关键章节正文，补全 STORY_BIBLE.md。
• 依据内容推断主题材（都市 / 修仙 / 玄幻 / 科幻 / 悬疑 / 言情 / 历史 …），并参考 references/GENRES.md 给出建议启用的专项列表。
• 必须向用户展示推断结果并等待确认 / 调整；确认后按 assets/LEARNINGS-TEMPLATE.md 的「题材配置.md 模板」写入 .learnings/题材配置.md（启用列表 + 变更记录）。
• 此节点是导入流程的关键确认点，禁止在用户未确认前自动写入 题材配置.md。

第 5 步：复盘大纲与章节规划

• 生成 output/大纲.md：基于导入内容复盘主线走向、卷划分、关键转折点，标注「（导入复盘）」。
• 按卷生成 .learnings/章节规划_卷N.md：每卷章节分解、高潮节点、伏笔规划（埋设→回收映射，未回收标"待回收"），标注「（导入复盘）」。

第 6 步：一致性校验

• 执行穿帮检测（角色复活 / 地点矛盾 / 能力倒退 / 时间线）与伏笔遗漏扫描，汇总到 .learnings/审查记录.md，标注「（导入校验）」。
• 发现严重问题列出清单交用户决定是否修订。

完成后

项目已具备完整 .learnings/，可直接进入「续写与中断恢复」无缝继续创作。

与 self-improving-agent 的协作

本技能的 .learnings/ 系统参考了 self-improving-agent 的设计理念：

核心思想一致：捕获 → 记录 → 沉淀 → 复用。