12Agent小说写作技能

中文小说写作技能包。12个专业Agent协作，覆盖项目初始化、世界观构建、角色设计、大纲规划、章节写作、审核迭代全流程。

openclaw skills install 12agent-novel

{}

{}

{}

{
  "latest": "1.0.0"
}

name: 12agent-novel version: 1.0.0 description: "中文小说写作技能包。12个专业Agent协作，覆盖项目初始化、世界观构建、角色设计、大纲规划、章节写作、审核迭代全流程。" triggers:

• 写小说
• 新建小说项目
• 创建小说
• 开始创作

12Agent 小说写作技能

Quick Reference

核心铁律（优先级降序）

生命周期

Phase 0 ──► Phase 1 ──► Phase 2 ──► Phase 3
  │           │           │           │
初始化     前期架构     章节写作    维护迭代

🤖 模型选择指南

Agent → 模型映射（默认）

模型特点

📋 Agent 职责

🎯 主控协调机制

调度流程

用户指令 → Coordinator 分析 → 分发任务 → 收集结果 → 整合输出

Agent 调用格式

// Phase 1 架构类 Agent
sessions_spawn({
  task: "[CONTEXT]\n世界观文档已生成。\n\n[TASK] 基于世界观构建角色体系...",
  model: "vectorengine/claude-opus-4-6",
  label: "👤 CharacterDesigner [Opus]"
})

// Phase 2 主笔 Agent
sessions_spawn({
  task: "[CONTEXT]\n风格锚定文档、世界观摘要、角色圣经摘要...\n\n[TASK] 撰写第X章初稿并润色...",
  model: "moonshot/kimi-k2.5",
  label: "✍️ MainWriter [Kimi]"
})

// Phase 2 OOC 检查
sessions_spawn({
  task: "[CONTEXT]\n滚动摘要、最近N章、本章内容...\n\n[TASK] 一致性检查...",
  model: "qwen/qwen3-max",
  label: "🛡️ OOCGuardian [Qwen]"
})

标签格式

{Emoji} Agent名称 [模型简称]

示例：
👤 CharacterDesigner [Opus]
✍️ MainWriter [Kimi]
🛡️ OOCGuardian [Qwen]
⚔️ BattleAgent [Gemini]
🔎 FinalReviewer [Opus]

⚡ 交互模式

激活时 - 宣布计划

🎯 12Agent 小说写作已启动

📋 当前任务：构建世界观
👤 世界观架构师（Opus）— 设计世界框架、力量体系
👤 角色设计师（Opus）— 创建角色圣经

⏳ 正在派出 Agent 小队...

执行后 - 输出统计卡片

## 📊 执行统计

| Agent | Emoji | 模型 | 状态 |
|-------|-------|------|------|
| 🏰 Worldbuilder | 架构师 | Opus | ✅ |
| 👤 CharacterDesigner | 设计师 | Opus | ✅ |

总耗时：~45s（2 Agent 并行）节省约 60%

Phase 0：项目初始化

触发： "新建小说" / "新项目"

流程

Step 0-1: 收集核心设定
Step 0-2: 创建项目目录
Step 0-3: 初始化元数据
Step 0-4: 读取 openclaw.json 获取可用模型
Step 0-5: 用户选择 Agent 与模型映射
Step 0-6: 确认配置，进入 Phase 1

Step 0-1 ~ 0-3：核心设定与目录

1. 宣布启动
2. 收集核心设定（标题、类型、基调、主角描述等）
3. 创建项目目录结构
4. 初始化元数据文件
5. 确认用户授权边界（R18/BE等）

Step 0-4：读取 openclaw.json

主控自动执行：

1. 读取 ~/.openclaw/openclaw.json（实时获取当前配置）
2. 从 models.providers 提取可用模型
3. 解析 provider/model-id 格式
4. 向用户展示读取到的真实可用模型（不是硬编码！）

Step 0-5：用户选择 Agent 与模型映射

⚠️ 此步骤必须等待用户输入，不能自动跳过！

主控向用户展示选择界面：

## 🤖 Agent 模型配置

请为各 Agent 选择模型（输入序号）：

