Menu
小说Bug检查专家。检查小说中的逻辑漏洞、角色不一致、节奏问题或叙事Bug，提供分级报告和修复建议。Keywords: 小说检查, bug检查, 逻辑漏洞, 角色一致性, 节奏分析, 叙事质量, 小说纠错.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | novel-bug-checker |
| description | 小说Bug检查专家。检查小说中的逻辑漏洞、角色不一致、节奏问题或叙事Bug，提供分级报告和修复建议。Keywords: 小说检查, bug检查, 逻辑漏洞, 角色一致性, 节奏分析, 叙事质量, 小说纠错. |
| metadata | {"openclaw":{"emoji":"🔍"}} |
适用场景：
不适用场景：
触发关键词: 小说检查, bug检查, 逻辑漏洞, 角色一致性, 节奏分析, 叙事质量, 小说纠错
pip install jieba
⚠️ 首次使用前请确认依赖已安装，否则脚本将无法运行。仅依赖
jieba（中文分词），无需重型NLP库。
识别情节中的逻辑断裂、时间线错误、信息知晓不合理和因果关系缺失。
确保角色行为符合其设定和发展轨迹，检测性格突变、动机矛盾和成长弧线断裂。
评估叙事节奏和信息密度，识别拖沓段落和节奏突变，检测伏笔回收情况。
| 命令 | 说明 | 用法 |
|---|---|---|
logic | 逻辑漏洞分析 | python scripts/logic-analyzer.py <文件路径> [-o <输出文件>] |
rhythm | 节奏分析 | python scripts/rhythm-analyzer.py <文件路径> [-g <类型>] |
consistency | 角色一致性检查 | python scripts/consistency-checker.py <文件路径> [-o <输出文件>] |
💡 脚本路径相对于技能根目录
skills/novel-bug-checker/scripts/
| 等级 | 说明 | 示例 |
|---|---|---|
| 🔴 致命 | 破坏故事可信度的核心矛盾 | 主角能力突变无解释、时间线严重矛盾 |
| 🟠 严重 | 影响重要情节合理性的问题 | 角色动机矛盾、关键设定冲突 |
| 🟡 中等 | 影响阅读体验但可容忍 | 对话风格偶尔偏移、过渡生硬 |
| 🟢 轻微 | 细节瑕疵，不影响整体 | 常识性小错误、生活细节不合理 |
目标：获取用户提供的小说文本内容
执行：
read 工具读取目标：检测情节逻辑链中的断裂和矛盾
执行：
python scripts/logic-analyzer.py <文件路径> [-o <输出文件>]
AI额外检查（脚本之外必须执行）：
目标：验证角色行为符合其设定和发展轨迹
执行：
python scripts/consistency-checker.py <文件路径> [-o <输出文件>]
AI额外检查（脚本之外必须执行）：
目标：评估叙事节奏和信息密度的合理性
执行：
python scripts/rhythm-analyzer.py <文件路径> [-g <类型>] [-o <输出文件>]
类型可选：玄幻（默认）/科幻/悬疑/爱情/武侠
AI额外检查（脚本之外必须执行）：
执行：按以下格式输出报告：
## 小说Bug检查报告
**检查范围**：[章节范围或完整作品]
**检查时间**：[时间戳]
### 问题统计
- 🔴 致命：X个
- 🟠 严重：Y个
- 🟡 中等：Z个
- 🟢 轻微：W个
### 问题详情
#### Bug #1
- **位置**：第X章 [段落引用]
- **严重程度**：[致命/严重/中等/轻微]
- **问题描述**：[详细说明]
- **根本原因**：[分析原因]
**修复建议**：
- 方案1：[描述] (难度: 低, 影响: [描述])
- 方案2：[描述] (难度: 中, 影响: [描述])
- 方案3：[描述] (难度: 高, 影响: [描述])
- ✅ 推荐方案：[方案N] — [推荐理由]
### 修复优先级
- ⚡ 立即修复：[问题列表]
- 📋 近期修复：[问题列表]
- 📌 可延迟修复：[问题列表]
目标：如果用户提供了修改后的版本，重新运行检查验证修复效果
执行：重复 Step 2-5，对比前后报告，标注已修复和新增问题。
| 策略 | 说明 | 适用场景 | 难度 |
|---|---|---|---|
| 前向补充 | 在早期章节添加铺垫和解释 | 缺少前提条件 | 低 |
| 后向解释 | 通过回忆/对话补充说明 | 遗漏可事后圆回 | 中 |
| 规则调整 | 微调世界观设定使矛盾合理化 | 设定本身有缺陷 | 高 |
| 情节重构 | 重新设计相关情节 | 矛盾无法局部修复 | 高 |
| 策略 | 说明 | 适用场景 | 难度 |
|---|---|---|---|
| 渐进过渡 | 添加过渡场景展示变化过程 | 性格突变 | 低 |
| 动机强化 | 增加内心独白明确动机 | 行为不合理 | 中 |
| 关系发展场景 | 补充互动建立情感基础 | 关系发展不合理 | 中 |
| 对话调整 | 修改对话使其符合角色背景 | 语言风格偏移 | 低 |
| 策略 | 说明 | 适用场景 | 难度 |
|---|---|---|---|
| 信息重分配 | 调整各章节信息密度 | 信息过载或稀疏 | 中 |
| 高潮增强 | 增加冲突层级和情感投入 | 高潮力度不足 | 中 |
| 过渡优化 | 添加场景/心理过渡段落 | 切换突兀 | 低 |
| 伏笔管理 | 建立伏笔追踪表确保回收 | 伏笔遗忘 | 低 |
当被检查的作品由 novel-master v2 架构创作（存在
~/.qclaw/workspace/novels/<书名>/tracker/ncg.json与settings/characters/*/state.json）时，bug-checker 可直接消费这些产物，做更高精度的定向排查：
state.json 的 cognitive_bias_pack 与 relationships，
发现「角色突然说出了不属于自己偏差包的话 / 与关系网矛盾的行为」→ 直接定位 OOC 行。location 与章节号，标出无过渡的位移（与 auditor 门禁互补，做二次把关）。ncg.json 的 伏笔/因果 标签节点与 foreshadowing.json，找出「埋了没收」或「收得不在窗口」。auditor.py check-version <书名>，把角色状态版本异常列入 🔴 致命级。v2 联动命令（需 novel-master 脚本存在）：
python ~/.qclaw/skills/novel-master/scripts/auditor.py check-version <书名>
python ~/.qclaw/skills/novel-master/scripts/ncg.py view <书名> causal
若作品并非 v2 架构（无 ncg.json），则回落到 v1 的
logic/consistency/rhythm三脚本分析，不受影响。
按需加载参考资料：
references/bug-patterns.mdreferences/repair-strategies.mdreferences/narrative-theory.mdreferences/character-consistency.md