novel-maker 2.2.0

package/skill/agents/README.md

@@ -0,0 +1,59 @@
+# NovelMaker 角色体系
+
+NovelMaker v2.0 内部采用 6 角色协作架构。用户不直接感知角色，所有交互通过协调者进行。
+
+## 6 个角色
+
+| 角色 | 文件 | 一句话职责 |
+|------|------|-----------|
+| 协调者 | [coordinator.md](coordinator.md) | 听用户的，决定让谁干活 |
+| 规划师 | [planner.md](planner.md) | 决定写什么 |
+| 写手 | [writer.md](writer.md) | 把字打出来 |
+| 审计师 | [auditor.md](auditor.md) | 看完说哪里不好 |
+| 修订师 | [reviser.md](reviser.md) | 负责把不好的修好 |
+| 复盘师 | [reviewer.md](reviewer.md) | 记下经验，整理记忆 |
+
+## 协作流程
+
+```
+用户输入
+   ↓
+[协调者] 意图识别
+   ↓
+[规划师] → 大纲/剧情卡片
+   ↓
+[写手] → 章节草稿
+   ↓
+[审计师] → 审计报告
+   ↓
+   ├─ 通过 → [复盘师]
+   └─ 不通过 → [修订师] → [审计师]（最多2轮）
+                   ↓
+              用户决策
+              ├─ 自动修订
+              ├─ 重写
+              └─ 忽略
+   ↓
+[复盘师] → 真相文件更新 + 总结
+   ↓
+[协调者] 输出
+   ↓
+用户决策
+   ├─ 满意 → 继续
+   ├─ 不满意 → 回写手重写
+   └─ 调整大纲 → 回规划师
+```
+
+**关键循环点：**
+1. **审计不通过** → 修订师 → 复审（最多 2 轮，否则升级）
+2. **用户不满意** → 回写手重写
+3. **幕结束** → 回到规划师
+
+## 关键决策
+
+- **概念角色**：6 个角色是"职责说明"，不是 AI 切换的"人格面具"
+- **temp/ 缓存**：角色间数据通过 temp/ 目录传递，避免 context 爆炸
+- **失败降级**：每个角色失败都有降级策略，不静默跳过
+- **用户决策点**：仅 2 个固定点（幕规划 + 审计不通过）
+
+详见 [规格文档](../../../../docs/superpowers/specs/2026-06-24-novel-maker-v2-architecture-redesign.md)

package/skill/agents/auditor.md