| Agent | Emoji | 推荐模型 | 你的选择 |
|-------|-------|----------|----------|
| 主控协调 | 🎯 | MiniMax-M2.7 | [  ] |
| 世界观构建 | 🏰 | claude-opus-4-6 | [  ] |
| 角色设计 | 👤 | claude-opus-4-6 | [  ] |
| 大纲规划 | 📋 | claude-opus-4-6 | [  ] |
| 章节细纲 | 📖 | kimi-k2.5 | [  ] |
| 主笔写作 | ✍️ | kimi-k2.5 | [  ] |
| OOC守护 | 🛡️ | qwen3-max | [  ] |
| 战斗写作 | ⚔️ | gemini-3.1-pro-preview | [  ] |
| 终稿审核 | 🔎 | claude-opus-4-6 | [  ] |
| 读者模拟 | 📚 | qwen3-max | [  ] |
| 风格锚定 | 🎨 | claude-opus-4-6 | [  ] |
| 滚动摘要 | 📝 | qwen3-max | [  ] |

输入序号进行选择（如 "1,2,2,2,3,3,4,5,2,4,2,4"）
或输入"默认"使用推荐配置。

等待用户回复后再继续。

Step 0-6：确认配置

✅ 项目目录已创建
✅ 元数据文件已初始化
✅ Agent模型映射已配置

项目路径：projects/<项目名>/
确认路径正确后，进入 Phase 1。

输出

项目根目录：projects/<项目名>/
项目路径必须统一，后续所有操作都在此路径下进行！

projects/<项目名>/
├── meta/           # 元数据
├── worldbuilding/  # 世界观
├── characters/     # 角色
├── outline/        # 大纲
├── chapters/       # 章节
├── archive/        # 归档
└── references/     # 追踪表

config/agent_choice.md  # 由 Step 0-5 自动生成

---

## Phase 1：前期架构

**触发：** "世界观" / "角色" / "大纲"

### 流程

| Step | Agent/执行者 | Emoji | 模型 | 输出 |
|------|-------------|-------|------|------|
| 1 | Worldbuilder | 🏰 | Opus | 世界观文档 |
| 2 | CharacterDesigner | 👤 | Opus | 角色圣经 |
| 3 | OutlinePlanner | 📋 | Opus | 全书大纲 |
| 4 | ChapterOutliner | 📖 | Kimi | 章节细纲（每批10章） |
| 5 | FinalReviewer | 🔎 | Opus | 全局一致性终审报告 |
| 6 | 主控（自动） | 🎯 | — | 提取关键章节配置 |
| 7 | StyleAnchorGenerator | 🎨 | Opus | 风格锚定文档v1.0 |
| 8 | 主控（自动） | 🎯 | — | 整合终审定稿，架构v1.0 |
| 9 | 主控（自动） | 🎯 | — | 汇报，进入Phase 2 |

### 章节细纲批次规则

- 单批次最多 **10章**
- 第一批次：Ch1-10（第一幕主体）
- 第二批次：Ch11-20（第一幕结尾 + 第二幕开头）
- 每批次完成后需确认再继续

---

## Phase 2：章节写作

**触发：** "写第X章"

### 双轨制

| 类型 | 条件 | 流程 | 子Agent调用 |
|------|------|------|------------|
| 常规章节 | 非重点章 | 🎯主控规划 → ✍️MainWriter → [🛡️OOC检查] → 🎯主控定稿 | 1-2次 |
| 重点章节 | 首章/末章/幕分界/高潮/转折 | 🎯主控规划 → 🔎FinalReviewer规划 → ✍️MainWriter初稿 → ✍️MainWriter润色 → [⚔️BattleAgent] → 🛡️OOCGuardian → 🎯主控整合 → 🔎FinalReviewer终审 | 5-6次 |

### 重点章节判定

满足任一条件：
- Ch1（首章）
- ChN（末章）
- 幕间分界章
- 细纲标注：高潮/转折/情感爆发

### 自动推进

| 参数 | 默认值 | 说明 |
|------|--------|------|
| auto_advance_chapters | 4 | 一次写4章 |
| write_interval_seconds | 6 | 每章间隔秒数 |

