book-skill v3.8.0 深度分析报告
6 Agent × 14 Flow × 4 检查点 × 120 维审计 — 全自动小说生产管线的完整解剖
本文对 book-skill（原名 book-agent）进行了完整的深度分析。这是一个全自动小说生产管线技能，零外部依赖，124 个文件，涵盖从大纲到发布的全流程。
一、项目概况
| 维度 | 数据 |
|---|---|
| 名称 | book-skill（曾用名 book-agent） |
| 版本 | 3.8.0 |
| 文件总数 | 124 |
| SKILL.md | 464 行核心定义 |
| 参考文件 | 44 个 |
| 可执行脚本 | 28 个（全部语法正确） |
| 模板文件 | 44 个 |
| 题材支持 | 8 种（都市/科幻/仙侠/玄幻/奇幻/悬疑/言情/游戏穿越） |
| Agent 数量 | 6 个 |
| Flow 数量 | 14 个 |
| 外部依赖 | 零 |
| 行尾格式 | 全部 LF（无 CRLF） |
二、核心架构
2.1 管线拓扑
主 agent（头脑风暴） │ ├── 🎬 Director → Flow 0 导演笔记 ├── 🎭 Screenwriter → Flow 1 剧本结构 ├── 📚 LoreKeeper → Flow 2 调研报告 ├── 📚 LoreKeeper → Flow 3 设定审核 ├── 📚 LoreKeeper → Flow 4 Truth预检 ── CP1 ├── ✍️ Writer → Flow 5 正文草稿 ── CP2 ├── ✨ Polisher → Flow 6 精修 ├── 📚 LoreKeeper → Flow 7 120维审计 ── CP3 ├── 📚 LoreKeeper → Flow 8 连贯性检查 ├── 💬 Feedback ×2 → Flow 9 试读 + Flow 10 场景（并行） ├── 🎬 Director → Flow 11 修改闭环 ├── 📚 LoreKeeper → Flow 12 终审 ── CP4 └── 🎬 Director → Flow 13 发布
2.2 6 Agent 职责边界
| Agent | 负责工序 | NOT RESPONSIBLE FOR |
|---|---|---|
| 🎬 Director | 0(大纲)·11(闭环)·13(发布) | 写正文·事实调研·设定决策 |
| 🎭 Screenwriter | 1(结构) | 写正文·事实调研·设定决策 |
| 📚 LoreKeeper | 2·3·4·7·8·12（6道工序） | 写正文 |
| ✍️ Writer | 5(草稿) | 设定决策·审计·发布 |
| ✨ Polisher | 6(精修) | 结构调整·事实修正 |
| 💬 Feedback | 9(试读)·10(场景) | 设定决策·正文修改 |
LoreKeeper 是工作量最大的 Agent，扛 6 道工序（调研→审核→预检→审计→连贯→终审）。
三、质量体系
3.1 4 道硬门禁
| 门禁 | 位置 | 条件 | 不通过→回退 |
|---|---|---|---|
| CP1 | F4→F5 | 11 项 Truth 预检全部通过 | → Flow 1 |
| CP2 | F6→F7 | 字数 ≥5000 + AI味零命中 | → Flow 5 |
| CP3 | F7→F8 | 120 维审计 ≥900 | → Flow 5 |
| CP4 | F12→F13 | 终审 ≥1020 | → Flow 7 |
3.2 120 维评分等级
| 分数 | 等级 | 处理 |
|---|---|---|
| 1080-1200 | ⭐ S | 直接发布 |
| 960-1079 | ✅ A | 小修后发布 |
| 900-959 | ⚠️ B | 返回 11_notes 修改 |
| 800-899 | 🔴 C | 返回 5_drafts 重写 |
| <800 | 💀 D | 返回 3_arcs 重新设定 |
四、28 个脚本系统
管线执行（5 个）
batch-produce.sh·pipeline-run.sh·release.sh·init-project.sh·flow-hooks.sh
验证（5 个）
novel-verify.sh·validate-agents.sh·validate-truth.sh·validate-yaml.sh·check-truth-usage.sh
工具（9 个）
de-ai-scan.sh·truth-query.sh·diff-truth.sh·word-count.sh·health-check.sh·status-check.sh·md2html.sh·wiki.sh·scan-chapter.sh
新增能力（4 个）
discover-agents.sh（动态 Agent 发现）·audit-calc.sh（120 维自动算分）·upgrade.sh（版本迁移）·archive.sh（章节归档）
工程（5 个）
sync-skill.sh·agent-run.sh·install-hooks.sh·pre-commit.sh·hermes-start/stop.sh
五、Agent 人格体系
每个 Agent prompt 包含统一四段式记忆定义：
### 你的身份与记忆 - **角色**：岗位定义 - **性格**：行事风格 - **记忆**：跨章节经验 - **经验**：领域积累
每个项目一个 soul.md，6 个 Agent 角色各司其职。
六、核心设计决策
| 决策 | 选择 | 理由 |
|---|---|---|
| 产出格式 | HTML 统一 | 浏览器直接预览，无需工具 |
| 配置覆盖 | sync-skill.sh | 技能是权威来源，子项目只读 |
| Context 传递 | 纯文本 key:value | JSON 嵌套导致 subagent 解析超时 |
| Truth 按需读取 | 限制 Flow 2/3/7 全量读 | 减少下游 token 暴胀 |
| NEXUS handoff | 摘要+全量路径 | 下游按需取回 |
| 检查点门禁 | 4 道硬门禁 | 不达标自动回退 |
七、代码健康
| 检查项 | 状态 |
|---|---|
| 脚本语法 | ✅ 28 个全部通过 shellcheck |
| Agent 完整性 | ✅ 6 个全部通过 |
| CRLF 行尾 | ✅ 零残留 |
| book-agent 旧名称 | ✅ 零残留 |
| 960px 非标准宽度 | ✅ 零残留 |
| 六维 旧术语 | ✅ 零残留 |
| 深色背景硬编码 | ✅ 零残留 |
| .md 产出引用 | ✅ 零残留 |
| 多格式发布过时描述 | ✅ 零残留 |
| agent.json 硬编码路径 | ✅ 已清理 |
八、优势与展望
优势
- 零外部依赖，纯 shell + markdown + JSON
- 4 级硬门禁自动回退，质量不依赖人工判断
- NEXUS handoff 全覆盖，每 Flow 必有交接
- Truth 系统 9 个 JSON 构成设定宪法
- 120 维评分，每维 10 分可追踪
- PipelineStage 48 阶段精确枚举
新增能力
- Agent 动态发现（discover-agents.sh）
- 120 维审计自动算分（audit-calc.sh）
- 版本迁移工具（upgrade.sh）
- 章节归档（archive.sh）
book-skill 是当前工程化程度最高的写作管线技能。124 个文件、48 阶段枚举、4 道硬门禁、120 维评分、8 种题材、28 个脚本、NEXUS 全覆盖。它的设计哲学不是提供通用建议，而是组装了一条工业流水线——不需要人盯着，自己跑完，自己验证，自己发布。