9.6 KiB
name, description, agent_created
| name | description | agent_created |
|---|---|---|
| novel-volume-analyzer | 小说分卷分析技能——读取指定卷的纯文字正文，生成分卷文档（故事主线骨架、主要角色表、世界观设定集），每卷只记当卷信息；另维护跨卷总表记录反复callback的稳定角色特征与核心世界观。适用于长篇连载小说（如 Re:Zero）逐卷拆解、建立写作资料库的场景。当用户要求"分析第X卷""生成大纲""更新角色表""整理世界观"时触发。 | true |
Novel Volume Analyzer（小说分卷分析）
用途
针对长篇连载小说，逐卷完成以下工作：
- 故事主线骨架——500 字梗概＋章节结构＋核心冲突＋伏笔。
- 主要角色表（每卷独立）——只记录本卷中登场或有新发展的角色信息，含本卷弧光、关键场景、行号引用。
- 世界观设定集（每卷独立）——只记录本卷新登场的设定与对上一卷的补充/修正。
- 跨卷角色与设定总表（持续维护）——记录跨多卷反复callback的稳定特征（口癖/动作/随身物品/称呼/习惯）、长期人物关系网、各卷状态变化一览、核心世界观速查。
四类文档共同构成"写作资料库"，供后续同人创作、续写、改编时直接调用。
触发场景
- 用户说"分析第 X 卷""拆解第 X 卷""生成第 X 卷的大纲/角色表/世界观"。
- 用户要求在已有资料基础上"继续往下一卷分析"。
- 用户要求"更新角色表""补充世界观"。
前置条件
工作区需具备：
- 纯文字版正文：
.txt格式，UTF-8 编码，每卷一个文件，放在约定目录（如纯文字版本/）。 - 输出目录：如
剧情骨架/，存放历卷的三份文档。 - 命名规范：
第X卷_故事主线骨架.md、第X卷_主要角色表.md、第X卷_世界观设定集.md。
完整工作流
按以下五步顺序执行，不可跳步。
第一步：定位文件与结构侦察
-
定位目标卷 txt：
ls -la "纯文字版本/"*XX* # XX 替换为卷号 wc -l "<目标文件>" # 获取总行数 -
侦察章节结构：
grep -nE "^序���|^第一章|^第二章|^第三章|^第四章|^第五章|^第六章|^第七章|^第八章|^第九章|^第十章|^终章|^尾声|^后记" "<目标文件>"记录每章的起始行号，作为分段读取的依据。
-
创建任务清单：用 TaskCreate 建立三个任务（骨架/角色表/世界观），便于追踪进度。
第二步：分段通读正文
txt 文件通常超过 2000 行，需分段读取。按章节边界分段，每段不超过 1800 行。
读取顺序：
- 序章 → 第一章 → 第二章 → ... → 终章 → 后记。
- 每读完一段，用一句话记录该段的核心事件（用于后续梗概）。
- 重点标记：新登场角色、新设定（魔法/地理/术语）、关键台词（记录行号）、角色弧光转折点、伏笔。
提示：遇到
File content exceeds maximum allowed tokens报错时，减小 limit 参数重试。
第三步：生成「故事主线骨架」
新建 第X卷_故事主线骨架.md，参考 assets/template_故事主线骨架.md 的结构，包含：
| 板块 | 内容要点 |
|---|---|
| 故事梗概（500字内） | 全卷一句话脉络＋起承转合，不剧透下一卷 |
| 核心设定 | 本卷新登场的能力/规则/机制（如有） |
| 章节主线结构 | 每章一行梗概，标注关键转折（如"死亡①""觉醒""决战"） |
| 核心冲突与主题 | 表层冲突／深层冲突／作者想表达的东西 |
| 延续到下一卷的伏笔 | 未解决的谜题、新登场角色的去向、能力的限制等 |
梗概撰写要点：
- 控制在 500 字以内。
- 覆盖起承转合，但不泄露下一卷走向。
- 提关键角色名、关键道具、关键转折点。
- 注意能力觉醒的准确描述（如"一开始就拥有，死后才发觉"，而非"死后才觉醒"）。
第四步：生成「主要角色表」（每卷独立）
每卷角色表只记录本卷中登场或有新发展的角色信息。 不继承上一卷内容，避免文档膨胀。
4.1 角色表内容规范
每卷角色表只写以下内容：
| 板块 | 内容 |
|---|---|
| 角色速览 | 本卷出场的角色一览表（含本卷身份/阵营/简标签） |
| 本卷状态 | 角色在本卷中的身份变化、新能力、新情报 |
| 本卷人物弧光 | 角色在本卷中的成长/转变轨迹 |
| 本卷关键场景 | 本卷最核心的对手戏/情感时刻，带行号 |
| 本卷新增口癖/动作 | 本卷首次出现且具有本卷特定含义的特征 |
重要：跨多卷反复出现的稳定特征（口癖/动作/随身物品/称呼/习惯）不记在各卷文档里，而是统一记录在
跨卷_角色与设定总表.md中。
4.2 跨卷稳定特征的判定
| 属于本卷角色表 | 属于跨卷总表 |
|---|---|
| 本卷首次出现且仅在本卷有特定含义的口癖/动作 | 跨2卷以上反复callback的口癖/动作 |
| 本卷特定场景中的台词（带行号） | 角色的固定称呼方式/被称呼方式 |
| 本卷独有的互动模式 | 跨卷反复出现的固定互动模式 |
| 角色的随身物品（当卷获取/使用） | 跨卷稳定携带的随身物品 |
| 本卷新揭晓的身份/能力 | 固定外貌特征 |
4.3 行号引用格式
所有标志性细节必须标注原文出处行号，格式统一：
- "台词原文"（L1234）
- > 原文：`「台词原文」`（L1234）
行号对应纯文字版 txt 文件，方便写作时用 Read 工具直接跳转定位。
关键：行号必须经过 Grep 验证，不能凭记忆填写。验证方法见第六步。
第五步：生成「世界观设定集」（每卷独立）
每卷世界观只记录本卷新登场的设定与对上一卷设定的补充/修正。 不继承上一卷内容。
5.1 内容规范
只记录本卷新出现的设定，按以下分类：
| 分类 | 更新触发条件 |
|---|---|
| 地理 | 本卷新的地点、城市、建筑、地形 |
| 魔法与能力体系 | 本卷新的魔法类型、能力规则、精灵/加持等 |
| 死亡回归（或核心机制） | 存档点变化、新限制、次数线索 |
| 社会与权力 | 本卷新的货币、贵族、组织、势力 |
| 禁忌与传说 | 本卷新的魔女/神话/传说/禁忌 |
| 武器与装备 | 本卷新的武器、防具、道具 |
| 历法与时间 | 时间线推进、新的历法信息 |
每条设定都要带原文行号引用。
跨多卷稳定生效的核心世界观规则（如货币体系、魔法基础属性、异世界召唤规则等）统一记录在
跨卷_角色与设定总表.md的"核心世界观速查"板块中。
第六步：行号验证（质量保证）
所有行号引用必须用 Grep 验证后再写入文件。 这是确保写作资料准确性的关键步骤。
验证方法：
Grep 工具：
- pattern: "台词关键词" 或 "设定关键词"
- path: 纯文字版/第X卷.txt
- output_mode: content
- -n: true（显示行号）
批量验证策略：
- 一条 Grep 可以同时验证多个台词（如果关键词足够独特）。
- 对于长台词，取其中最独特的关键词片段搜索。
- 验证后，将真实行号写入文档，不要使用估算值。
输出规范
文件命名
第X卷_故事主线骨架.md第X卷_主要角色表.md第X卷_世界观设定集.md跨卷_角色与设定总表.md（跨卷维护，每次分析完一卷后更新）
文件头部
每份文档开头包含：
# 《书名》第X卷 · 文档标题
> 原作：作者（版本）
> 取材：纯文字版 `文件名.txt`
> 本卷范围：仅记录本卷中登场的人物信息/设定。
> 跨卷稳定特征见 `跨卷_角色与设定总表.md`。
> 所有行号引用均对应纯文字版 txt 文件。
完成后
- 更新跨卷总表：将本卷新发现的跨卷稳定特征（反复callback的口癖/动作/随身物品/称呼）追加到
跨卷_角色与设定总表.md；更新"各卷状态变化一览"板块；如有新的核心世界观规则，更新"核心世界观速查"板块。 - 用 present_files 呈交本卷文档。
- 更新工作区记忆（
.workbuddy/memory/YYYY-MM-DD.md），记录本卷分析完成。
模板参考
assets/ 目录下提供第一卷的三份完整文档作为结构模板：
template_故事主线骨架.md——骨架的六板块结构。template_主要角色表.md——角色表的全字段格式。template_世界观设定集.md——世界观的板块结构。
创建新卷文档时，先复制对应模板，再替换内容。
注意事项
- 每卷独立：角色表和世界观只记录本卷新信息，不继承上一卷内容。跨卷信息统一在跨卷总表维护。
- 跨卷总表聚焦稳定特征：跨卷总表记录的是反复callback的口癖/动作/随身物品/称呼/习惯/固定关系，不是某一卷的剧情细节。
- 行号必验：所有行号引用必须经 Grep 验证，不可凭记忆估算。
- 梗概控字数：故事梗概严格控制在 500 字以内。
- 能力描述准确：注意"一开始就拥有能力"与"死后才觉醒能力"的区别，不要写错机制。
- 伏笔不剧透：伏笔部分只写"本卷埋下的悬念"，不泄露后续卷的解答。
- 前后因果链：梗概中涉及"角色 A 救了角色 B"这类因果，要交代清楚相识过程，不能写成"突然出现来救场"。