sumeru-review

name	sumeru-review
description	小说逻辑/剧情审查，适用于用户说"帮我检查下小说有没有bug"、"看看时间线有没有矛盾"、"人物有没有OOC"、"找剧情前后冲突"、"梳理伏笔有没有回收"、"检查小说剧情合理性"、"看看有没有剧情漏洞"、"人物行为不符合性格"、"检查时间线对不对"、"找小说前后矛盾的地方"、"帮我梳理所有伏笔"、"小说剧情bug检查"、"逻辑漏洞排查"等需求，检测时间线冲突、逻辑漏洞、人物OOC、伏笔遗漏等问题，**执行字数检查确保章节字数达标**，**生成详细问题清单并自动修复所有问题，修复结果直接修改 chapters/ 目录，修改前自动备份到 .sumeru/write/original/**，**发现严重问题时自动修订大纲并重写对应章节**，**底线问题零遗漏机制确保所有致命问题必须解决**，**批量审查时使用子Agent并行处理，每个Agent最多负责3个章节**
type	skill

网文逻辑审查

触发关键词

帮我检查下小说有没有bug、看看时间线有没有矛盾、人物有没有OOC、找剧情前后冲突、梳理伏笔有没有回收、检查小说剧情合理性、看看有没有剧情漏洞、人物行为不符合性格、检查时间线对不对、找小说前后矛盾的地方、帮我梳理所有伏笔、小说剧情bug检查、逻辑漏洞排查、小说剧情审查、大纲有问题要改、剧情矛盾怎么修、发现重复情节、设定崩坏了怎么办、底线问题检查

核心功能

三阶段审查修复流程设计

为确保审查全面性和修复质量，本 skill 采用三阶段审查修复流程：

第一阶段：全局信息审查

• 加载完整大纲和章节细纲，建立全局审查基准
• 分析整体剧情脉络和时间线结构
• 审查全局设定一致性（世界观、力量体系、规则设定）
• 识别主线支线关联问题和伏笔回收情况
• 检查整体冲突点分布和节奏把控
• 底线问题扫描：全面扫描以下六类底线问题，生成 bottom-line-checklist.json：
  • 时间线矛盾（事件顺序错误、年龄/日期冲突）
  • 设定崩坏（力量体系前后不一致、世界观规则自相矛盾）
  • 人物OOC（性格突变无铺垫、行为与动机矛盾）
  • 重复情节（相似事件重复发生无差异、桥段雷同）
  • 信息泄露（角色知道不该知道的信息、信息边界混乱）
  • 伏笔死结（已埋伏笔无回收可能、伏笔自相矛盾）
• 记录全局问题清单到 .sumeru/review/global-issues.json

第二阶段：章节细节审查（Agent Team 并行）

• 使用多 Agent 并行处理，每个 Agent 负责一定数量的章节
• ⚠️ 遵循全局约束：每个子Agent最多负责3个章节（详见 AGENTS.md "子Agent并行处理规则"）
• 所需Agent数 = ceil(总章节数 / 3)，分配策略为按章节顺序连续分配
• 为每章生成核心剧情概要（去掉细节，仅保留关键事件）
• 对每章进行详细审查：
  • 字数统计与填充需求识别
  • 时间线与事件时序验证
  • 人物行为与性格一致性（OOC检测）
  • 物品状态与信息边界检查
  • 场景描写与对话质量评估
  • 伏笔设置与回收状态
• 生成章节概要到 .sumeru/review/summaries/ 目录
• 记录章节问题清单到 .sumeru/review/chapter-issues/ 目录
• 支持断点续传，已审查章节可跳过

第三阶段：统一修复执行

• 合并全局问题和章节问题，按严重程度排序（致命 > 严重 > 中等 > 轻微）
• 制定并执行修复计划，分为三种修复类型：
  • 轻量修复（review 直接执行）：文字修正、段落调整、语句优化、字数填充等 minor 修改，直接修改 chapters/ 文件（修改前自动备份到 .sumeru/write/original/）
  • 严重问题闭环修复（review 自动执行大纲修订+章节重写）：剧情逻辑严重矛盾、大面积OOC、设定崩坏、重复情节等需要重写的章节，自动修订大纲并重写章节
  • 底线问题专项修复：六类底线问题必须全部解决，不允许跳过或搁置
• 执行轻量修复策略：
  • 全局问题修复：调整整体时间线、统一设定、优化主线结构
  • 章节问题修复：逐章修复字数、逻辑、OOC、剧情矛盾等轻量级问题
  • 联动修复：处理跨章节的关联问题（如伏笔回收、人物成长）
• 执行严重问题闭环修复：
  • 大纲修订：直接修订 .sumeru/outline/chapter-outlines.json 中受影响章节的细纲，修正剧情矛盾、消除重复情节、修复设定冲突，修订内容记录到 .sumeru/review/outline-revisions.json（包含修订原因、修订前后对比）
  • 章节重写：基于修订后的细纲，使用子Agent并行重写对应章节（遵循3章/Agent约束），重写结果直接修改 chapters/ 文件（修改前自动备份到 .sumeru/write/original/）
  • 修订一致性校验：重写后的章节需与修订后的大纲进行一致性校验，确保大纲修订意图被正确落地
• 执行底线问题零遗漏核验：
  • 逐一核对 bottom-line-checklist.json 中的每项底线问题
  • 轻量修复能解决的标记为「已解决-轻量修复」
  • 大纲修订+重写能解决的标记为「已解决-重写修复」
  • 无法自动解决的标记为「需人工干预」，并输出明确的人工干预建议（包含问题描述、影响范围、建议修改方向）
  • 全部底线问题标记为「已解决」或「需人工干预」后，审查流程才允许结束
• 生成修复报告到 .sumeru/review/fix-report.json
• 生成修复计划 fix-plan.json，记录所有修复操作的详细信息
• 修复后重新审查，验证所有轻量修复和重写修复问题已彻底解决

三阶段功能分配

第一阶段：全局审查功能

1. 整体剧情脉络分析：审查主线、支线、伏笔的整体分布
2. 全局时间线校验：梳理完整时间线，识别大跨度时序问题
3. 设定一致性检查：验证世界观、力量体系、规则设定的统一性
4. 冲突点分布评估：评估冲突强度、分布密度、节奏把控
5. 伏笔回收状态检查：识别所有未回收的伏笔和回收方向

第二阶段：章节细节审查功能 6. 字数检查与填充：确保每章字数达标，字数不足自动填充 7. 章节时间线与事件时序：检查每章内部的时间逻辑和事件顺序 8. OOC检测与人物一致性：检查人物行为、性格、对话的一致性 9. 物品状态与信息边界：追踪物品状态变化和人物信息边界 10. 场景描写与对话质量：评估场景细节和对话的自然度 11. 章节伏笔设置：记录每章的伏笔设置和预期回收位置

• ⚠️ 遵循全局约束：每个子Agent最多负责3个章节的审查（详见 AGENTS.md）

第三阶段：统一修复功能 12. 问题统一修复：合并所有问题，按严重程度排序，制定修复计划 13. 轻量修复执行：文字修正、段落调整、语句优化、字数填充等直接修改 chapters/ 文件 14. 大纲修订：对严重有问题的章节，直接修订 .sumeru/outline/chapter-outlines.json 中对应细纲 15. 章节重写：基于修订后的细纲，使用子Agent并行重写对应章节（遵循3章/Agent约束），直接修改 chapters/ 文件 16. 底线问题零遗漏核验：逐一核对六类底线问题，全部标记为「已解决」或「需人工干预」后才允许结束 17. 全局问题修复：调整整体剧情、时间线、设定等大尺度问题 18. 章节问题修复：逐章修复字数、逻辑、人物、场景等轻量级细节问题 19. 联动修复：处理跨章节关联问题，确保修复后的整体一致性 20. 修复验证：修复后重新审查，确保所有轻量修复和重写修复问题已彻底解决

• ⚠️ 轻量修复阶段遵循全局约束：每个Agent最多负责3个章节（详见 AGENTS.md）

修复机制说明

• 轻量级修复：直接修改 chapters/ 中有问题的段落或句子，修改前自动备份原始文件到 .sumeru/write/original/
• 严重问题闭环修复：对严重有问题的章节（剧情矛盾、设定崩坏、重复情节等），自动修订 .sumeru/outline/chapter-outlines.json 中对应细纲，然后基于修订后的细纲使用子Agent并行重写章节，直接修改 chapters/（修改前自动备份到 .sumeru/write/original/），修订记录保存到 .sumeru/review/outline-revisions.json
• 底线问题零遗漏：六类底线问题（时间线矛盾、设定崩坏、人物OOC、重复情节、信息泄露、伏笔死结）必须全部解决或标记「需人工干预」，不允许跳过或搁置
• 自动备份：修改 chapters/ 文件前，自动将原始版本备份到 .sumeru/write/original/，确保可回滚
• 修复记录：所有修复操作都记录在 issues-fixed.json 中，包含修复前后对比

输出内容

第一阶段：全局审查输出

• 全局剧情脉络分析报告：主线、支线、伏笔的整体分布图
• 完整故事时间线图谱：按时间轴整理的关键事件序列
• 设定一致性检查报告：世界观、力量体系、规则设定的统一性分析
• 冲突点分布评估：冲突强度、分布密度、节奏把控评估
• 全局伏笔回收状态表：所有未回收伏笔清单与回收方向建议
• 底线问题清单：六类底线问题的完整扫描结果（bottom-line-checklist.json）

第二阶段：章节细节审查输出

• 章节概要目录：每章核心剧情概要（.sumeru/review/summaries/）
• 字数检查报告：每章字数统计、不达标的章节列表、填充改进记录
• 章节时间线与事件时序报告：每章内部时间逻辑检查结果
• OOC检测报告：人物行为异常点、性格偏离分析
• 物品状态追踪表：重要物品的获得、使用、丢失状态变化
• 章节伏笔设置记录表：每章伏笔设置与预期回收位置
• 剧情连贯性评分：多维度综合评分（时间线、逻辑性、人物一致性等）

第三阶段：统一修复输出

• 问题修复报告：所有问题的修复情况记录、修复前后对比
• 大纲修订报告：大纲修订内容、修订原因、修订前后对比（outline-revisions.json）
• 全局问题修复记录：整体剧情、时间线、设定的调整记录
• 章节问题修复记录：逐章修复的详细记录
• 联动修复说明：跨章节关联问题的处理方案
• 底线问题核验报告：六类底线问题的解决状态，「已解决」/「需人工干预」清单
• 修复验证报告：修复后重新审查的验证结果
• 优化建议：剧情调整方案、伏笔回收建议、冲突优化建议

数据持久化

用户可见输出（当前工作目录）：

• 剧情审查报告.md：完整审查结果报告，包含所有问题、严重程度、修复建议（直接可读）
• 字数检查与填充报告.md：字数统计、填充改进记录
• 全局审查报告.md：第一阶段的全局分析结果
• 章节细节审查报告.md：第二阶段的章节分析结果
• 统一修复报告.md：第三阶段的修复记录，包含大纲修订、章节重写、底线问题核验结果

中间数据（仅系统内部使用，存于.sumeru/review/目录）： 第一阶段：全局审查数据

• global-issues.json：全局问题清单，包含时间线、设定、伏笔等问题
• timeline.json：完整时间线图谱，按时间轴排列的关键事件序列
• plot-map.json：剧情脉络图，显示主线、支线、冲突点分布
• foreshadowing-tracking.json：伏笔追踪表，包含所有伏笔的位置、内容、回收状态
• coherence-score.json：剧情连贯性评分明细
• bottom-line-checklist.json：底线问题清单，包含六类底线问题的扫描结果、状态追踪（待修复/已解决/需人工干预）

第二阶段：章节细节审查数据

• summaries/：章节概要目录
  • 001.json、002.json... 每章的核心剧情概要（章节号三位数零填充）
  • summary-progress.json：概要生成进度记录
• chapter-issues/：章节问题清单
  • 001.json、002.json... 每章的详细问题记录（章节号三位数零填充）
• word-count.json：字数统计数据，每章字数、目标字数、填充情况

第三阶段：统一修复数据

• issues.json：合并后的完整问题清单，按严重程度、类型分类
• fix-report.json：问题修复报告，包含修复前后对比
• fix-plan.json：修复计划，记录所有修复操作的详细信息
• outline-revisions.json：大纲修订记录，包含修订原因、修订前后对比、影响的章节列表
• issues-fixed.json：已修复问题记录
• global-fix.log：全局问题修复日志
• chapter-fix.log：章节问题修复日志
• rewrite-chapters/：重写章节的修订记录，包含重写前后对比

与其他 Skill 配合

• 前置 Skill：读取 sumeru-outline 的大纲数据和 sumeru-write 的章节数据

  • 使用 .sumeru/outline/ 的世界观、人设、大纲作为基准
  • 使用 .sumeru/outline/chapter-outlines.json 作为预期剧情参考
  • 使用 chapters/ 目录下的章节内容进行审查
  • 将实际章节内容与细纲进行对比，识别剧情偏离

• 大纲修订能力：review 发现严重问题时，直接修订 .sumeru/outline/chapter-outlines.json 中受影响章节的细纲

  • 修订内容记录到 .sumeru/review/outline-revisions.json，包含修订原因、修订前后对比
  • 修订后的大纲供后续章节重写和后续流程使用

• 章节重写能力：review 基于修订后的细纲，使用子Agent并行重写对应章节（遵循3章/Agent约束）

  • 重写结果直接修改 chapters/ 文件（修改前自动备份到 .sumeru/write/original/）
  • 重写前后对比记录到 .sumeru/review/rewrite-chapters/

• 修复计划输出：修复完成后生成 fix-plan.json，记录所有修复操作的详细信息

  • worldbuilder 在编排流程时读取此文件，确认审查阶段的修复情况
  • 独立使用时，用户可查看 fix-plan.json 了解完整修复记录

• 后续 Skill：

  • sumeru-polish：接收修复后的章节内容（已包含大纲修订+重写修复的结果），进行文笔润色
  • sumeru-finalize：接收修复后的章节内容，进行完稿校验和多平台导出

三阶段数据流向

sumeru-write 章节
    ↓
第一阶段：全局审查（global-issues.json + bottom-line-checklist.json）
    ↓
第二阶段：章节细节审查（chapter-issues/ + summaries/）
    ↓
合并问题清单（issues.json）
    ↓
第三阶段：统一修复
    ├─ 轻量修复 → 直接修改 chapters/（自动备份到 .sumeru/write/original/）
    ├─ 严重问题 → 大纲修订（outline-revisions.json）→ 章节重写（自动备份）
    └─ 底线问题 → 零遗漏核验（bottom-line-checklist.json 全部「已解决」或「需人工干预」）
    ↓
供 polish 和 finalize 使用

数据复用

• 返工修改时直接读取问题清单定位需要调整的章节
• 支持增量审查，新增章节时基于已有审查结果只检测新增内容
• 修复完成后可再次调用自动验证问题是否解决
• 字数填充记录可用于后续章节的字数参考