xindoo/sumeru/sumeru-worldbuilder

网文创作世界构建师 (worldbuilder)

触发关键词

我想写小说、写一本网文、从零开始创作小说、帮我写本XX类型的小说、我要写本小说、给我整个小说创作流程、自动写小说、小说创作一站式服务、帮我完成一本小说、我只有创意怎么写小说、从零开始写网文、小说全流程创作

核心功能

worldbuilder 是网文创作的一站式主控技能，负责统筹协调从创意萌芽到作品完稿的完整创作链路，构建完整统一的故事世界。通过智能编排各专项技能的调用顺序与参数传递，实现自动化、流水线式的网文创作体验：

1. 可选前置·拆书：如果用户提供了参考书/对标作品，先调用 sumeru-deconstruct 输出结构模板与节奏参数（只拆结构，不抄文本）
2. 选题策划：调用 sumeru-topic 进行市场分析、选题定位，生成核心创意与卖点
3. 大纲设计：调用 sumeru-outline 构建完整世界观、人物设定、分卷大纲与完整章节细纲
4. 内容创作：调用 sumeru-write 按大纲进行分章节内容撰写，保持风格统一（必须完成所有章节后才进入下一阶段）
5. 逻辑审查：调用 sumeru-review 对所有已完成章节进行全面审查，校验时间线一致性、人物行为逻辑、前后剧情连贯性
6. 内容润色：调用 sumeru-polish 对所有已审查章节进行文笔优化、细节丰满、节奏调整
7. 完稿校验：调用 sumeru-finalize 对所有已润色章节完成错别字检查、标点规范、逻辑漏洞最终排查与作品打包

全局约束

两项全局硬约束统一定义在 AGENTS.md，本 Skill 不重复展开：

• 子Agent并行：每个子Agent最多负责 3 个章节（写作/审查/润色/校验/细纲均适用）
• 自动备份：review / polish 修改 chapters/ 前，必须备份到 .sumeru/write/original/

worldbuilder 的调度责任只有三条：

1. 调用子技能时显式传递“每Agent最多3章”参数
2. 在阶段检查点执行 AGENTS.md 定义的「阶段门禁规则」
3. 门禁未通过时阻断流程，不得“先往下走再说”

Skill 协调流程

worldbuilder 负责以下数据流转和协调工作：

用户需求
    ↓
[收集创作需求 → 保存到 .sumeru/session/requirements.json]
    ↓
[可选][sumeru-deconstruct] 拆书分析
    → 输入: 用户提供的参考书/章节目录
    → 输出: 拆书报告_*.md, .sumeru/deconstruct/structure.json
    → 门禁: derivative-check.json 的 passed=true
    ↓
[sumeru-topic] 选题策划
    → 输入: 可选复用拆书输出的结构模板与节奏参数（不含原作专名）
    → 输出: 选题策划报告.md, .sumeru/topic/options.json
    ↓
