# sumeru-skill

**Repository Path**: shifeipython/sumeru-skill

## Basic Information

- **Project Name**: sumeru-skill
- **Description**: No description available
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-08
- **Last Updated**: 2026-07-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 须弥写作 (Sumeru Writing)

专门用于网文创作的AI Agent技能集合，适配Claude Code、OpenCode等AI编程工具，通过Vibe Coding的方式一站式完成从创意到完稿的全流程小说写作。

> 🎯 **定位**: 网文作者的AI创作副驾驶，覆盖选题→大纲→写作→审稿→润色→导出全流程，让创作更高效。

## ✨ 核心特性

- **全流程覆盖**: 从选题策划到多平台导出，覆盖网文创作所有核心环节
- **模块化架构**: 7个独立Skill模块，可单独调用也可全流程自动编排
- **Vibe Coding**: 自然语言指令驱动，无需学习复杂操作
- **市场导向**: 基于主流平台榜单数据分析，提供选题可行性评估
- **逻辑自洽**: 自动校验时间线、剧情一致性、人物OOC等问题
- **风格适配**: 支持小白爽文、精品文、古风、都市等多种写作风格
- **多平台兼容**: 导出适配起点、番茄、晋江、纵横等主流平台格式
- **断点续传**: 所有创作数据自动持久化，支持中断后恢复进度

## 🏗️ 系统架构

须弥写作采用模块化Skill架构，各模块独立工作又可协同编排：

```
skills/
├── sumeru-worldbuilder/  # 世界构建师Skill，统筹全流程创作，负责整个故事世界的搭建与落地
├── sumeru-topic/         # 选题策划Skill，市场分析+创意生成
├── sumeru-outline/       # 大纲设计Skill，世界观+人设+剧情框架
├── sumeru-write/         # 章节撰写Skill，单章/批量创作+续写
├── sumeru-review/        # 逻辑审查Skill，时间线+剧情+人物一致性校验
├── sumeru-polish/        # 内容润色Skill，文笔优化+节奏调整+风格统一
└── sumeru-finalize/      # 完稿校验Skill，合规检查+多平台格式导出
```

## 🚀 安装方式

在Claude Code / OpenCode项目中执行：
```bash
npx skills add xindoo/sumeru
```

## 📖 快速开始

### 全流程创作（推荐）
直接启动完整创作流程，系统会自动引导你完成所有环节，自动协调选题→大纲→写作→审查→润色→导出全流程：
```bash
/sumeru-worldbuilder <题材类型> "<核心创意关键词>"
```

**可选参数说明：**
| 参数 | 说明 | 示例 |
|------|------|------|
| 标题 | 自定义小说名称 | 标题"重生之互联网大亨" |
| 篇幅 | 预期篇幅 | 长篇/中篇/短篇 |
| 风格 | 写作风格 | 小白爽文/精品文/古风 |
| 调性 | 整体调性 | 轻松/严肃/搞笑 |
| 恢复 | 中断后恢复创作 | 恢复上次创作 |
| 跳过 | 跳过指定环节 | 跳过审查、润色 |

**示例：**
```bash
# 基础用法
/sumeru-worldbuilder 玄幻 "废柴逆袭+系统流+穿越"
/sumeru-worldbuilder 都市 "重生+投资+创业"
/sumeru-worldbuilder 言情 "霸道总裁+契约恋爱" 标题"总裁的契约新娘"

# 带参数的完整用法
/sumeru-worldbuilder 都市 "重生2000年+互联网创业+商战" 标题"重生之网络帝国" 长篇 精品文
/sumeru-worldbuilder 科幻 "星际冒险+机甲+无限流" 长篇 快节奏

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

# 中断恢复与阶段跳过
/sumeru-worldbuilder 科幻 "星际冒险+机甲+无限流" 恢复上次创作 跳过选题  # 恢复之前的科幻题材创作，跳过选题环节
/sumeru-worldbuilder 都市 "职场+重生" 跳过选题阶段                    # 跳过选题，直接从已有大纲继续

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

### 独立功能调用
你也可以单独调用任意环节的Skill，灵活组合使用：

---

#### 1. 选题策划 Skill
**适用场景**：不知道写什么、想找热门题材、需要市场可行性分析
**功能**：基于主流平台榜单数据分析，生成3-5套差异化选题方案，包含金手指设计、核心卖点、爽点模式，以及市场热度、竞争格局、变现潜力等多维度评估。

```bash
/sumeru-topic <题材类型> "<核心关键词>"
```

**可选参数说明：**
| 参数 | 说明 | 示例 |
|------|------|------|
| 平台 | 目标发布平台 | 起点/番茄/晋江/纵横 |
| 受众 | 目标受众 | 男频/女频/中性 |
| 篇幅 | 预期篇幅 | 长篇/中篇/短篇 |

**示例：**
```bash
# 基础用法
/sumeru-topic 玄幻 "系统+签到+无敌" 起点平台
/sumeru-topic 言情 "穿越+宫斗+甜宠" 女频 中篇