@@ -0,0 +1,234 @@
+# 审计师（Auditor）
+
+## 职责
+看完说哪里不好：33 维度审计、编辑视角审查、爽点密度追踪、问题分级。
+
+## 触发条件
+- /novel-maker review
+- /novel-maker review consistency
+- /novel-maker review pacing
+- /novel-maker review ai味
+- 写手完成一章节后（自动）
+- 每 5 章（深度审查，自动）
+- 卷末（深度审查，自动）
+
+## 输入
+
+### 待审内容
+- 章节正文（temp/draft.md 或 novels/volume-XX/chapters/）
+- 当前状态（state.json）
+
+### 对照文件
+- 真相文件（8 个）
+- 大纲/幕计划
+- 创作宪法
+
+## 输出
+
+### 1. 审计报告
+文件位置：`temp/audit.json`
+
+```json
+{
+  "chapter": "ch15",
+  "p0": [...],   // 必须修复
+  "p1": [...],   // 建议修复
+  "p2": [...],   // 可选优化
+  "p3": [...],   // 风格建议
+  "score": 8.5,
+  "summary": "..."
+}
+```
+
+### 2. 33 维度评分
+- 核心 7 项（每章必审）
+- 扩展 26 项（每 5 章/卷末深度审）
+
+### 3. 编辑视角
+- 番茄编辑视角
+- 起点编辑视角
+- 晋江编辑视角（如适用）
+
+### 4. 爽点密度
+- 当前卷爽点分布
+- 平台合规检查
+- 建议调整
+
+## 工作流
+
+### 常规审计流程（每章）
+
+**推荐方式**：使用 `pre_audit.py` 自动运行所有可审计维度：
+
+```bash
+python scripts/auditor/pre_audit.py novels/volume-01/chapters/ch15.md --json
+```
+
+输出：字数检查 / 角色提取 / 章末钩子 / 节奏评估 / AI味检测 / 一致性扫描
+
+审计师只需读取预审计结果 + 章节摘要，专注做需要 AI 判断力的维度（角色OOC、情感弧线、追读力、编辑视角）。
+
+**手动方式**（当脚本不可用时）：
+
+1. 读取章节正文
+2. 读取对照文件
+3. 执行 7 核心维度
+4. 输出 P0/P1 问题
+5. 生成审计报告
+
+### 深度审计流程（每 5 章/卷末）
+
+1. 执行 7 核心维度
+2. 执行 26 扩展维度
+3. 编辑视角审查
+4. 爽点密度分析
+5. 输出完整报告
+
+## 33 维度清单
+
+### 核心 7 项（每章必审）
+
+| 维度 | 检查内容 | P0 触发条件 |
+|------|---------|------------|
+| 角色记忆一致性 | 角色行为/动机与之前一致 | 角色 OOC |
+| 物质连续性 | 物品/位置/时间不矛盾 | 物品凭空出现/消失 |
+| 伏笔结构 | 伏笔埋设/回收合理 | 已埋未收且过 20 章 |
+| 时间线逻辑 | 事件顺序合理 | 时间矛盾 |
+| 力量体系规则 | 升级/战斗符合体系 | 体系违反 |
+| 情感弧线连贯 | 情感变化自然 | 情感断裂 |
+| 追读力评估 | 章末钩子强度 | 章末无钩子 |
+
+### 扩展 26 项（每 5 章/卷末）
+
+| 维度 | 检查内容 |
+|------|---------|
+| 角色行为动机合理性 | 角色有合理动机 |
+| 对话信息密度 | 对话推进剧情 |
+| 场景转换流畅度 | 场景过渡自然 |
+| 世界观细节一致性 | 细节不矛盾 |
+| 节奏曲线匹配度 | 符合情绪曲线 |
+| 爽点分布合理性 | 爽点密度合理 |
+| 冲突设计 | 冲突有层次 |
+| 角色关系网 | 关系合理 |
+| 信息释放节奏 | 信息逐步揭示 |
+| 意象/象征 | 文学性 |
+| 修辞多样性 | 修辞丰富 |
+| 视角一致性 | 视角统一 |
+| 叙事张力 | 紧张感 |
+| 人物辨识度 | 角色易区分 |
+| 心理描写 | 心理活动 |
+| 动作描写 | 动作清晰 |
+| 环境描写 | 环境氛围 |
+| 对话节奏 | 对话自然 |
+| 留白艺术 | 适度留白 |
+| 主题表达 | 主题清晰 |
+| 价值观输出 | 价值观 |
+| 商业化潜力 | 商业前景 |
+| 读者粘性 | 持续吸引力 |
+| 完结性 | 每章可独立 |
+| 钩子类型 | 钩子多样 |
+| 字数符合度 | 符合 2200-2800 |
+
+## 问题分级
+
+### P0 - 必须修复
+- 设定矛盾
+- 角色 OOC
+- 逻辑硬伤
+- 时间线冲突
+- 力量体系违反
+
+### P1 - 建议修复
+- 节奏失衡
+- 伏笔遗漏
+- 情感断裂
+- 爽点缺失（连续 5 章）
+- 钩子弱
+
+### P2 - 可选优化
+- 文笔润色
+- 描写增强
+- 修辞优化
+- 对话改进
+
+### P3 - 风格建议
+- 用词替换
+- 句式调整
+- 词汇多样性
+- 节奏微调
+
+## 33 维度评分
+
+每个维度 0-10 分：
+- 9-10：优秀
+- 7-8：良好
+- 5-6：合格
+- 3-4：需改进
+- 0-2：不合格
+
+总分 7.0+ 为通过。
+
+## 异常处理
+- 章节文件缺失：警告并跳过
+- 真相文件缺失：使用默认设定
+- 审计超时：保留已审维度的结果
+- 审计失败：跳过修订直接输出
+
+## 编辑视角审查
+
+### 番茄编辑视角
+- 爽点密度：每 3 章至少 1 个爽点
+- 节奏问题：连续 5+ 章慢节奏
+- 人设问题：角色 OOC
+- 商业化潜力：签约可能性
+
+### 起点编辑视角
+- 世界观展开：逐步展开
+- 升级节奏：合理升级
+- 读者粘性：钩子设计
+
+### 晋江编辑视角（言情/纯爱）
+- 情感线进展
+- 角色魅力
+- 主题表达
+- 商业化潜力
+
+## 爽点密度追踪
+
+### 爽点类型
+
+| 类型 | 关键词 | 强度 |
+|------|---------|------|
+| 打脸爽 | 打脸、嘲讽、嗤笑 | ⭐⭐⭐ |
+| 突破爽 | 突破、升级、顿悟 | ⭐⭐⭐⭐ |
+| 逆袭爽 | 反杀、绝地翻盘 | ⭐⭐⭐⭐⭐ |
+| 装逼爽 | 淡然、一招、镇压 | ⭐⭐⭐ |
+| 复仇爽 | 复仇、追杀、血债 | ⭐⭐⭐⭐⭐ |
+
+### 平台要求
+
+| 平台 | 爽点要求 | 钩子要求 |
+|------|---------|---------|
+| 番茄 | 每 3 章至少 1 个 | 章末必钩 |
+| 起点 | 每 5 章至少 1 个高潮 | 适度 |
+| 晋江 | 情感波动 | 章末留白 |
+
+## 数据流
+
+```
+[协调者] 调用审计师
+   ↓
+[审计师] 读取章节正文
+   ↓
+[审计师] 读取对照文件
+   ↓
+[审计师] 执行审计（33 维度）
+   ↓
+[审计师] 编辑视角审查
+   ↓
+[审计师] 爽点密度分析
+   ↓
+[审计师] 写入 temp/audit.json
+   ↓
+[协调者] 读取并展示
+```

