| name | novel-free |
| description | 中文长篇小说多智能体创作技能（v1.0.1）。支持从零开始新建长篇小说项目，完成世界观/角色/大纲/章节写作、自动推进与读者反馈的完整流程。内置固定层压缩、fixed-context.md强制缓存、摘要+OOC合并触发三项核心优化，新增用户体验优化和自动化工具，显著降低token消耗与操作复杂度。适用场景：新建长篇小说、续写/批量推进章节、自动推进、重写/维护迭代。不适用于短篇（<1万字）、诗歌、散文、翻译或非小说写作。 |
novel-free (v1.0.1)
1个 Coordinator 主控 + 12个子 Agent 分工的长篇小说创作系统。Phase 0 初始化 → Phase 1 前期架构 → Phase 2 正文写作 → Phase 3 维护迭代。
🎉 版本 1.0.1 更新亮点
🚀 用户体验优化
- 交互式启动脚本
novel-free-launch.sh - 一体化菜单界面
- 自动模型配置 - 告别手动编辑
config.md
- 智能项目管理 - 项目切换、状态查看、环境隔离
- 错误恢复框架 - 系统化错误处理和项目恢复
🛠️ 新增工具脚本
scripts/
├── simple-auto-configure.sh # 自动模型配置
├── error-handler.sh # 错误处理与恢复
├── project-manager.sh # 项目管理
└── novel-free-launch.sh # 一体化启动界面
📁 项目创建优化
- 外部目录支持 - 项目不再污染技能目录
- 自动环境配置 - 一键创建隔离环境
- 智能备份系统 - 自动备份和版本管理
🚀 快速开始（推荐新方式）
方式一：交互式启动（推荐）
./novel-free-launch.sh
选择「创建新项目」→ 输入项目名 → 自动完成所有配置
方式二：命令行创建
./create-novel.sh <项目名>
cd skills/novel-free
./scripts/simple-auto-configure.sh /path/to/project
告诉Coordinator："开始Phase 1" 或 "写第1章"
方式三：传统指令
| 用户指令 | 触发阶段 |
|---|
| 新建小说 | Phase 0 初始化 |
| 世界观 / 角色 / 大纲 | Phase 1 前期架构 |
| 写第X章 | Phase 2 单章写作 |
| 写第X章到第Y章 | Phase 2 批量写作 |
| 写第X章，自动推进N章 | Phase 2 自动推进 |
| 继续写作 | Phase 2 断点恢复 |
| 重写第X章 / 补设定 | Phase 3 维护迭代 |
工作流程
flowchart TD
A([用户指令]) --> B[Coordinator]
B --> P0[Phase 0 项目初始化]
P0 --> P1[Phase 1 世界观/角色/大纲/风格锚定]
P1 --> FC[生成 fixed-context.md\n世界观≤800字 + 角色≤1200字 + 大纲≤3000字]
FC --> P2[Phase 2 正文写作]
P2 --> MW[MainWriter 初稿+润色]
MW --> CHK{每章触发判定}
CHK -- 每5章且OOC≥4章 --> COMBO[SummarizerGuardianCombo\n摘要+OOC 合并一次调用]
CHK -- 每5章OOC不足 --> RS[RollingSummarizer]
CHK -- 条件触发 --> OOC[OOCGuardian]
CHK -- 其他 --> SC[Coordinator 自查]
COMBO --> CL[章节闭环 存档落盘]
RS --> CL
OOC --> CL
SC --> CL
CL -- 重点章节 --> FR[FinalReviewer 终审]
FR --> NX
CL --> NX([下一章 / 完成])
P2 --> P3[Phase 3 维护迭代]
四项内置优化
| 优化 | 机制 | 收益 |
|---|
| 用户体验优化 | 交互式菜单 + 自动配置 + 项目管理 | 降低操作复杂度，提升启动效率 |
| 固定层压缩 | style-anchor≤600字 / 世界观≤800字 / 角色≤1200字 | 每章节省约1900 token |
| fixed-context.md 强制缓存 | Phase 2 全程只读一个文件，禁止动态读原始文档 | 消除重复读取 |
| SummarizerGuardianCombo | 每5章且OOC≥4章时摘要+OOC合并为单次调用 | 每20章节省约4次调用 |
核心文档
开始前必读：
references/lifecycle-phase0.md — Phase 0 初始化详细流程references/lifecycle-phase1.md — Phase 1 前期架构详细流程references/lifecycle-phase2-normal.md — 常规章节工作流（含合并触发逻辑）references/lifecycle-phase2-key-chapter.md — 重点章节工作流references/lifecycle-phase2-auto-advance.md — 自动推进机制references/resume-protocol.md — 恢复协议（续写前必读）references/iron-rules.md — 铁律（所有 Agent 必须遵守）references/context-feeding-strategy.md — 固定层压缩规范（novel-free 专用）references/session-cache.md — 强制缓存规范（novel-free 专用）references/agent-summarizer-guardian-combo.md — 合并 Agent（novel-free 专用）
🔧 新增工具脚本
1. 一体化启动脚本
./novel-free-launch.sh
提供交互式菜单，包含：创建项目、管理项目、查看状态、恢复中断、备份、配置模型、项目切换、查看文档。
2. 自动模型配置
./scripts/simple-auto-configure.sh <项目目录>
自动从当前会话读取模型配置，更新 config.md 和 agent-registry.json。
3. 错误处理与恢复
./scripts/error-handler.sh resume <项目目录>
./scripts/error-handler.sh backup <项目目录>
提供系统化错误处理、项目恢复和自动备份功能。
4. 项目管理
./scripts/project-manager.sh list
./scripts/project-manager.sh status <项目名>
./scripts/project-manager.sh switch <项目名>
./scripts/project-manager.sh isolate <项目名>
5. 项目创建（外部目录）
./create-novel.sh <项目名> [自定义目录]
在外部目录创建项目，避免污染技能文件。
📝 更新日志
v1.0.1 (2026-03-25)
- 新增：交互式启动脚本
novel-free-launch.sh
- 修复：模型分工选择问题，新增自动配置脚本
- 新增：错误处理与恢复框架
- 增强：项目管理功能，支持项目切换和状态查看
- 优化：用户交互体验，降低学习曲线
- 新增：项目隔离和环境管理
v1.0.0 (初始版本)
- 基于12agent-novel的优化版本
- 固定层压缩、强制缓存、合并触发三项核心优化
安全规范
openclaw.json 读取优先级：~/.openclaw/openclaw.json → ./openclaw.json → /etc/openclaw/openclaw.json- 嵌入子 Agent prompt 前过滤凭据字段（
apiKey、token、secret、password）
scripts/init-project.sh 仅本地文件操作，不含网络请求- 所有新增脚本均为本地操作，不涉及网络请求
