技能名称: ZF-novel-writer
详细描述:
帮你们测试过了一个男主八个女主再复杂再狗血的关系都能轻松拿捏！自带🍅小说自动发布脚本。

【ZF-novel-writer】三Agent协作小说写作系统

🔥 亮点速览：

• - 无需API Key — 全部通过 sessionsspawn 调用本地 coding agent，零配置开写
• 三Agent流水线 — Orchestrator 规划 → Writer 写作 → Quality 质检，全自动循环
• 串行执行架构 — 章节严格顺序推进，每章依赖前章的铺垫数据和 summary，杜绝逻辑断裂
• 前章末尾300字自动衔接 — 写下一章时自动提取上一章最后300字注入提示词，确保场景、情绪、节奏无缝过渡
• Truth Files 连续性系统 — canonbible.json 追踪角色、纪元、铺垫/兑现，emotionalarcs.json 追踪情感弧线，角色状态跨章节一致
• storyoutline.xlsx 驱动 — 一张表定义全书结构（事件、爽点、悬念钩子），Writer Agent 严格按大纲执行
• 三大硬指标质检 — ① 3000-3500字/章 ② comprehensivecheck.py 8项全过 ③ 评分≥90（S/A级），不达标自动重写根据 skill 文档和 config.json 的描述，comprehensivecheck.py 包含 8 项质量检查：

1. 1. 字数检查 — 3000-3500汉字（不含标点）
2. 格式检查 — 章节结构是否符合规范（标题、正文、预告等）
3. 逻辑检查 — 情节是否自洽、有无矛盾
4. 节奏检查 — 叙事节奏是否合理、有无拖沓或跳跃
5. 连续性检查 — 与 Truth Files（canon_bible 等）是否一致
6. 铺垫/兑现检查 — setups/payoffs 是否合理追踪
7. 角色一致性 — 角色行为、性格是否符合设定
8. 悬念钩子检查 — 章末是否有有效钩子

📊 写作流程：
抓取大纲+Truth Files → 生成章节规划 → Writer输出全文 → 质检打分 → 归档更新 → 下一章

🎯 适合：长篇网文、系统文、多线叙事，任何需要连续性和质量把控的创作场景

ZF-novel-writer / 三Agent协作小说写作系统

⚠️ 无需外部API key。 内容通过生成使用宿主agent模型的coding agent（sessions_spawn）来产生。
⚠️ 无需额外API key。 通过 sessions_spawn 调用 coding agent，使用宿主agent的模型生成内容。

英文

1. 概述

ZF-novel-writer 是一个三Agent协作的长篇小说写作系统：

核心理念：

• - storyoutline.xlsx 是 Writer Agent 的唯一基本来源
• Truth Files（canonbible.json、emotional_arcs.json 等）维护连续性
• 串行执行： 每次只跑一个章节，归档完毕才开始下一章
• 无需API key： 全部通过宿主 OpenClaw 实例运行

2. 快速开始

bash

1. 复制示例项目到你的书籍目录

2. 编辑 canon_bible.json 设置你的小说设定

3. 创建/编辑 story_outline.xlsx 规划你的章节

4. 编辑 genrerules.md, WORLDSETTING.md 设定你的世界

5. 开始写作

在 OpenClaw 中，触发：写小说 或 /novel

Orchestrator 将自动处理所有事务

3. 目录结构

books/{书名}/
├── meta/
│ ├── canon_bible.json # 核心设定 + 连续性追踪
│ ├── emotional_arcs.json # 角色情感状态
│ └── character_matrix.json # 角色关系
├── chapters/ # 已归档的章节文本文件
│ └── chapter-N_标题.txt
├── summaries_json/ # 每章摘要JSON
│ └── chapter_NNN.json
├── temp_chapters/ # Writer Agent 的临时输出
├── plans/ # Orchestrator 的章节规划
│ └── chapterNNNplan.json
├── genre_rules.md # 特定类型写作规则
├── WORLD_SETTING.md # 世界观构建文档
└── story_outline.xlsx # 全书大纲（逐章）

skills/ZF-novel-writer/
├── SKILL.md # 本文件
├── README.md # 项目说明
├── config.json # 质量标准配置
├── ORCHESTRATORARCHIVEGUIDE.md
├── example-book/ # 模板书籍项目
├── docs/
│ └── ARCHITECTAGENTDESIGN.md
└── tools/ # 用于质量检查的Python工具
├── simplewriterenhanced.py
├── comprehensive_check.py
├── archivechapterwith_truth.py
├── worldcontextloader.py
└── ... (详见 tools/README.md)

4. 工作流程

┌─────────────────────────────────────────────┐
│ 步骤 1: 规划 (Orchestrator / 主会话) │
│ • 读取 story_outline.xlsx │
│ • 读取 Truth Files (canon_bible 等) │
│ • 生成 chapterNNNplan.json │
└──────────────────┬──────────────────────────┘
▼
┌─────────────────────────────────────────────┐
│ 步骤 2: 写作 (Writer Agent) │
│ • 通过 sessions_spawn (mode=run) 启动 │
│ • 读取规划 + story_outline + 上下文 │
│ • 输出: temp_chapters/chapter-N.txt │
│ • 目标: 3000-3500 字 │
└──────────────────┬──────────────────────────┘
▼
┌─────────────────────────────────────────────┐
│ 步骤 3: 质检 (Quality Agent) │
│ • 通过 sessions_spawn 启动 │
│ • 运行 comprehensive_check.py │
│ • 评分 ≥ 90 = 通过 │
│ • 评分 < 90 = 重写 → 步骤 2 │
└──────────────────┬──────────────────────────┘
▼
┌─────────────────────────────────────────────┐
│ 步骤 4: 归档 (Orchestrator) │
│ • 更新 canon_bible.json │
│ • 创建 chapter_NNN.json 摘要 │
│ • 移动到 chapters/ │
│ • 清理临时文件 │
└──────────────────┬──────────────────────────┘
▼
下一章 → 步骤 1

5. Agent 配置

Orchestrator (主会话):

• - 无需 spawn — 这是主对话
• 读取文件、制定计划、spawn 子Agent、执行归档

Writer Agent (Spawned):
python
sessions_spawn(
task=根据规划和上下文写第N章...,
agentId=writer,
runtime=run # coding agent 模式
)

Quality Agent (Spawned):
python
sessions_spawn(
task=质检第N章...,
agentId=quality,
runtime=run
)

6. 数据架构

canon_bible.json — 中央连续性数据库：
json
{
version: 1.0,
book_name: {书名},
protagonist: { name: ..., description: ... },
eras: [...],
heroines: { ... },
continuity: {
setups: [],
payoffs: [],
pending_setups: []
}
}

story_outline.xlsx — 逐章大纲：