### 调用示例（Phase 2）

```javascript
// 常规章节
sessions_spawn({
  task: "[CONTEXT]\n风格锚定v1.0、世界观摘要、角色圣经摘要、本章细纲...\n\n[TASK] 撰写第3章初稿并润色，目标4000字...",
  model: "moonshot/kimi-k2.5",
  label: "✍️ MainWriter [Kimi]"
})

// 条件触发 OOC 检查
sessions_spawn({
  task: "[CONTEXT]\n滚动摘要、最近2章、本章内容、角色圣经摘要...\n\n[TASK] 一致性检查：人设、战力、伏笔...",
  model: "qwen/qwen3-max",
  label: "🛡️ OOCGuardian [Qwen]"
})

⚠️ 批量写作关键注意事项

⚠️ 批量写多章时（"写第X到第Y章"），必须逐章顺序执行！

❌ 错误做法： 同时派发3个MainWriter Agent并行写3章 ❌ 错误原因： 每章之间有依赖关系（必须承接上章结尾状态）

✅ 正确做法： 先写第1章 → 存档 → 再写第2章 → 存档 → 再写第3章

必须逐章执行以下流程：

ch = X
while (ch <= Y) {
    // 1. 每章开始前：读取上章存档状态（场景/位置/修为/道具/关系）
    上章状态 = 读取("chapters/ch{上章}.md")

    // 2. 本章写作：按双轨制执行
    执行章节写作流程()

    // 3. 本章完成后：立即更新存档（不是全部写完后才更新！）
    写入("chapters/ch{本章}.md", 本章内容)
    更新("meta/metadata.json", { currentChapter: 本章 })
    更新("references/state-tracker.md", 本章状态变化)
    更新("references/relationship-tracker.md", 本章关系变化)
    更新("references/plot-tracker.md", 本章伏笔变化)

    // 4. 触发检查（每5章/每10章）
    if (本章 % 5 == 0) RollingSummarizer生成摘要()
    if (本章 % 10 == 0) ReaderSimulator生成反馈()

    ch = ch + 1  // 顺序执行下一章！
}

核心原则：

• ✅ 章节之间有依赖，必须先写完第1章才能写第2章
• ✅ 每章写完后立即存档，下一章才能读取正确状态
• ❌ 不能并行派发多个MainWriter Agent同时写多章

字数验证必须读取实际文件！

// 章节完成后，验证字数：
实际内容 = 读取("chapters/ch{本章}.md")
实际字数 = 计算字数(实际内容)
if (实际字数 < 3000 || 实际字数 > 6000) {
    // 触发警告，但不要阻塞流程
}

常见bug：

• ❌ 检查字数时读取写手返回摘要 → 实际文件字数与摘要不符（3800 vs 2500）
• ❌ 同时派发3个MainWriter → 章节衔接断裂
• ❌ 全部写完后再更新存档 → 后续章节读取不到正确状态
• ❌ 不更新tracking表 → 后续章节OOC
• ❌ 项目路径不一致 → 传错路径（如 projects/小说A vs projects/小说B）

项目路径管理：

• 项目根路径 = projects/<项目名>/
• 所有文件操作必须在此路径下进行
• 读取前先验证路径是否存在

Phase 3：维护迭代

触发： "重写" / "修改"

⚠️ 主控协调说明

本技能的主控（Coordinator）就是当前 OpenClaw 主会话。 所有子 Agent 通过 sessions_spawn 调用，不传 agentId 参数。

关键规则：

• ✅ 同一批次可并行调用的Agent（不同任务）→ 同时spawn
• ✅ 存在依赖关系的Agent → 等上一个完成后，再spawn下一个
• ✅ 每次spawn必须包含 label 字段（格式：{Emoji} AgentName [Model]）
• ❌ 不要让子Agent直接写完整长报告 → 子Agent返回摘要，主控整合

模型配置： 由 Phase 0 的 Step 0-5 自动生成到 config/agent_choice.md

v1.0 - 12个专业Agent协作的小说写作技能包