package/skill/agents/coordinator.md

@@ -0,0 +1,150 @@
+# 协调者（Coordinator）
+
+## 职责
+用户入口，意图识别，调度其他 5 个角色，汇总结果。
+
+## 触发条件
+所有用户输入的第一站。
+
+## 输入
+- 用户自然语言或 /novel-maker 指令
+- 当前状态（state.json）
+
+## 输出
+- 调度指令
+- 汇总的角色输出
+- 错误处理结果
+
+## 工作流
+
+1. 解析用户输入（自然语言或 /novel-maker 指令）
+2. 识别意图（参见意图映射表）
+3. 调度对应角色（写状态到 state.json）
+4. 等待结果（读 temp/ 对应文件）
+5. 汇总输出
+6. 错误处理（参见失败恢复）
+
+## 意图映射表
+
+### 核心指令
+
+| 用户输入 | 调度角色 | 备注 |
+|---------|---------|------|
+| /novel-maker init | 协调者自己 | 6问引导 |
+| /novel-maker write | 写手→审计师→修订师→复盘师 | 完整流程 |
+| /novel-maker review | 审计师→修订师 | 仅审查修订 |
+| /novel-maker plan | 规划师 | 大纲规划 |
+| /novel-maker act | 规划师（幕模式） | 幕规划 |
+| /novel-maker memory | 复盘师 | 查询真相文件 |
+| /novel-maker stats | 协调者调用脚本 | 统计 |
+| /novel-maker help | 协调者 | 帮助 |
+| /novel-maker expand | 写手 | 扩写 |
+| /novel-maker style | 协调者 | 文风设置 |
+| /novel-maker inspire | 规划师 | 灵感 |
+| /novel-maker summary | 复盘师 | 总结 |
+
+### 自然语言
+
+| 自然语言 | 调度角色 | 备注 |
+|---------|---------|------|
+| "开始写小说" / "我想写一本修仙小说" | 协调者自己 | 同 /init |
+| "继续写" / "帮我写下一章" | 写手→审计师→修订师→复盘师 | 同 /write |
+| "检查一下" / "看看有没有问题" | 审计师→修订师 | 同 /review |
+| "下一幕怎么走" / "给我剧情建议" | 规划师 | 同 /act |
+| "主角什么等级" / "列出所有角色" | 复盘师 | 同 /memory |
+| "重写" / "这段不行" | 写手 | 重写最近章节 |
+| "统计字数" | 协调者调用脚本 | 同 /stats |
+
+## 状态管理
+
+维护 `state.json`：
+
+```json
+{
+  "current_volume": 1,
+  "current_act": 2,
+  "current_chapter": 15,
+  "phase": "writing",
+  "status": "in_progress",
+  "emotion_label": "打脸爽文",
+  "style": "天蚕土豆",
+  "last_audit_chapter": 10,
+  "last_summary_chapter": 10,
+  "current_volume_chapters": 30
+}
+```
+
+## 异常处理
+- 角色失败：跳过该角色 + 通知用户
+- 用户中断：保存进度到 state.json
+- 状态不一致：重置 state.json 并警告
+- 指令无法识别：请求用户澄清
+
+## 失败恢复策略
+
+| 角色 | 重试次数 | 降级策略 | 通知用户 |
+|------|---------|---------|---------|
+| 写手 | 1 次 | 重试失败后通知 | ✅ |
+| 审计师 | 0 次 | 跳过审计直接输出 | ✅ |
+| 修订师 | 0 次 | 跳过修订直接输出 | ✅（附警告） |
+| 复盘师 | 0 次 | 跳过真相文件更新 | ⚠️（仅警告） |
+| 规划师 | 0 次 | 使用现有大纲 | ✅ |
+
+## 数据传递
+- 角色 A 输出 → 写入 `temp/` 对应文件
+- 角色 B 输入 → 读取 `temp/` 对应文件
+- 不通过 AI context 传递
+
+## Token 优化脚本集成
+
+协调者在调度角色时自动运行以下脚本，减少 token 消耗：
+
+| 调度流程 | 脚本 | 节省 |
+|---------|------|------|
+| 写手写作前 | `scripts/writer/build_write_context.py` 构建精简上下文 | ~45,000 token/章 |
+| 审计师审查前 | `scripts/auditor/pre_audit.py` 运行自动化审计 | ~25,000 token/章 |
+| 复盘师复盘前 | `scripts/reviewer/truth_diff.py` 检测变更 | ~40,000 token/章 |
+| 规划师规划前 | `scripts/planner/planner_context.py` 构建精简上下文 | ~25,000 token/幕 |
+| 修订师修订后 | `scripts/reviewer/chapter_diff.py` 对比原稿和修订稿 | ~8,000 token/章 |
+
+## 临时文件约定
+
+| 文件 | 角色 | 内容 |
+|------|------|------|
+| temp/planning.json | 规划师 | 剧情卡片 |
+| temp/draft.md | 写手 | 章节草稿 |
+| temp/audit.json | 审计师 | 审计报告 |
+| temp/revised.md | 修订师 | 修订稿 |
+| temp/char-update.json | 复盘师 | 角色状态更新 |
+| temp/hook-update.json | 复盘师 | 伏笔状态更新 |
+
+## 用户决策点
+
+### 决策点 1：幕规划时
+
+```
+[规划师] 生成 6 条剧情走向
+   ↓
+[用户] 选择 / 调整 / 自定义
+   ↓
+继续
+```
+
+### 决策点 2：审计不通过时
+
+```
+[审计师] 输出审计报告（含 P0/P1）
+   ↓
+[用户] 决策
+   ├─ 自动修订（修订师处理）
+   ├─ 重写（回写手）
+   └─ 忽略（继续，记录警告）
+   ↓
+继续
+```
+
+## 输出格式
+- 默认 Markdown 格式
+- 长内容使用引用块
+- 代码块保留代码原格式
+- 列表用 `-` 而非数字

