# Novel Sync

> 章节写完后的资料同步流程。把新写章节里的事件/关系变化/伏笔/金句同步到前情梳理、人物档案、伏笔清单、经典语录。触发词：同步前情、同步伏笔、同步人物档案、章节同步、写后同步、novel-sync。

- Skill: `chaserr/novel-sync` (Agent Skill)
- Install (CLI): `npx skillmds@latest add chaserr/novel-sync`
- Raw SKILL.md: https://api.skillmd.com/api/skills/chaserr/novel-sync/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: chaserr (https://skillmd.com/u/chaserr)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/chaserr/novel-sync

---


# novel-sync

**用途**：把刚写完（或刚修改）的章节信息同步到四类滚动维护的资料文件，确保下一章写作基于最新上下文。

## 触发场景

- `novel-write` 写完一章后**必须**调用
- 手动改完某章正文后调用
- 用户主动要求"同步前情/伏笔/语录/档案"时

## 输入要求

- 章节号（必须）
- 是否覆盖式同步（默认追加 / 也可重生成该章对应条目）

## 执行流程

### 第 1 步：读取目标章节正文 + 现有四件套

1. 找到目标章节正文文件（按 `<书名>-第X章-章名.md` 模式 glob）
2. 读取：
   - `前情梳理.md`
   - `伏笔清单.md`
   - `经典语录.md`
   - `人物档案/` 下所有文件名

### 第 2 步：提取本章关键信息

通读章节正文，提炼以下内容（暂存内存，不立即写盘）：

#### 2.1 章节摘要（→ 前情梳理.md）

按 200-400 字写：
- 本章核心事件（时间地点 + 主线推进）
- 关键关系变化（谁和谁的关系发生了什么）
- 人物内心变化点
- 章尾承接点（下一章从哪里开始）
- 已埋伏笔编号
- 已回收伏笔编号

#### 2.2 涉及人物的状态更新（→ 人物档案/*.md）

对本章每个出场人物：
- 新增的重要事件（一句话，按章节标注）
- 说话方式 / 习惯动作的新发现（如有）
- 当前情感状态的更新
- 与其他人物的关系变化
- 新出现的未解决问题或隐性情绪

**严格规则**：只记录正文里**实际写出来**的内容，不能把章节大纲里的"预设走向"提前写进档案。

#### 2.3 伏笔追踪（→ 伏笔清单.md）

- 本章**新埋**的伏笔：类型 / 内容 / 位置 / 预期回收章 / 风险
- 本章**回收**的伏笔：找到原伏笔条目，标记"已回收：第X章 + 回收质量评估（准时有力 / 过早泄底 / 过晚已失效 / 力度不足）"
- 本章**推进但未完结**的伏笔：更新"当前状态"

#### 2.4 经典语录候选（→ 经典语录.md）

筛 0-3 句"真正值得留下的句子"。判断标准：
- 必须**离开上下文也站得住**（脱离章节读仍有力量）
- 必须**不是套话**（不在 RTK.md 黑名单里）
- 必须**有具体感**（不是空泛抒情）
- **每章最多 3 句**，宁缺毋滥

如果本章没有合格的句子，明确写"本章无候选"。

### 第 3 步：用户确认（关键）

将提取的内容用结构化方式展示给用户：

```
【第X章 同步预览】

▼ 前情梳理新增条目
[本章摘要 200-400 字]

▼ 涉及人物档案更新
- 人物A：新增事件 [...] / 情感状态 [...]
- 人物B：新增事件 [...]
...

▼ 伏笔清单变更
新埋：F-XX [...]
回收：F-12 → 第X章回收（评估：准时有力）

▼ 经典语录候选（N 句，由你筛选）
1. 「...」
2. 「...」

请确认：
- 整体同步（全部写入）
- 部分同步（指明保留 / 删除哪几项）
- 取消同步
```

### 第 4 步：写入更新（用户确认后）

用 Edit 工具**追加**式写入，不覆盖已有内容：

- `前情梳理.md`：在合适位置插入"## 第X章 摘要"段落
- 各 `人物档案/<名字>.md`：在"已发生事件"等对应小节追加新行
- `伏笔清单.md`：新条目追加 + 已有条目用 Edit 改"当前状态"
- `经典语录.md`：在合适位置追加新条目（含章节出处标注）

### 第 5 步：一致性自检

写入完成后，**简单**自检：

- 前情梳理.md 最末条目章节号 = 本次同步章节号 ✓
- 伏笔清单.md 里至少存在一条"已回收"记录的章节号 = 本次（如本章确有回收）✓
- 涉及人物档案的"最后一次重要出场"字段已更新到本章 ✓

不通过则提示用户。

### 第 6 步：输出报告

```
✅ 第X章同步完成

更新的文件：
- 前情梳理.md（追加 1 条摘要）
- 人物档案：A.md / B.md / C.md
- 伏笔清单.md（新增 N 条，回收 M 条）
- 经典语录.md（新增 K 条）

⚠️ 待提醒：
- 伏笔 F-08 已埋 5 章未回收，建议在下 3 章内处理
- 人物 X 已 10 章未实质出场，注意是否被遗忘
```

## 异常处理

| 情况 | 处理 |
|------|------|
| 找不到目标章节正文 | 询问用户确认章节号或文件路径 |
| 前情梳理.md 已有该章条目 | 询问"覆盖 / 跳过 / 改写为补充版" |
| 伏笔候选无法在伏笔清单里找到对应条目 | 标记为"疑似遗忘的回收"，请用户确认 |
| 经典语录里已有几乎相同的句子 | 不入选，提示用户 |

## 红线

- **绝不**把未在正文出现的事件写进人物档案
- **绝不**自行修改伏笔的"埋伏位置"（那是历史事实）
- **绝不**把套话当金句录入经典语录
- 伏笔超过 8 章未回收时**必须**在报告里点名

## 触发示例

- "同步第 23 章"
- "把第 23 章的伏笔和语录归档一下"
- "/novel-sync 23"