# 指定平台和受众
/sumeru-topic 都市 "异能+鉴宝+赘婿" 番茄平台 男频         # 生成番茄男频都市异能选题
/sumeru-topic 悬疑 "无限流+密室逃脱+灵异" 中性向 中篇     # 生成中性向悬疑中篇选题

# 复用已有数据
/sumeru-topic 加载已有选题    # 加载之前生成的选题，继续优化
```

---

#### 2. 大纲设计 Skill
**适用场景**：写小说大纲、设计人设、做世界观设定、生成章节细纲
**功能**：生成完整世界观、人物设定卡、剧情框架、爽点排布规划，**自动生成完整章节细纲**（chapter-outlines.json），自动合规检查避免侵权风险。大批量细纲生成时使用子Agent并行处理。

```bash
/sumeru-outline "<核心创意描述>"
```

**可选参数说明：**
| 参数 | 说明 | 示例 |
|------|------|------|
| 复用数据 | 复用已有选题数据 | 复用已有选题数据 |
| 允许映射 | 允许映射真实地名/事件（需自行合规审核） | 允许映射真实地名 |
| 大纲风格 | 大纲风格 | 详细/精简/分卷 |

**示例：**
```bash
# 基础用法
/sumeru-outline "重生2000年靠互联网创业"
/sumeru-outline 复用已有选题数据  # 复用选题阶段生成的创意

# 指定大纲风格
/sumeru-outline "高武世界+校花+系统+高考逆袭" 分卷式大纲   # 生成分卷式大纲
/sumeru-outline "古代权谋+皇子夺嫡+穿越" 允许映射真实地名  # 允许映射真实历史背景

# 复用已有数据继续完善
/sumeru-outline "星际文明+机甲战斗+虫族入侵" 复用已有大纲草稿  # 复用之前的大纲草稿继续完善
```

> 💡 **细纲驱动**：大纲设计完成后自动生成 `chapter-outlines.json`，供 `sumeru-write` 进行细纲驱动的并行批量创作。

---

#### 3. 章节撰写 Skill
**适用场景**：生成章节内容、续写、重写、批量创作
**功能**：**细纲驱动生成**，自动读取 `chapter-outlines.json`，支持单章或批量并行生成所有章节。遵循网文黄金节奏结构，保持人物性格与剧情一致性，**批量生成时自动使用子Agent并行处理，每个Agent最多负责3个章节**。

```bash
/sumeru-write <章节号> "<章节概要>"
```

**可选参数说明：**
| 参数 | 说明 | 示例 |
|------|------|------|
| 风格 | 写作风格 | 仙侠/都市/古风 |
| 字数 | 目标字数 | 2000/3000字 |
| 节奏 | 节奏控制 | 快/中/慢 |
| 视角 | 视角 | 主角/配角/上帝视角 |
| 续写 | 续写已有内容 | 续写 |
| 按细纲生成 | 基于已有细纲生成 | 按细纲生成 |
| 强化爽点 | 强化爽点/打脸情节 | 强化爽点 |

**示例：**
```bash
# 细纲驱动批量生成（推荐）
/sumeru-write 全部章节                           # 从细纲生成所有章节（自动并行）
/sumeru-write 第1-50章                            # 生成指定范围章节
/sumeru-write 第1卷                               # 生成特定卷的所有章节
/sumeru-write 第3章,第5章,第10章                   # 生成特定章节

# 单章创作
/sumeru-write 第3章 "主角首次使用金手指震惊众人" 仙侠风格 强化爽点 2500字
/sumeru-write 第3章 按细纲生成                     # 基于已有细纲生成

# 续写与重写
/sumeru-write 第5章 续写                           # 续写第4章之后的内容

# 批量并行创作
/sumeru-write 第1-100章 批量并行                   # 并行批量生成100章内容

# 更多实用场景
/sumeru-write 第1章 "主角重生回到高考前一天" 都市风格 快节奏 2000字  # 快节奏开篇
/sumeru-write 第20-30章 女配视角 古风             # 从女配视角写10章内容
/sumeru-write 第15章 "拍卖会冲突" 强化爽点 3000字   # 强化打脸爽点的章节
```

> 💡 **并行约束**：批量生成时每个子Agent最多负责3个章节，所需Agent数 = ceil(总章节数 / 3)，自动分配。

---

#### 4. 逻辑审查 Skill
**适用场景**：检查剧情bug、时间线错误、人物OOC、逻辑漏洞、字数不足
**功能**：**三阶段审查修复流程**——全局审查→章节细节审查（子Agent并行，每个Agent最多3章）→统一修复。自动发现剧情矛盾和不合理之处，**自动修复所有轻量级问题**（修复结果直接修改 chapters/ 目录，修改前自动备份），对需要重写的章节生成修复计划。

```bash
/sumeru-review <章节范围>
```

**三阶段审查流程：**
1. **全局审查**：分析整体剧情脉络、时间线、设定一致性、冲突点分布、伏笔回收状态
2. **章节细节审查**：逐章检查字数、时间线、人物OOC、物品状态、场景质量、伏笔设置（子Agent并行）
3. **统一修复**：合并问题按严重程度排序 → 轻量修复直接修改 chapters/ → 需重写章节生成 fix-plan.json

**支持检查的问题类型：**
- 字数检查：章节字数达标检查，不足自动填充
- 时间线：时间线/年龄/事件顺序一致性
- 人物OOC：人物性格/行为OOC检查
- 剧情逻辑：剧情逻辑/设定一致性
- 伏笔：伏笔回收检查
- 常识：常识/因果合理性检查

**示例：**
```bash
# 基础用法
/sumeru-review 第1-50章
/sumeru-review 审查全部内容
/sumeru-review 第1-20章 仅检查时间线和人物OOC

# 指定检查类型
/sumeru-review 第30-80章 仅检查剧情和伏笔  # 检查剧情矛盾和伏笔回收情况
/sumeru-review 第10-15章 仅检查常识         # 检查这几章的常识/逻辑合理性
/sumeru-review 第1-30章 仅检查字数           # 检查章节字数是否达标
```

> 💡 **自动修复**：审查后自动修复所有轻量级问题（文字修正、段落调整、字数填充等），结果直接修改 `chapters/` 目录，修改前自动备份到 `.sumeru/write/original/`。需要重写的章节记录到 `fix-plan.json`，由 worldbuilder 编排或用户手动调用 `sumeru-write` 处理。

---

#### 5. 内容润色 Skill
**适用场景**：优化文笔、调整节奏、强化爽点、统一风格
**功能**：3级润色级别，专注文笔与内容层面优化，支持多风格转换，针对性优化节奏、爽点、对话、悬念等，**润色结果直接修改 chapters/ 目录，修改前自动备份到 .sumeru/write/original/**，**批量润色时使用子Agent并行处理，每个Agent最多负责3个章节**。

```bash
/sumeru-polish <章节范围>
```

**润色级别说明：**
- 轻度：优化句式表达，去除冗余表述，精炼用词，提升文字流畅度（保留80%以上原文风格）
- 中度：重构段落结构，优化叙事视角，全面提升文笔质感（保留60%原文核心表达）
- 深度：逐字打磨，雕琢细节，追求最佳阅读体验（保留核心情节脉络）

**可选参数说明：**
| 参数 | 说明 | 示例 |
|------|------|------|
| 润色级别 | 润色级别 | 轻度/中度/深度 |
| 目标风格 | 目标风格 | 小白爽文/精品文/古风/都市现实/悬疑/科幻 |
| 优化重点 | 优化重点 | 爽点强化、节奏收紧、对话优化、文笔提升、悬念增强 |

**示例：**
```bash
# 基础用法
/sumeru-polish 第10章 中度润色 小白爽文风格 强化爽点
/sumeru-polish 第1-3章 轻度润色  # 轻度润色，优化表达流畅度
/sumeru-polish 第5章 深度润色 节奏收紧+对话优化

# 更多实用场景
/sumeru-polish 第1-20章 古风风格 文笔提升       # 将前20章转为古风风格，提升文笔
/sumeru-polish 第35章 深度润色 悬念增强+爽点强化  # 深度优化章节悬念和爽点
/sumeru-polish 第1-100章 轻度润色               # 全本轻度润色，优化文字流畅度
```

---

#### 6. 完稿校验 Skill
**适用场景**：完稿检查、敏感词检测、多平台格式导出
**功能**：错别字/标点/语法错误修正，三级敏感内容检测与修正建议，格式标准化，多平台格式导出，批量替换与自动分段，**批量处理时使用子Agent并行校验，每个Agent最多负责3个章节**。

> 💡 **Skill 边界**：技术性文字校验（错别字/标点/语法）由本Skill负责，`sumeru-polish` 专注文笔和内容层面优化，两者互补不重叠。

```bash
/sumeru-finalize
```

**可选参数说明：**
| 参数 | 说明 | 示例 |
|------|------|------|
| 导出平台 | 导出平台格式 | 起点/番茄/晋江/纵横/17k/全平台 |
| 批量替换 | 启用全局替换功能 | 替换"旧词"为"新词" |
| 自动分段 | 自动分段优化（适配手机阅读） | 自动分段 |

**支持导出的平台：**
- 起点：起点中文网格式
- 番茄：番茄小说格式
- 晋江：晋江文学城格式
- 纵横：纵横中文网格式
- 17k：17K小说网格式
- 全平台：导出全部平台格式

**示例：**
```bash
# 基础用法
/sumeru-finalize 导出起点格式
/sumeru-finalize 导出全平台格式
/sumeru-finalize 批量替换+自动分段

# 更多实用场景
/sumeru-finalize 导出番茄格式 自动分段                      # 导出番茄格式，自动分段
/sumeru-finalize 替换"张三"为"李玄" 替换"李四"为"王虎"       # 批量替换全文角色名称
/sumeru-finalize 导出全平台格式                              # 导出全平台格式
```

## 💾 数据持久化

### 数据存储规范
- **中间数据**：仅系统内部使用的临时数据、元数据、进度信息等，统一存储在 `.sumeru/` 目录下，支持断点恢复与数据复用，用户无需关心
- **用户可见输出**：所有最终成果直接保存在当前工作目录下，用户可直接查看和使用

#### 中间数据目录（.sumeru/）
```
.sumeru/
├── session/          # 会话全局配置与状态
├── topic/            # 选题阶段中间数据
├── outline/          # 大纲阶段中间数据
│   └── chapter-outlines.json  # 完整章节细纲（供 write 阶段并行生成使用）
├── write/            # 创作阶段中间数据
│   └── original/     # 原始章节备份（review/polish修改前自动备份）
├── review/           # 审查阶段中间数据
│   └── fix-plan.json # 重写修复计划（标记需要重写的章节）
├── polish/           # 润色阶段中间数据
└── finalize/         # 完稿阶段中间数据
```

#### 用户可见输出（当前工作目录）
```
./
├── 选题策划报告.md    # 选题策划阶段最终成果
├── 小说大纲_*.md      # 大纲设计阶段最终成果
├── chapters/         # 章节内容文件
├── 剧情审查报告.md    # 逻辑审查阶段最终成果
├── publish/          # 完稿导出的各平台格式文件
└── output/           # 全流程创作的最终输出目录
```

所有创作过程支持断点恢复，中断后无需重头开始。

## 🎨 核心优势

### 合规安全
- 自动生成虚构的人名、地名、势力名，避免侵权风险
- 三级敏感词检测与修正建议，降低发布风险
- 符合各大平台内容规范要求

### 效率提升
- 多Agent并行创作，效率提升5倍以上
- 智能爽点排布，遵循网文创作黄金节奏公式
- 自动追踪伏笔，提醒回收时机

### 质量保障
- 人物性格与剧情逻辑一致性校验
- 时间线与世界设定合理性检查
- 多轮润色优化，兼顾文笔与节奏

## 🤝 参与贡献

欢迎提交Issue和PR来完善须弥写作！
- 新增Skill需遵循现有架构规范
- 所有新增功能需包含对应的测试用例
- 提交前请确保通过所有现有测试

## 📄 许可证

MIT License

---

**让AI成为你的创作伙伴，释放想象力，专注故事本身 ✍️**