[sumeru-outline] 大纲设计（**生成完整章节细纲**）
    → 输入: .sumeru/topic/options.json (可选)
    → 输出: 小说大纲_*.md, .sumeru/outline/*.json（含 chapter-outlines.json）
    ↓
[阶段检查点 1] 检查大纲完整性，确认章节细纲已生成
    ↓
[sumeru-write] 章节撰写（**细纲驱动，并行批量生成，每个Agent最多3章**）
    → 输入: .sumeru/outline/chapter-outlines.json
    → 输出: chapters/*.md, .sumeru/write/*.json
    → ✅ **必须完成所有章节**（检查章节数与细纲一致）
    → ⚠️ **遵循全局3章/Agent约束**
    ↓
[阶段检查点 2] 验证所有章节已完成，记录写入进度
    ↓
[sumeru-review] 逻辑审查（**审查所有章节，自动修订大纲+重写严重问题章节，每个Agent最多3章**）
    → 输入: .sumeru/outline/*.json, chapters/*.md
    → 输出: 剧情审查报告.md, .sumeru/review/*.json（含 outline-revisions.json, bottom-line-checklist.json）
    → ✅ **必须完成全本审查+底线问题零遗漏核验**
    → 🔧 **严重问题自动修订大纲并重写章节，不再只生成 fix-plan.json 等待外部调用**
    → ⚠️ **遵循全局3章/Agent约束**
    ↓
[阶段检查点 3] 验证审查完成，确认底线问题已全部解决或标记「需人工干预」
    ↓
[review 已自动完成大纲修订+章节重写+轻量修复，直接修改了 chapters/（自动备份到 .sumeru/write/original/）]
    ↓
[sumeru-polish] 内容润色（**润色所有章节，每个Agent最多3章**）
    → 输入: chapters/*.md, .sumeru/review/*.json
    → 输出: chapters/*.md（润色后直接修改，自动备份到 .sumeru/write/original/）, .sumeru/polish/*.json
    → ✅ **必须完成全本润色**
    → 📝 **润色结果直接修改 chapters/，修改前自动备份到 .sumeru/write/original/**
    → ⚠️ **遵循全局3章/Agent约束**
    ↓
[阶段检查点 4] 验证润色完成
    ↓
[sumeru-finalize] 完稿校验（**处理所有章节，每个Agent最多3章**）
    → 输入: chapters/*.md（已包含review修复和polish润色后的内容）
    → 输出: publish/*, .sumeru/finalize/*
    → ⚠️ **遵循全局3章/Agent约束**

关键阶段检查点（可执行门禁）

每个阶段完成后更新 .sumeru/session/WORLDBUILDER_PROGRESS.json，重启时从上次未完成阶段继续。门禁不通过必须阻断，不允许带病下游：

阶段失败处理：门禁失败 → 记录到 WORLDBUILDER_PROGRESS.json 的 blocked_at → 只重跑失败阶段 → 重新过门禁。禁止跳过门禁直接进入下一阶段。

数据共享机制

所有 skill 通过 .sumeru/ 目录共享数据：

• session/ - 全局会话配置、用户需求、进度状态
• deconstruct/ - 拆书结构数据 → 供 topic、outline 参考（只传结构参数，不传专名）
• topic/ - 选题数据 → 供 outline 使用
• outline/ - 大纲数据 → 供 write、review 使用
• `chapter-outlines.json` - 完整章节细纲 → 供 write 进行并行批量生成
• write/ - 创作进度 → 供 review 使用
• review/ - 审查问题 → 供 write、polish 使用
• polish/ - 润色结果 → 供 finalize 使用
• finalize/ - 完稿数据

执行流程

flowchart LR
    A[接收创作需求] --> B[参数校验与初始化]
    B --> C[调用 topic 选题策划]
    C --> D[调用 outline 大纲设计]
    D --> E[调用 write 完整章节撰写]
    E -->|✅ 全部章节完成| F[调用 review 全本逻辑审查]
    F --> F1{review 发现严重问题?}
    F1 -->|是| F2[review 自动修订大纲+重写章节]
    F2 --> F3[直接修改 chapters/，自动备份到 .sumeru/write/original/]
    F3 --> G[调用 polish 全本内容润色]
    F1 -->|否| G
    G --> K{润色确认?}
    K -->|否| L[针对性调整润色]
    L --> G
    K -->|是| M[调用 finalize 完稿校验]
    M --> N[生成创作报告与作品文件]
    
    subgraph 进度保存
        O[WORLDBUILDER_PROGRESS.json]
        E -->|保存进度| O
        F -->|保存进度| O
        G -->|保存进度| O
        M -->|保存进度| O
    end

详细流程说明：

1. 初始化阶段：验证输入参数有效性，创建工作目录，初始化创作状态，创建 .sumeru/session/WORLDBUILDER_PROGRESS.json 进度文件
2. 需求收集阶段：智能判断用户提供的信息是否充足，如信息不足则自动触发交互式提问引导用户补充需求，确认所有需求后进入下一阶段
3. 选题阶段：基于收集到的完整需求生成3-5个精准匹配的选题方案供选择，确定后进入大纲设计，完成后更新进度文件
4. 大纲阶段：先输出世界观与人设，确认后生成完整大纲和所有章节细纲，完成后更新进度文件
5. 创作阶段：按细纲驱动批量创作所有章节，支持并行生成，必须完成所有章节后才进入下一阶段（遵循全局3章/Agent约束），完成后更新进度文件
6. 审查阶段：调用 sumeru-review 执行三阶段审查修复流程（遵循全局3章/Agent约束）：

• 第一阶段：全局审查：分析整体剧情脉络、时间线、设定一致性、冲突点分布、伏笔回收状态，执行底线问题扫描生成 bottom-line-checklist.json
• 第二阶段：章节细节审查：逐章检查字数、时间线、人物OOC、物品状态、场景质量、伏笔设置
• 第三阶段：统一修复：
• 合并全局和章节问题，按严重程度制定修复计划
• 执行轻量修复（文字修正、段落调整、字数填充等），直接修改 chapters/ 文件（自动备份到 .sumeru/write/original/）
• 对严重问题自动闭环修复：修订 .sumeru/outline/chapter-outlines.json 中受影响章节的细纲，然后基于修订后的细纲使用子Agent并行重写对应章节，直接修改 chapters/（自动备份到 .sumeru/write/original/），修订记录保存到 outline-revisions.json
• 执行底线问题零遗漏核验：六类底线问题（时间线矛盾、设定崩坏、人物OOC、重复情节、信息泄露、伏笔死结）必须全部解决或标记「需人工干预」
• 字数检查与填充：在第二阶段逐章统计字数，对不足的章节自动填充内容（强化场景描写、丰富对话、补充心理活动等）
• 自动修复所有问题：不只是提出问题，而是自动修复所有问题（轻量修复+大纲修订+章节重写）
• review 自动完成大纲修订和章节重写，不再需要 worldbuilder 额外调用 sumeru-write 进行重写
• 修复完成后重新验证，确保所有问题已解决
• 完成后更新进度文件

1. 润色阶段：调用 sumeru-polish 进行全本内容润色（遵循全局3章/Agent约束），提供多种润色风格选项（精简/详写/抒情/热血等）

• 润色完成后，直接修改 chapters/ 中的文件（修改前自动备份到 .sumeru/write/original/）
• 润色过程和结果记录到 .sumeru/polish/ 目录
• 完成后更新进度文件

1. 完稿阶段：调用 sumeru-finalize 对所有润色后的章节进行完稿校验（遵循全局3章/Agent约束），从 chapters/ 目录读取最终内容（已包含review修复和polish润色后的结果），输出多种格式（Markdown/HTML/EPUB）到 publish/ 目录，生成创作总结报告，完成后更新进度文件为最终完成状态

交互式需求引导

当用户提供的信息过于简略时（仅输入题材和少量关键词），系统会自动触发交互式提问，一步步引导用户明确创作需求，确保生成内容完全符合预期。

提问维度（按优先级）

基础信息确认（必问）

1. 🎯 题材确认：确认具体题材细分类型，如"玄幻" → "高武玄幻/修仙玄幻/异世玄幻/系统玄幻"
2. 📏 篇幅预期：确认目标字数/章节数，是短篇/中篇/长篇/超长篇
3. 🎯 核心爽点：用户最看重的爽点类型，如"打脸/升级/搞钱/恋爱/权谋"
4. 👥 受众定位：目标读者群体，男频/女频/全年龄，偏向什么年龄层

核心设定引导（可选，根据需求深度）

1. 🦸 主角设定偏好：主角性格（隐忍/张扬/腹黑/逗比）、身份（废柴/天才/穿越者/重生者）、金手指类型偏好
2. 🎭 反派设定偏好：反派类型（家族敌人/宗门对手/异族/天道）、反派强度
3. 🌍 世界观偏好：偏向什么世界观设定，是否有特别喜欢/讨厌的设定
4. 📖 参考作品：是否有类似风格的参考作品，可以更精准匹配风格

风格偏好设置（可选）

1. ✍️ 写作风格：偏好快节奏爽文/细腻精品文/幽默搞笑文/暗黑压抑文
2. 📱 发布平台：计划发布到哪个平台，适配对应平台的节奏和字数要求
3. ⚠️ 禁忌内容：明确不想要的情节、设定、人物类型

交互模式

• 详细引导模式：强制开启全量交互式提问，即使用户提供了充足信息也会完整走一遍需求确认流程
• 快速模式：仅提问最核心的3个问题（题材确认、篇幅、核心爽点），其他使用默认值
• 静默模式：关闭交互式提问，直接基于已有信息生成，适合明确知道自己需求的用户

需求确认机制

• 所有用户回答自动保存到 .sumeru/session/user-requirements.json，全流程各阶段共享使用
• 提问完成后生成需求确认摘要，用户确认无误后才开始正式创作
• 支持中途修改，用户可以随时调整之前的回答

引导示例

> /worldbuilder 玄幻 "废柴逆袭"
🤖 我来帮您完善创作需求，只需要回答几个简单问题：
1️⃣ 请问您想要的玄幻细分类型是？[高武玄幻/修仙玄幻/异世玄幻/系统玄幻/其他]
> 系统玄幻
2️⃣ 预期总篇幅大概多少字？[20万内/20-50万/50-100万/100万以上]
> 100万以上
3️⃣ 您最看重的核心爽点是？[打脸/升级/扮猪吃虎/收小弟/开后宫/其他]
> 打脸+扮猪吃虎
4️⃣ 主角性格偏好？[隐忍腹黑/张扬霸道/逗比搞笑/温柔沉稳/其他]
> 隐忍腹黑
5️⃣ 有没有特别喜欢的参考作品？比如类似《XX》的风格
> 类似「轻松吐槽+反差萌」的搞笑风格
...
 
✅ 需求收集完成，给您确认一下：
类型：系统玄幻
篇幅：100万字以上
核心爽点：打脸+扮猪吃虎
主角性格：隐忍腹黑
风格参考：轻松吐槽+反差萌
是否确认？[Y/n]
> Y
🚀 开始创作！

参数说明

创建时需要提供以下信息：

• 作品类型（必填）：如玄幻、都市、仙侠、科幻、言情、悬疑等
• 核心创意关键词（必填）：核心创意关键词，支持多个关键词用"+"连接，如"废柴逆袭+系统流+赘婿"

可选信息（不提供则使用默认值或自动生成）：

• 作品标题：如不提供则自动生成
• 预期篇幅：短篇（约20万字，40-70章）/中篇（20-50万字，70-170章）/长篇（50-100万字，170-340章）/超长篇（100万字以上，340章+），默认中篇；章节数按单章3000字由 plan-chapters.py 计算
• 写作风格：快节奏/均衡/详写/文艺，默认均衡
• 整体调性：幽默/严肃/励志/暗黑，默认中立
• 输出目录：作品输出目录路径，默认 ./output
• 中断恢复：传入上次的创作会话ID，可从断点恢复
• 跳过阶段：跳过指定阶段（deconstruct/topic/outline/write/review/polish/final），适用于续创或团队分工

使用示例

基础使用

# 最简单的调用方式，只指定类型和关键词
/worldbuilder 玄幻 "废柴逆袭+系统流"
 
# 都市言情作品，指定标题
/worldbuilder 言情 "霸道总裁+契约恋爱" 标题"总裁的契约新娘"
 
# 科幻悬疑，长篇幅，快节奏风格
/worldbuilder 科幻 "时间循环+密室解谜" 长篇 快节奏

进阶使用

# 指定详细参数的完整调用
/worldbuilder 仙侠 "重生+无敌流+宗门" 标题"重生之太上掌门" 长篇 详写风格 励志调性
 
# 从中断点恢复创作
/worldbuilder 玄幻 "废柴逆袭+系统流" 恢复上次创作
 
# 跳过选题阶段，直接从已有大纲继续创作
/worldbuilder 都市 "职场+重生" 跳过选题阶段

多风格组合

# 幽默风都市修仙
/worldbuilder 都市 "修仙+打工+搞笑" 均衡风格 幽默调性
 
# 暗黑系悬疑推理
/worldbuilder 悬疑 "连环杀人+心理侧写+反转" 详写风格 暗黑调性
 
# 热血励志竞技
/worldbuilder 竞技 "篮球+天赋+逆袭" 快节奏 励志调性

错误处理说明

常见错误类型与解决方案

错误恢复机制

• 自动重试：对于临时性网络错误，自动重试3次，间隔5秒
• 断点保存：每完成一个阶段自动保存状态，支持从中断点恢复
• 回滚选项：对不满意的阶段可选择回滚到上一节点重新开始
• 错误报告：生成详细的错误日志文件，位于 {output-dir}/error.log

进阶使用场景

场景1：团队协作创作

# 策划完成选题和大纲后，交由写手继续
/worldbuilder 玄幻 "废柴逆袭+系统流" 跳过写作、审查、润色、完稿阶段
 
# 写手接手，从创作阶段继续
/worldbuilder 玄幻 "废柴逆袭+系统流" 跳过选题、大纲阶段 恢复上次创作

场景2：多版本对比创作

# 生成多个版本进行对比
/worldbuilder 言情 "穿越+宫斗" 标题"深宫有雪" 文艺风格
/worldbuilder 言情 "穿越+宫斗" 标题"深宫有雪·疾风版" 快节奏

场景3：定制化系列作品

# 第一部
/worldbuilder 玄幻 "系统+升级" 标题"武帝降临" 中篇
 
# 第二部（沿用世界观）
/worldbuilder 玄幻 "系统+升级" 跳过选题、大纲阶段 恢复上次创作 标题"武帝降临2"

场景4：A/B测试优化

# 测试不同开篇风格
/worldbuilder 都市 "重生+商战" 跳过写作、审查、润色、完稿阶段
# 手动修改大纲中的开篇设定后继续
/worldbuilder 都市 "重生+商战" 跳过选题阶段 恢复上次创作

场景5：批量生成素材库

# 生成多个选题方案用于后续选择
/worldbuilder 玄幻 "废柴" 跳过大纲、写作、审查、润色、完稿阶段
/worldbuilder 玄幻 "系统" 跳过大纲、写作、审查、润色、完稿阶段
/worldbuilder 玄幻 "重生" 跳过大纲、写作、审查、润色、完稿阶段

数据持久化规范

所有中间状态数据统一存储在当前工作目录的 .sumeru/ 目录下，避免上下文压缩或清理导致数据丢失：

全局存储结构

目录规范统一见 AGENTS.md「数据持久化规范」，此处只列 worldbuilder 直接依赖的关键文件：

.sumeru/session/WORLDBUILDER_PROGRESS.json  # 阶段进度（断点恢复依据）
.sumeru/outline/chapter-outlines.json       # 细纲（write 的输入）
.sumeru/outline/compliance-check.json       # 命名合规门禁
.sumeru/write/original/                     # review/polish 修改前备份
.sumeru/review/bottom-line-checklist.json   # 底线问题闭环状态
.sumeru/finalize/stats.json                 # 完稿统计与导出结果

进度保存机制（WORLDBUILDER_PROGRESS.json，位于 .sumeru/session/）