sumeru-worldbuilder
网文/小说全流程创作世界构建师,适用于用户说"我想写小说"、"写一本网文"、"从零开始创作小说"、"帮我写本XX类型的小说"、"我要写本小说"、"给我整个小说创作流程"、"自动写小说"、"小说创作一站式服务"、"帮我完成一本小说"、"我只有创意怎么写小说"等整体小说写作需求,自动协调选题、大纲、写作、审查、润色全流程,即使你只有一个大概的创意也能帮你完成从0到1的完整作品,构建统一的故事世界,**所有章节级操作均使用子Agent并行处理,每个Agent最多负责3个章节**
By xindoo · 686 installs
npx skills add xindoo/sumeru --skill sumeru-worldbuilder
Source repository · Upstream listing
网文创作世界构建师 (worldbuilder)
触发关键词
我想写小说、写一本网文、从零开始创作小说、帮我写本XX类型的小说、我要写本小说、给我整个小说创作流程、自动写小说、小说创作一站式服务、帮我完成一本小说、我只有创意怎么写小说、从零开始写网文、小说全流程创作
核心功能
worldbuilder 是网文创作的一站式主控技能,负责统筹协调从创意萌芽到作品完稿的完整创作链路,构建完整统一的故事世界。通过智能编排各专项技能的调用顺序与参数传递,实现自动化、流水线式的网文创作体验:
1. 选题策划 :调用 sumeru topic 进行市场分析、选题定位,生成核心创意与卖点
2. 大纲设计 :调用 sumeru outline 构建完整世界观、人物设定、分卷大纲与 完整章节细纲
3. 内容创作 :调用 sumeru write 按大纲进行分章节内容撰写,保持风格统一( 必须完成所有章节后才进入下一阶段 )
4. 逻辑审查 :调用 sumeru review 对 所有已完成章节 进行全面审查,校验时间线一致性、人物行为逻辑、前后剧情连贯性
5. 内容润色 :调用 sumeru polish 对 所有已审查章节 进行文笔优化、细节丰满、节奏调整
6. 完稿校验 :调用 sumeru finalize 对 所有已润色章节 完成错别字检查、标点规范、逻辑漏洞最终排查与作品打包
⚠️ 全局约束:子Agent并行处理规则
worldbuilder 在协调所有涉及章节级操作的子技能时,强制执行 AGENTS.md 中定义的 子Agent并行处理规则 :
每个子Agent最多负责3个章节 (硬性约束,详见 AGENTS.md "子Agent并行处理规则")
此规则适用于以下所有阶段:
写作阶段 (sumeru write)
审查阶段 (sumeru review):审查和轻量修复
润色阶段 (sumeru polish)
完稿阶段 (sumeru finalize)
细纲生成 (sumeru outline)
设计原因 :详见 AGENTS.md "子Agent并行处理规则"
worldbuilder的调度责任 :
worldbuilder在调用各子技能时,必须确保子技能遵循3章/Agent的约束
如果子技能未自动遵守此约束,worldbuilder需要通过参数或指令强制执行
监控子技能的执行过程,确认Agent分配符合约束
Skill 协调流程
worldbuilder 负责以下数据流转和协调工作:
关键阶段检查点说明
每个阶段完成后都会自动更新 .sumeru/session/WORLDBUILDER PROGRESS.json ,任务重启时从上次未完成的阶段继续:
大纲阶段 :确认 chapter outlines.json 生成且包含完整章节列表
创作阶段 :检查 chapters/ 目录下已生成章节数与细纲一致
审查阶段 :确认 剧情审查报告.md 生成且包含全本审查结果。review 已自动完成大纲修订、章节重写和轻量修复(直接修改了 chapters/ ,修改前已自动备份到 .sumeru/write/original/ )。确认 bottom line checklist.json 中所有底线问题已标记为「已解决」或「需人工干预」
润色阶段 :确认润色已直接修改 chapters/ 中的文件。润色修改前已自动备份到 .sumeru/write/original/
完稿阶段 :确认 publish/ 目录下各平台格式导出完成
数据共享机制
所有 skill 通过 .sumeru/ 目录共享数据:
session/ 全局会话配置、用户需求、进度状态
topic/ 选题数据 → 供 outline 使用
outline/ 大纲数据 → 供 write、review 使用
chapter outlines.json 完整章节细纲 → 供 write 进行并行批量生成
write/ 创作进度 → 供 review 使用
review/ 审查问题 → 供 write、polish 使用
polish/ 润色结果 → 供 finalize 使用
finalize/ 完稿数据
执行流程
详细流程说明 :
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 进行重写
修复完成后重新验证,确保所有问题已解决
完成后更新进度文件
7. 润色阶段 :调用 sumeru polish 进行全本内容润色(遵循全局3章/Agent约束),提供多种润色风格选项(精简/详写/抒情/热血等)
润色完成后,直接修改 chapters/ 中的文件(修改前自动备份到 .sumeru/write/original/ )
润色过程和结果记录到 .sumeru/polish/ 目录
完成后更新进度文件
8. 完稿阶段 :调用 sumeru finalize 对所有润色后的章节进行完稿校验(遵循全局3章/Agent约束),从 chapters/ 目录读取最终内容(已包含review修复和polish润色后的结果),输出多种格式(Markdown/HTML/EPUB)到 publish/ 目录,生成创作总结报告,完成后更新进度文件为最终完成状态
交互式需求引导
当用户提供的信息过于简略时(仅输入题材和少量关键词),系统会自动触发交互式提问,一步步引导用户明确创作需求,确保生成内容完全符合预期。
提问维度(按优先级)
基础信息确认(必问)
1. 🎯 题材确认 :确认具体题材细分类型,如"玄幻" → "高武玄幻/修仙玄幻/异世玄幻/系统玄幻"
2. 📏 篇幅预期 :确认目标字数/章节数,是短篇/中篇/长篇/超长篇
3. 🎯 核心爽点 :用户最看重的爽点类型,如"打脸/升级/搞钱/恋爱/权谋"
4. 👥 受众定位 :目标读者群体,男频/女频/全年龄,偏向什么年龄层
核心设定引导(可选,根据需求深度)
5. 🦸 主角设定偏好 :主角性格(隐忍/张扬/腹黑/逗比)、身份(废柴/天才/穿越者/重生者)、金手指类型偏好
6. 🎭 反派设定偏好 :反派类型(家族敌人/宗门对手/异族/天道)、反派强度
7. 🌍 世界观偏好 :偏向什么世界观设定,是否有特别喜欢/讨厌的设定
8. 📖 参考作品 :是否有类似风格的参考作品,可以更精准匹配风格
风格偏好设置(可选)
9. ✍️ 写作风格 :偏好快节奏爽文/细腻精品文/幽默搞笑文/暗黑压抑文
10. 📱 发布平台 :计划发布到哪个平台,适配对应平台的节奏和字数要求
11. ⚠️ 禁忌内容 :明确不想要的情节、设定、人物类型
交互模式
详细引导模式 :强制开启全量交互式提问,即使用户提供了充足信息也会完整走一遍需求确认流程
快速模式 :仅提问最核心的3个问题(题材确认、篇幅、核心爽点),其他使用默认值
静默模式 :关闭交互式提问,直接基于已有信息生成,适合明确知道自己需求的用户
需求确认机制
所有用户回答自动保存到 .sumeru/session/user requirements.json ,全流程各阶段共享使用
提问完成后生成 需求确认摘要 ,用户确认无误后才开始正式创作
支持中途修改,用户可以随时调整之前的回答
引导示例
参数说明
创建时需要提供以下信息:
作品类型 (必填):如玄幻、都市、仙侠、科幻、言情、悬疑等
核心创意关键词 (必填):核心创意关键词,支持多个关键词用"+"连接,如"废柴逆袭+系统流+赘婿"
可选信息(不提供则使用默认值或自动生成):
作品标题 :如不提供则自动生成
预期篇幅 :短篇(20万字内)/中篇(20 50万字)/长篇(50 100万字)/超长篇(100万字以上),默认中篇
写作风格 :快节奏/均衡/详写/文艺,默认均衡
整体调性 :幽默/严肃/励志/暗黑,默认中立
输出目录 :作品输出目录路径,默认 ./output
中断恢复 :传入上次的创作会话ID,可从断点恢复
跳过阶段 :跳过指定阶段(topic/outline/write/review/polish/final),适用于续创或团队分工
使用示例
基础使用
进阶使用
多风格组合
错误处理说明
常见错误类型与解决方案
错误代码 错误信息 原因分析 解决方案
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:团队协作创作
场景2:多版本对比创作
场景3:定制化系列作品
场景4:A/B测试优化
场景5:批量生成素材库
数据持久化规范
所有中间状态数据统一存储在当前工作目录的 .sumeru/ 目录下,避免上下文压缩或清理导致数据丢失:
全局存储结构
进度保存机制(WORLDBUILDER PROGRESS.json,位于 .sumeru/session/)
数据生命周期管理
1. 自动保存 :每完成一个阶段自动将数据写入对应目录,支持幂等写入
2. 进度追踪 :每个阶段完成后自动更新 .sumeru/session/WORLDBUILDER PROGRESS.json ,记录阶段状态与完成时间
3. 版本控制 :关键节点自动生成版本快照,命名格式 {stage} {timestamp}.json
4. 断点恢复 :恢复创作时自动从 .sumeru/ 目录读取对应阶段数据
5. 清理规则 :支持清理所有中间数据,默认保留最近3个版本
6. 数据复用 :可直接引用其他项目的 .sumeru/ 目录数据,实现世界观/人设复用
高级配置:自定义阶段钩子(规划中)
⚠️ 该能力为规划中特性,当前版本暂未实现,仅作为扩展接口预留。
通过配置文件 {output dir}/hooks.json 可以在各阶段前后插入自定义处理: