223 lines
9.6 KiB
Markdown
223 lines
9.6 KiB
Markdown
---
|
||
name: novel-volume-analyzer
|
||
description: 小说分卷分析技能——读取指定卷的纯文字正文，生成分卷文档（故事主线骨架、主要角色表、世界观设定集），每卷只记当卷信息；另维护跨卷总表记录反复callback的稳定角色特征与核心世界观。适用于长篇连载小说（如 Re:Zero）逐卷拆解、建立写作资料库的场景。当用户要求"分析第X卷""生成大纲""更新角色表""整理世界观"时触发。
|
||
agent_created: true
|
||
---
|
||
|
||
# Novel Volume Analyzer（小说分卷分析）
|
||
|
||
## 用途
|
||
|
||
针对长篇连载小说，逐卷完成以下工作：
|
||
1. **故事主线骨架**——500 字梗概＋章节结构＋核心冲突＋伏笔。
|
||
2. **主要角色表（每卷独立）**——只记录本卷中登场或有新发展的角色信息，含本卷弧光、关键场景、行号引用。
|
||
3. **世界观设定集（每卷独立）**——只记录本卷新登场的设定与对上一卷的补充/修正。
|
||
4. **跨卷角色与设定总表（持续维护）**——记录跨多卷反复callback的稳定特征（口癖/动作/随身物品/称呼/习惯）、长期人物关系网、各卷状态变化一览、核心世界观速查。
|
||
|
||
四类文档共同构成"写作资料库"，供后续同人创作、续写、改编时直接调用。
|
||
|
||
## 触发场景
|
||
|
||
- 用户说"分析第 X 卷""拆解第 X 卷""生成第 X 卷的大纲/角色表/世界观"。
|
||
- 用户要求在已有资料基础上"继续往下一卷分析"。
|
||
- 用户要求"更新角色表""补充世界观"。
|
||
|
||
## 前置条件
|
||
|
||
工作区需具备：
|
||
- **纯文字版正文**：`.txt` 格式，UTF-8 编码，每卷一个文件，放在约定目录（如 `纯文字版本/`）。
|
||
- **输出目录**：如 `剧情骨架/`，存放历卷的三份文档。
|
||
- **命名规范**：`第X卷_故事主线骨架.md`、`第X卷_主要角色表.md`、`第X卷_世界观设定集.md`。
|
||
|
||
## 完整工作流
|
||
|
||
按以下五步顺序执行，不可跳步。
|
||
|
||
---
|
||
|
||
### 第一步：定位文件与结构侦察
|
||
|
||
1. **定位目标卷 txt**：
|
||
```bash
|
||
ls -la "纯文字版本/"*XX* # XX 替换为卷号
|
||
wc -l "<目标文件>" # 获取总行数
|
||
```
|
||
|
||
2. **侦察章节结构**：
|
||
```bash
|
||
grep -nE "^序���|^第一章|^第二章|^第三章|^第四章|^第五章|^第六章|^第七章|^第八章|^第九章|^第十章|^终章|^尾声|^后记" "<目标文件>"
|
||
```
|
||
记录每章的起始行号，作为分段读取的依据。
|
||
|
||
3. **创建任务清单**：用 TaskCreate 建立三个任务（骨架/角色表/世界观），便于追踪进度。
|
||
|
||
---
|
||
|
||
### 第二步：分段通读正文
|
||
|
||
txt 文件通常超过 2000 行，需分段读取。**按章节边界分段**，每段不超过 1800 行。
|
||
|
||
读取顺序：
|
||
1. 序章 → 第一章 → 第二章 → ... → 终章 → 后记。
|
||
2. 每读完一段，用一句话记录该段的核心事件（用于后续梗概）。
|
||
3. **重点标记**：新登场角色、新设定（魔法/地理/术语）、关键台词（记录行号）、角色弧光转折点、伏笔。
|
||
|
||
> 提示：遇到 `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`（跨卷维护，每次分析完一卷后更新）
|
||
|
||
### 文件头部
|
||
每份文档开头包含：
|
||
```markdown
|
||
# 《书名》第X卷 · 文档标题
|
||
|
||
> 原作：作者（版本）
|
||
> 取材：纯文字版 `文件名.txt`
|
||
> 本卷范围：仅记录本卷中登场的人物信息/设定。
|
||
> 跨卷稳定特征见 `跨卷_角色与设定总表.md`。
|
||
> 所有行号引用均对应纯文字版 txt 文件。
|
||
```
|
||
|
||
### 完成后
|
||
1. **更新跨卷总表**：将本卷新发现的跨卷稳定特征（反复callback的口癖/动作/随身物品/称呼）追加到 `跨卷_角色与设定总表.md`；更新"各卷状态变化一览"板块；如有新的核心世界观规则，更新"核心世界观速查"板块。
|
||
2. 用 present_files 呈交本卷文档。
|
||
3. 更新工作区记忆（`.workbuddy/memory/YYYY-MM-DD.md`），记录本卷分析完成。
|
||
|
||
---
|
||
|
||
## 模板参考
|
||
|
||
`assets/` 目录下提供第一卷的三份完整文档作为结构模板：
|
||
- `template_故事主线骨架.md`——骨架的六板块结构。
|
||
- `template_主要角色表.md`——角色表的全字段格式。
|
||
- `template_世界观设定集.md`——世界观的板块结构。
|
||
|
||
创建新卷文档时，先复制对应模板，再替换内容。
|
||
|
||
---
|
||
|
||
## 注意事项
|
||
|
||
- **每卷独立**：角色表和世界观只记录本卷新信息，不继承上一卷内容。跨卷信息统一在跨卷总表维护。
|
||
- **跨卷总表聚焦稳定特征**：跨卷总表记录的是反复callback的口癖/动作/随身物品/称呼/习惯/固定关系，不是某一卷的剧情细节。
|
||
- **行号必验**：所有行号引用必须经 Grep 验证，不可凭记忆估算。
|
||
- **梗概控字数**：故事梗概严格控制在 500 字以内。
|
||
- **能力描述准确**：注意"一开始就拥有能力"与"死后才觉醒能力"的区别，不要写错机制。
|
||
- **伏笔不剧透**：伏笔部分只写"本卷埋下的悬念"，不泄露后续卷的解答。
|
||
- **前后因果链**：梗概中涉及"角色 A 救了角色 B"这类因果，要交代清楚相识过程，不能写成"突然出现来救场"。
|