Skip to content

README.md

Latest commit

 

History

History
202 lines (154 loc) · 9.15 KB

README.md

File metadata and controls

202 lines (154 loc) · 9.15 KB
Raw

通用小说管线 v5 — 多题材模板

6 Agent × 14 Flow · 120 维审计 · 多题材支持

@schema-ref: file=book-agent/README.md, version=5.0

一、核心架构

┌─────────────────────────────────────────────���───────┐
│                  6 Agent × 14 Flow                   │
├─────────────────────────────────────────────────────┤
│  0→1→2→3→4→5→6→7→8→9→10→11→12→13 │
│  导演  编剧  调研  设定  预检  写手  精修  审计  连贯  试读  场景  闭环  终审  发布  │
└────────────────────────────────────────────────��────┘

二、Agent 角色矩阵（统一命名）

两个命名体系等同，各项目按习惯选用：

编码 v5 名 Wiki 名 职责 负责 Flow
🎬 Director Coordinator 全局调度、决策编排 0, 11, 13
🎭 Screenwriter Writer 剧本结构、章节大纲 1
📚 Lore Keeper Auditor 世界观、审计、连贯性、终审 2, 3, 4, 7, 8, 12
✍️ Writer Writer 正文草稿 5
✨ Polisher Polisher 语言润色、风格统一 6
💬 Feedback Beta-reader 试读反馈、场景设计 9, 10, 11
🧿 Hermes Hermes 通用助手、技能路由（跨管线） —

Hermes 是管线外 Agent，负责技能路由和跨系统协调，不归属 14 Flow 工序，但任何工序均可通过 Hermes 分发。

三、14 Flow 工序定义

编排层（Director / 0）

Flow 名称 输出 Agent
0 导演笔记 0_outline/director_notes.md 🎬 Director

设计层（Screenwriter + Lore Keeper / 1–4）

Flow 名称 输出 Agent
1 剧本结构 1_world/screenplay.md 🎭 Screenwriter
2 调研报告 2_characters/report.md 📚 Lore Keeper
3 设定审核 3_arcs/audit.md 📚 Lore Keeper
4 Truth 预检 4_truth/truth_preflight.md 📚 Lore Keeper

生产层（Writer + Polisher / 5–6）

Flow 名称 输出 Agent
5 正文草稿 5_drafts/chXX_draft.md ✍️ Writer
6 精修正文 6_polished/chXX_polished.md ✨ Polisher

质量层（Lore Keeper / 7–8）

Flow 名称 输出 Agent
7 审计 7_feedback/chXX_audit_120.md 📚 Lore Keeper
8 连贯性 8_promotion/chXX_continuity.md 📚 Lore Keeper

反馈层（Feedback / 9–11）

Flow 名称 输出 Agent
9 试读反馈 9_iteration/chXX_feedback.md 💬 Feedback
10 场景设计 10_illustration/chXX_scene.md 💬 Feedback
11 修改闭环 11_notes/chXX_loop.md 💬 Feedback + 🎬 Director

终审发布层（Lore Keeper + Director / 12–13）

Flow 名称 输出 Agent
12 最终审计 12_beta/chXX_final_audit.md 📚 Lore Keeper
13 发布 13_release/chXX.md 🎬 Director

四、目录结构模板

项目按题材可选整套或子集。加粗为核心目录（必有），其余按需启用。

4.1 14 工序核心目录（唯一序号）

project/
├── 0_outline/           📋 **导演笔记** (0)
├── 1_world/       📜 **剧本结构** (1 — 科幻/都市用)
├── 2_characters/        🔬 **调研报告** (2 — 科幻/历史用)
├── 3_arcs/            📚 **设定审核** (3)
├── 4_truth/           📐 **Truth 预检** (4)
├── 5_drafts/          ✍️ **正文草稿** (5)
├── 6_polished/        ✨ **精修正文** (6)
├── 7_feedback/          🔍 **审计报告** (7)
├── 8_promotion/      🔗 **连贯性检查** (8)
├── 9_iteration/        💬 试读反馈 (9)
├── 10_illustration/   🎨 场景设计 (10)
├── 11_notes/           🔄 修改闭环 (11)
├── 12_beta/    🏁 **最终审计** (12)
├── 13_release/        📦 **发布文件** (13)
├── truth/             📐 真相文件
├── config/            ⚙️ 项目配置
└── profiles/          👤 Agent 配置