package/skill/agents/planner.md

@@ -0,0 +1,220 @@
+# 规划师（Planner）
+
+## 职责
+想清楚写什么：生成大纲、幕规划、剧情走向推荐、灵感建议、偏离检查。
+
+## 触发条件
+- /novel-maker plan
+- /novel-maker act
+- /novel-maker inspire
+- 协调者调度
+- 幕结束（自动）
+
+## 输入
+
+### 设定信息
+- 题材（玄幻/都市/仙侠/悬疑/历史/科幻等）
+- 情绪标签（6 大标签之一）
+- 一句话简介
+- 主角（姓名、核心反差点、核心目标）
+- 核心冲突
+- 章节数/文风/基调
+
+### 真相文件
+- `truth-files/characters.md`（角色）
+- `truth-files/current-state.md`（世界状态）
+- `truth-files/world-setting.md`（世界观）
+- `truth-files/power-system.md`（力量体系）
+- `truth-files/pending-hooks.md`（伏笔表）
+- `truth-files/emotional-arcs.md`（情感弧线）
+- `truth-files/subplot-board.md`（支线看板）
+- `truth-files/timeline.md`（时间线）
+
+### 当前进度
+- `state.json`（当前卷/幕/章）
+- 现有大纲（novels/outline.md）
+- 已写卷（novels/volume-XX/）
+
+## Token 优化
+
+**推荐方式**：使用 `planner_context.py` 自动生成精简上下文（~5000 token），替代手动读取全部真相文件+大纲（~30,000 token）：
+
+```bash
+python scripts/planner/planner_context.py --volume 01 --act 2 --json
+```
+
+输出：卷进度 / 真相文件摘要 / 大纲目标 / 活跃伏笔 / 活跃支线
+
+## 输出
+
+### 1. 大纲
+文件位置：`novels/outline.md`
+- 三幕结构（铺垫/对抗/解决）
+- 分卷大纲
+- 角色设定
+- 世界观框架
+
+### 2. 幕计划
+文件位置：`novels/volume-XX/plan.md`
+- 幕划分（每卷 3-6 幕）
+- 每幕核心事件
+- 情绪曲线标注
+
+### 3. 剧情卡片
+文件位置：`temp/planning.json`
+- 6 条剧情走向
+- 每条包含：类型、核心事件、推荐度、章节数、伏笔处理
+
+### 4. 灵感建议
+直接输出给用户
+- 剧情建议
+- 冲突设计
+- 爽点建议
+- 角色建议
+
+### 5. 偏离检查报告
+文件位置：`temp/planning.json`
+- 偏离等级（🟢/🟡/🟠/🔴）
+- 偏离影响
+- 调整建议
+
+## 工作流
+
+1. 读取设定和真相文件
+2. 根据调用类型确定输出（大纲/幕计划/剧情卡片/灵感）
+3. 生成输出内容
+4. 写入对应位置
+5. 偏离检查（如果用户已选剧情）
+6. 更新真相文件（如需要）
+
+## 输出文件位置
+
+| 输出 | 文件位置 |
+|------|---------|
+| 总大纲 | `novels/outline.md` |
+| 卷计划 | `novels/volume-XX/plan.md` |
+| 幕计划 | `novels/volume-XX/act-plan.md` |
+| 剧情卡片 | `temp/planning.json` |
+| 灵感建议 | 直接输出 |
+| 偏离检查 | `temp/planning.json` |
+
+## 剧情卡片结构
+
+每条剧情走向包含以下字段：
+
+```json
+{
+  "direction_type": "主线推进/危机升级/支线展开/缓冲沉淀/回环收束/颠覆转向",
+  "title": "剧情走向标题",
+  "preview": {
+    "chapters": 8,
+    "summary": "剧情概要",
+    "breakdown": [
+      {"range": "1-3", "summary": "第一章到第三章概要"},
+      {"range": "4-6", "summary": "第四章到第六章概要"},
+      {"range": "7-8", "summary": "第七章到第八章概要"}
+    ]
+  },
+  "advantages": {
+    "core": "核心优势",
+    "emotional": "情绪价值",
+    "commercial": "商业价值",
+    "reader_attraction": "读者吸引力"
+  },
+  "reference": {
+    "novel": "参考作品名",
+    "chapter": "参考章节",
+    "bridge_type": "桥段类型",
+    "point": "借鉴要点",
+    "innovation": "创新点"
+  },
+  "chapters": 8,
+  "chapter_range": {"min": 6, "max": 12},
+  "emotion_curve": "情绪曲线描述",
+  "hooks_recovered": ["伏笔1", "伏笔2"],
+  "hooks_buried": ["新伏笔1"],
+  "deviation_impact": {
+    "score": 2,
+    "level": "轻微",
+    "description": "不影响主线，但需要调整第15章的伏笔回收",
+    "adjustment_needed": ["第15章伏笔X"],
+    "suggestion": "建议在第14章增加伏笔Y的铺垫"
+  },
+  "recommendation": {
+    "recommended": true,
+    "reason": "推荐理由",
+    "alternative": "备选方案"
+  }
+}
+```
+
+## 六种剧情分支
+
+| 类型 | 说明 | 适用场景 |
+|------|------|---------|
+| A. 主线推进 | 直接推进核心目标 | 铺垫充足，情绪升势 |
+| B. 危机升级 | 引入新威胁 | 节奏偏缓需拉紧 |
+| C. 支线展开 | 展开配角/暗线 | 世界观需要丰满 |
+| D. 缓冲沉淀 | 日常/修炼/情感深化 | 连续 3+ 章高潮后 |
+| E. 回环收束 | 回收多条伏笔 | 前期伏笔过多 |
+| F. 颠覆转向 | 揭示颠覆性信息 | 重大转折，高风险 |
+
+## 偏离检查标准
+
+| 等级 | 标准 | 处理 |
+|------|------|------|
+| 🟢 无偏离 | 符合原大纲 | 继续 |
+| 🟡 轻微 | 局部调整 | 记录，继续 |
+| 🟠 中度 | 影响整体节奏 | 警告，建议调整 |
+| 🔴 严重 | 颠覆整体方向 | 询问用户是否调整大纲 |
+
+## 异常处理
+- 设定不全：询问用户补全
+- 真相文件缺失：使用默认值并警告
+- 生成失败：降级到上一版
+- 数据冲突：保留最新版本
+
+## 灵感助手功能
+
+### 剧情建议
+基于当前剧情，给出短期/长期走向建议。
+
+### 冲突设计
+- 人际冲突（角色与角色）
+- 内在冲突（角色与自我）
+- 外部冲突（角色与环境）
+
+### 爽点建议
+- 打脸爽
+- 逆袭爽
+- 突破爽
+- 装逼爽
+- 复仇爽
+- 装逼打脸（综合）
+
+### 评论区诱导
+在关键节点设计留白：
+- 悬念（"主角能不能打过？"）
+- 争议（"反派该不该死？"）
+- 期待（"下一步会怎样？"）
+
+### 角色建议
+- 新角色出场建议
+- 角色关系设计
+- 角色弧光设计
+
+## 数据流
+
+```
+[协调者] 调用规划师
+   ↓
+[规划师] 读取所有真相文件
+   ↓
+[规划师] 读取大纲/幕计划
+   ↓
+[规划师] 生成输出
+   ↓
+[规划师] 写入对应位置
+   ↓
+[协调者] 读取输出并展示
+```