context-weaverlisted
Install: claude install-skill Huo0077/novel-qa-pipeline
# Context Weaver — 上下文编织器
## Iron Law
- **写前必须编织上下文**:每章写作前必须执行 `/mindmap-read`,不可跳过
- **写后必须更新思维导图**:每章完成后必须依次执行 update → scan → diff → check
- **思维导图是唯一事实来源**:所有角色状态、伏笔、规则以 `.mindmap/` 为准
## 命令入口
| 命令 | 说明 | 触发时机 |
|------|------|---------|
| `/mindmap-init` | 初始化思维导图数据层 | 开书时(一次) |
| `/mindmap-read` | 读思维导图,编织写前上下文摘要 | 写前(自动) |
| `/mindmap-update` | 扫描章节,更新思维导图 | 写后(自动) |
| `/foreshadow-scan` | 扫描章节中的伏笔(新埋/回收/过期) | 写后(自动) |
| `/snapshot-save` | 保存角色状态快照 | 写后(自动) |
| `/snapshot-diff` | 角色状态快照对比,检测异常变化 | 写后(自动) |
| `/rule-check` | 检测本章是否违反世界观硬规则 | 写后(自动) |
## 工作流
```
开书 → /mindmap-init(一次性)
↓
每章循环:
/mindmap-read → [写作] → /mindmap-update → /foreshadow-scan → /snapshot-save → /snapshot-diff → /rule-check
```
## 工具脚本
所有工具位于 `tools/` 目录,Python 3 标准库,零外部依赖。
```bash
# 初始化思维导图
python tools/mindmap_write.py init --project-root <项目目录>
# 写前编织上下文
python tools/mindmap_read.py weave --project-root <项目目录> --chapter <N> --characters <角色列表>
# 写后更新思维导图
python tools/mindmap_write.py update --project-root <项目目录> --chapter-file <章节文件>
# 伏笔扫描
python tools/foreshadow_scan.py --project-root <项目目录> --chapter-file <章节文件>
# 角色快照
python tools/snapshot_diff.py save --project-root <项目目录> --chapter <N> --characters <角色列表>
python tools/snapshot_diff.py diff --project-root <项目目录> --chapter <N>
# 规则检查
python tools/rule_check.py --project-root <项目目录> --chapter-file <章节文件>
```
## 思维导图结构 (.mindmap/)
```
.mindmap/
├── index.json # 总索引(标题、题材、章节数)
├── timeline.json #