共 14 步工序，全部前缀唯一（0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13）。

4.2 题材替代目录（替换核心目录，不另占序号）

替代目录 替换 适用题材 说明
1_world-building/ 1_world/ 奇幻/游戏穿越 世界观构建优先于剧本结构
2_characters/ 2_characters/ 所有题材 角色设定替代调研
3_chapter/ 3_arcs/ 轻量项目 章节大纲替代设定审核
5_writing/ 5_drafts/ 替代命名 正文写作替代草稿
6_polish/ 6_polished/ 替代命名 精修目录替代精修正文

用法：项目按题材从 4.1 选取 14 工序核心链，再按需从 4.2 替换对应目录。例如游戏穿越题材用 1_world-building/ 替换 1_world/，其余不变。

4.3 题材 → 14 工序目录映射

题材 推荐目录链（14 步）
科幻 0_outline → 1_world → 2_characters → 3_arcs → 4_truth → 5_drafts → 6_polished → 7_feedback → 8_promotion → 9_iteration → 10_illustration → 11_notes → 12_beta → 13_release
游戏穿越 0_outline → 1_world → 2_characters → 3_arcs → 4_truth → 5_drafts → 6_polished → 7_feedback → 8_promotion → 9_iteration → 10_illustration → 11_notes → 12_beta → 13_release
都市/现实 0_outline → 1_world → 2_characters → 3_chapter → 5_drafts → 6_polished → 7_feedback → 8_promotion → 13_release
奇幻/仙侠 0_outline → 1_world-building → 2_characters → 3_arcs → 5_drafts → 6_polished → 7_feedback → 8_promotion → truth

五、120 维审计体系（统一）

合并各源定义，统一为 12 组（A–L）× 10 维 = 120 维：

组 名称 覆盖范围 维度数
A 世界观一致性 世界规则、时代背景、地理物理 10
B 角色一致性 性格、动机、背景、成长弧 10
C 力量/体系 超自然规则、等级系统、限制 10
D 情节逻辑 因果链、冲突、悬念、节奏 10
E 风格一致性 文风、语调、词汇一致性 10
F 读者体验 代入感、情绪曲线、吸引力 10
G 符号与伏笔 象征、伏笔铺设与回收 10
H 商业潜力 市场定位、差异化、话题性 10
I 题材匹配 题材规范、类型元素 10
J 技术正确 语法、拼写、格式 10
K AI 味检测 自然度、人味、多样性 10
L Truth 一致性 真相文件跨章校验 10
合计 120

评分等级

等级 分数 含义
🏆 S ≥1140 卓越，可直接发布
✅ A ≥1020 优秀，少量微调
👍 B ≥900 良好，可继续管线
⚠️ C ≥780 及格，需修订
🔴 D ≥600 不合格，需大幅修改
❌ F <600 严重问题，退回重构

门禁标准

门禁点 最低要求 触发回退
4 Truth 预检 全部通过 1/3 修复
7 审计 B 级 (≥900) 5–6 修改
8 连贯性 无矛盾 6 修正
12 终审 A 级 (≥1020) 全链路修复

六、技能文件映射

模板定义的 Agent 行为由以下 Prompt 文件驱动（位于 prompts/ 目录）：

Agent 提示词文件 流程文件 路径
🎬 Director / Coordinator prompt.md flow.md prompts/director/
✍️ Writer prompt.md flow.md prompts/writer/
✨ Polisher prompt.md flow.md prompts/polisher/
💬 Feedback / Beta-reader prompt.md flow.md prompts/feedback/
📚 Lore Keeper / Auditor prompt.md flow.md prompts/lore_keeper/
🎭 Screenwriter prompt.md flow.md prompts/screenwriter/
🧿 Hermes — — 系统级 Agent，不在此模板范围

每个 Agent 目录包含 4 件套：prompt.md（系统提示词）、flow.md（工序流程）、agent.json（元数据）、config.yaml（默认配置）。

高层级流程概览另见 flows/ 目录下的各 Agent 总览文件。

七、题材扩展

各题材特有配置（目录结构、风格指南、审计权重）见 genres/ 子目录：

文件 题材
genres/genre_scifi.md 科幻
genres/game-lit.md 游戏穿越

继承此模板： 在项目 README 中添加 > 继承自 book-agent/ 版本： v5.0 — 通用模板，合并多项目管线经验