Skill v1.0.1
currentAutomated scan100/100+3 new
name: sumeru-worldbuilder description: 网文/小说全流程创作世界构建师,适用于用户说"我想写小说"、"写一本网文"、"从零开始创作小说"、"帮我写本XX类型的小说"、"我要写本小说"、"给我整个小说创作流程"、"自动写小说"、"小说创作一站式服务"、"帮我完成一本小说"、"我只有创意怎么写小说"等整体小说写作需求,协调选题→大纲→写作→审查→润色→导出全流程,每阶段有可执行验收门禁,章节级操作使用子Agent并行(每Agent最多3章) type: skill metadata: version: "1.0.1"
网文创作世界构建师 (worldbuilder)
触发关键词
我想写小说、写一本网文、从零开始创作小说、帮我写本XX类型的小说、我要写本小说、给我整个小说创作流程、自动写小说、小说创作一站式服务、帮我完成一本小说、我只有创意怎么写小说、从零开始写网文、小说全流程创作
核心功能
worldbuilder 是网文创作的一站式主控技能,负责统筹协调从创意萌芽到作品完稿的完整创作链路,构建完整统一的故事世界。通过智能编排各专项技能的调用顺序与参数传递,实现自动化、流水线式的网文创作体验:
- 可选前置·拆书:如果用户提供了参考书/对标作品,先调用
sumeru-deconstruct输出结构模板与节奏参数(只拆结构,不抄文本) - 选题策划:调用
sumeru-topic进行市场分析、选题定位,生成核心创意与卖点 - 大纲设计:调用
sumeru-outline构建完整世界观、人物设定、分卷大纲与完整章节细纲 - 内容创作:调用
sumeru-write按大纲进行分章节内容撰写,保持风格统一(必须完成所有章节后才进入下一阶段) - 逻辑审查:调用
sumeru-review对所有已完成章节进行全面审查,校验时间线一致性、人物行为逻辑、前后剧情连贯性 - 内容润色:调用
sumeru-polish对所有已审查章节进行文笔优化、细节丰满、节奏调整 - 完稿校验:调用
sumeru-finalize对所有已润色章节完成错别字检查、标点规范、逻辑漏洞最终排查与作品打包
全局约束
两项全局硬约束统一定义在 AGENTS.md,本 Skill 不重复展开:
- 子Agent并行:每个子Agent最多负责 3 个章节(写作/审查/润色/校验/细纲均适用)
- 自动备份:review / polish 修改
chapters/前,必须备份到.sumeru/write/original/
worldbuilder 的调度责任只有三条:
- 调用子技能时显式传递“每Agent最多3章”参数
- 在阶段检查点执行 AGENTS.md 定义的「阶段门禁规则」
- 门禁未通过时阻断流程,不得“先往下走再说”
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,重启时从上次未完成阶段继续。门禁不通过必须阻断,不允许带病下游:
| 检查点 | 门禁条件 | 执行命令 | |
|---|---|---|---|
| 0. 拆书完成(可选) | 报告无原文复制、无原作专名 | check-derivative.py 退出码 0 | |
| 1. 大纲完成 | 细纲字段齐全、章节连续、分卷覆盖;命名合规 | plan-chapters.py --validate .sumeru/outline/chapter-outlines.json 且 compliance-check.json 的 passed=true | |
| 2. 创作完成 | 章节数=细纲数、命名规范、无空章 | check-chapters.py --chapters chapters --outline .sumeru/outline/chapter-outlines.json 无 error | |
| 3. 审查完成 | 全局/章节/修复三份产物齐全;底线清单无「待修复」 | 检查 .sumeru/review/bottom-line-checklist.json;fix-plan.json 无 pending | |
| 4. 润色完成 | 已直接改 chapters/,备份存在,无占位符 | 抽查 .sumeru/write/original/;build.py --check-only 无占位符 error | |
| 5. 完稿完成 | 全平台导出成功,无禁用名称 | build.py --platform all 退出码 0,publish/ 齐全 |
阶段失败处理:门禁失败 → 记录到 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 LRA[接收创作需求] --> 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 -->|否| GG --> K{润色确认?}K -->|否| L[针对性调整润色]L --> GK -->|是| M[调用 finalize 完稿校验]M --> N[生成创作报告与作品文件]subgraph 进度保存O[WORLDBUILDER_PROGRESS.json]E -->|保存进度| OF -->|保存进度| OG -->|保存进度| OM -->|保存进度| Oend
详细流程说明:
- 初始化阶段:验证输入参数有效性,创建工作目录,初始化创作状态,创建
.sumeru/session/WORLDBUILDER_PROGRESS.json进度文件 - 需求收集阶段:智能判断用户提供的信息是否充足,如信息不足则自动触发交互式提问引导用户补充需求,确认所有需求后进入下一阶段
- 选题阶段:基于收集到的完整需求生成3-5个精准匹配的选题方案供选择,确定后进入大纲设计,完成后更新进度文件
- 大纲阶段:先输出世界观与人设,确认后生成完整大纲和所有章节细纲,完成后更新进度文件
- 创作阶段:按细纲驱动批量创作所有章节,支持并行生成,必须完成所有章节后才进入下一阶段(遵循全局3章/Agent约束),完成后更新进度文件
- 审查阶段:调用
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 进行重写
- 修复完成后重新验证,确保所有问题已解决
- 完成后更新进度文件
- 润色阶段:调用
sumeru-polish进行全本内容润色(遵循全局3章/Agent约束),提供多种润色风格选项(精简/详写/抒情/热血等)
- 润色完成后,直接修改
chapters/中的文件(修改前自动备份到.sumeru/write/original/) - 润色过程和结果记录到
.sumeru/polish/目录 - 完成后更新进度文件
- 完稿阶段:调用
sumeru-finalize对所有润色后的章节进行完稿校验(遵循全局3章/Agent约束),从chapters/目录读取最终内容(已包含review修复和polish润色后的结果),输出多种格式(Markdown/HTML/EPUB)到publish/目录,生成创作总结报告,完成后更新进度文件为最终完成状态
交互式需求引导
当用户提供的信息过于简略时(仅输入题材和少量关键词),系统会自动触发交互式提问,一步步引导用户明确创作需求,确保生成内容完全符合预期。
提问维度(按优先级)
基础信息确认(必问)
- 🎯 题材确认:确认具体题材细分类型,如"玄幻" → "高武玄幻/修仙玄幻/异世玄幻/系统玄幻"
- 📏 篇幅预期:确认目标字数/章节数,是短篇/中篇/长篇/超长篇
- 🎯 核心爽点:用户最看重的爽点类型,如"打脸/升级/搞钱/恋爱/权谋"
- 👥 受众定位:目标读者群体,男频/女频/全年龄,偏向什么年龄层
核心设定引导(可选,根据需求深度)
- 🦸 主角设定偏好:主角性格(隐忍/张扬/腹黑/逗比)、身份(废柴/天才/穿越者/重生者)、金手指类型偏好
- 🎭 反派设定偏好:反派类型(家族敌人/宗门对手/异族/天道)、反派强度
- 🌍 世界观偏好:偏向什么世界观设定,是否有特别喜欢/讨厌的设定
- 📖 参考作品:是否有类似风格的参考作品,可以更精准匹配风格
风格偏好设置(可选)
- ✍️ 写作风格:偏好快节奏爽文/细腻精品文/幽默搞笑文/暗黑压抑文
- 📱 发布平台:计划发布到哪个平台,适配对应平台的节奏和字数要求
- ⚠️ 禁忌内容:明确不想要的情节、设定、人物类型
交互模式
- 详细引导模式:强制开启全量交互式提问,即使用户提供了充足信息也会完整走一遍需求确认流程
- 快速模式:仅提问最核心的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 竞技 "篮球+天赋+逆袭" 快节奏 励志调性
错误处理说明
常见错误类型与解决方案
| 错误代码 | 错误信息 | 原因分析 | 解决方案 | |
|---|---|---|---|---|
INVALID_GENRE | 不支持的作品类型 | 传入的 genre 参数不在支持列表中 | 检查类型拼写,支持的类型:玄幻、都市、仙侠、科幻、言情、悬疑、历史、游戏、竞技、军事、武侠、轻小说 | |
KEYWORDS_TOO_LONG | 关键词过长 | keywords 参数超过100字符限制 | 精简关键词,保留最核心的3-5个 | |
DEPENDENCY_MISSING | 缺少依赖技能 | 未安装所需的子技能(topic等) | 运行 /find-skills 查找并安装所有依赖技能 | |
OUTPUT_DIR_PERMISSION | 输出目录无权限 | 指定的 output-dir 无写入权限 | 更换有权限的目录,或使用默认目录 | |
INVALID_SESSION_ID | 无效的会话ID | resume 参数传入的会话ID不存在 | 检查会话ID是否正确,或重新开始创作 | |
STAGE_SKIP_CONFLICT | 阶段跳过冲突 | 跳过的阶段与后续阶段有依赖关系 | 移除对前置阶段的跳过,或提供必要的前置文件 | |
CONTENT_GENERATION_FAILED | 内容生成失败 | 创作过程中遇到内容审核或模型限制 | 调整关键词或风格参数,或分阶段手动确认 |
错误恢复机制
- 自动重试:对于临时性网络错误,自动重试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/)
{"session_id": "session-20240315-abc123","created_at": "2024-03-15T10:00:00","updated_at": "2024-03-15T14:30:00","current_stage": "review","stages": {"topic": {"status": "completed","completed_at": "2024-03-15T10:15:00","output_files": ["选题策划报告.md",".sumeru/topic/options.json"]},"outline": {"status": "completed","completed_at": "2024-03-15T11:20:00","output_files": ["小说大纲_玄幻系统流.md",".sumeru/outline/chapter-outlines.json"]},"write": {"status": "completed","completed_at": "2024-03-15T13:45:00","output_files": ["chapters/001-废物觉醒系统.md","chapters/002-系统签到奖励.md",".sumeru/write/progress.json"],"statistics": {"total_chapters": 100,"completed_chapters": 100,"total_words": 520000}},"review": {"status": "completed","completed_at": "2024-03-15T14:45:00","output_files": ["剧情审查报告.md",".sumeru/review/issues.json",".sumeru/review/fix-plan.json",".sumeru/review/outline-revisions.json",".sumeru/review/bottom-line-checklist.json"],"statistics": {"total_issues_found": 8,"critical_issues": 2,"issues_fixed_lightweight": 4,"issues_fixed_rewrite": 2,"outline_revisions": 1,"bottom_line_resolved": 2,"bottom_line_manual": 0},"outline_revised": true,"chapters_rewritten": true,"bottom_line_all_resolved": true},"polish": {"status": "in_progress","started_at": "2024-03-15T15:00:00","progress": "60%","polish_level": "moderate","style": "小白爽文"},"finalize": {"status": "pending"}}}
数据生命周期管理
- 自动保存:每完成一个阶段自动将数据写入对应目录,支持幂等写入
- 进度追踪:每个阶段完成后自动更新
.sumeru/session/WORLDBUILDER_PROGRESS.json,记录阶段状态与完成时间 - 版本控制:关键节点自动生成版本快照,命名格式
{stage}-{timestamp}.json - 断点恢复:恢复创作时自动从
.sumeru/目录读取对应阶段数据 - 清理规则:支持清理所有中间数据,默认保留最近3个版本
- 数据复用:可直接引用其他项目的
.sumeru/目录数据,实现世界观/人设复用
高级配置:自定义阶段钩子(规划中)
⚠️ 规划中特性,当前版本未实现。预留接口:{output-dir}/hooks.json,支持before_topic/after_outline/before_write/after_final挂载自定义脚本。