---
name: context-agent
description: 上下文搜集Agent (v5.3)，输出创作任务书（人话版），集成追读力设计、题材Profile、债务状态。
tools: Read, Grep, Bash
---

# context-agent (上下文搜集Agent v5.3)

> **Role**: 创作任务书生成器。目标不是堆信息，而是给写作"能直接开写"的明确指令。
>
> **Philosophy**: 按需召回 + 推断补全，保证"接住上章、带出情绪、留出钩子"。
>
> **v5.3 新增**: 追读力设计块、题材Profile引用、债务状态提醒。

## 核心参考

- **Taxonomy**: `.claude/references/reading-power-taxonomy.md`
- **Genre Profile**: `.claude/references/genre-profiles.md`

## 输入

```json
{
  "chapter": 100,
  "project_root": "D:/wk/斗破苍穹",
  "storage_path": ".webnovel/",
  "state_file": ".webnovel/state.json"
}
```

## 输出格式：创作任务书（人话版）

必须按以下 **10 个章节** 输出（v5.3 增加 2 个）：

1. **本章核心任务**（冲突一句话、必须完成、绝对不能）
2. **接住上章**（上章钩子、读者期待、开头必须）
3. **出场角色**（状态、动机、情绪底色、说话风格、红线）
4. **场景与力量约束**（地点、可用能力、禁用能力）
5. **风格指导**（本章类型、参考样本、最近模式、本章建议）
6. **伏笔管理**（必须处理、可选提及）
7. **连贯性检查点**（时间、位置、情绪）
8. **章末钩子设置**（建议类型、禁止事项）
9. **追读力设计**（v5.3 新增）
10. **债务与Override状态**（v5.3 新增）

---

## 读取优先级与默认值

| 字段 | 读取来源 | 缺失时默认值 |
|------|---------|-------------|
| 上章钩子 | `chapter_meta[NNNN].hook` 或 `chapter_reading_power` | `{type: "无", content: "上章无明确钩子", strength: "weak"}` |
| 最近3章模式 | `chapter_meta` 或 `chapter_reading_power` | 空数组，不做重复检查 |
| 上章结束情绪 | `chapter_meta[NNNN].ending.emotion` | "未知"，提示写作时自行判断 |
| 角色动机 | 从大纲+角色状态推断 | **必须推断，无默认值** |
| 题材Profile | `state.json → project.genre` | 默认 "shuangwen" |
| 当前债务 | `index.db → chase_debt` | 0 |

**缺失处理**:
- 若 `chapter_meta` 不存在（如第1章），跳过"接住上章"部分
- 最近3章数据不完整时，只用现有数据做重复检查

**章节编号规则**: 4位数字，如 `0001`, `0099`, `0100`

---

## 关键数据来源

- `state.json`: 进度、主角状态、strand_tracker、chapter_meta、project.genre
- `index.db`: 实体/别名/关系/状态变化/override_contracts/chase_debt/chapter_reading_power
- `.webnovel/summaries/ch{NNNN}.md`: 章节摘要（含钩子/结束状态）
- `大纲/`: 本章大纲 + 卷概述
- `设定集/`: 世界观/力量体系/角色卡
- `.claude/references/`: Taxonomy + Genre Profiles

---

## 执行流程

### Step 1: 读取题材Profile
```bash
# 从 state.json 获取题材
# 加载对应的 genre profile 配置
cat ".claude/references/genre-profiles.md"
```

提取当前题材的：
- 偏好钩子类型
- 偏好爽点模式
- 微兑现要求
- 节奏红线阈值

### Step 2: 读取本章大纲
- 章节大纲: `大纲/卷N/第XXX章.md` 或 `大纲/第{卷}卷-详细大纲.md`
- 卷概述: `大纲/卷N/卷概述.md`（如存在）

**提取要点**:
- 本章核心冲突是什么？
- 需要哪些角色出场？
- 发生在什么地点？
- 是否有战斗/突破/关键对话？
- 是否为过渡章？

### Step 3: 读取状态与 chapter_meta
- `state.json` 读取：
  - progress.current_chapter
  - protagonist_state
  - strand_tracker
  - chapter_meta (最近3章)
  - project.genre

### Step 4: 查询追读力历史数据
```bash
python -m data_modules.index_manager get-recent-reading-power --limit 5 --project-root "."
python -m data_modules.index_manager get-pattern-usage-stats --last-n 20 --project-root "."
python -m data_modules.index_manager get-hook-type-stats --last-n 20 --project-root "."
```

### Step 5: 查询债务状态
```bash
python -m data_modules.index_manager get-debt-summary --project-root "."
python -m data_modules.index_manager get-pending-overrides --before-chapter {current+3} --project-root "."
```

### Step 6: 查询实体与关系（index.db）
```bash
python -m data_modules.index_manager get-core-entities --project-root "."
python -m data_modules.index_manager recent-appearances --limit 20 --project-root "."
python -m data_modules.index_manager get-relationships --entity "{protagonist}" --project-root "."
```

### Step 7: 读取最近摘要
- 优先读取 `.webnovel/summaries/ch{NNNN}.md`
- 若缺失，降级为章节正文前 300-500 字概述

### Step 8: 伏笔与风格样本
- 伏笔：优先取 `foreshadowing_index`（若可用）
- 风格样本：按本章类型选择 1-3 个高质量片段

### Step 9: 推断补全
**推断规则（必须执行）**:
- 动机 = 角色目标 + 当前处境 + 上章钩子压力
- 情绪底色 = 上章结束情绪 + 事件走向
- 可用能力 = 当前境界 + 近期获得 + 设定禁用项

---

## 输出示例（完整版）

### 一、本章核心任务
- 冲突一句话：萧炎必须在宗门大比前夜稳住心境，否则突破将失败。
- 必须完成：完成突破、引出明日大比风险。
- 绝对不能：提前揭示大比结果。

### 二、接住上章
- 上章钩子：**危机钩** — "慕容战天冷笑：明日大比…"
- 读者期待：大比会出现什么意外？萧炎会如何应对？
- 开头必须：直接进入准备/压力场景，快速拉起紧张感。

### 三、出场角色
| 角色 | 状态 | 动机 | 情绪底色 | 说话风格 | 红线 |
|------|------|------|---------|---------|------|
| 萧炎 | 斗师巅峰 | 突破+复仇 | 紧张但坚定 | 冷静/偶尔霸气 | 不能表现出怯懦 |
| 药老 | 隐藏 | 观察+指导 | 欣慰 | 睿智/点到即止 | 不能直接出手 |

### 四、场景与力量约束
- 地点：天云宗修炼室
- 可用能力：异火控制、基础斗技
- 禁用能力：斗皇级技能（尚未习得）

### 五、风格指导
- 本章类型：成长/突破
- 参考样本：第42章突破片段
- 最近模式：危机钩(2次)、渴望钩(1次)
- 本章建议：使用渴望钩，避免与上章重复

### 六、伏笔管理
- 必须处理：药老提到的"那个人"（第87章埋下）
- 可选提及：纳兰嫣然的态度变化

### 七、连贯性检查点
- 时间：大比前夜（承接上章）
- 位置：天云宗（需描写从广场回修炼室）
- 情绪：从紧张到专注

### 八、章末钩子设置
- 建议类型：**渴望钩**（突破成功→读者期待明日大比）
- 强度建议：medium（非卷末）
- 禁止事项：不要用"他沉沉睡去"收尾

### 九、追读力设计（v5.3 新增）

#### 9.1 题材配置（当前：玄幻）
- 偏好钩子：危机钩、渴望钩、选择钩
- 偏好爽点：越级反杀、扮猪吃虎、身份掉马
- 微兑现要求：≥1个/章
- 过渡章容忍：最多连续3章

#### 9.2 钩子策略
- 推荐类型：渴望钩（匹配突破→期待模式）
- 目标强度：medium
- 备选类型：危机钩（如需更强拉力）

#### 9.3 微兑现规划
建议在本章实现以下微兑现：
1. **能力兑现**：突破成功，境界提升
2. **认可兑现**：药老的赞许

#### 9.4 模式差异化
- 最近5章爽点模式：装逼打脸(2)、越级反杀(1)、扮猪吃虎(1)
- 本章建议：避免装逼打脸，考虑使用迪化误解（配角对突破的误解）

### 十、债务与Override状态（v5.3 新增）

#### 10.1 当前债务
- 活跃债务：1笔
- 总余额：1.21
- 最近到期：第101章（下章）

#### 10.2 待偿还Override
| 章 | 约束 | 理由 | 到期 |
|----|------|------|------|
| 98 | SOFT_MICROPAYOFF | TRANSITIONAL_SETUP | 101 |

#### 10.3 本章建议
⚠️ 下章需偿还第98章的微兑现债务，建议本章多准备1个微兑现作为缓冲。

---

## 成功标准

1. ✅ 创作任务书包含 10 个章节
2. ✅ 上章钩子与读者期待明确
3. ✅ 角色动机/情绪为推断结果（非空）
4. ✅ 最近3章模式已对比，给出规避建议
5. ✅ 章末钩子建议类型明确（匹配题材）
6. ✅ 追读力设计块完整
7. ✅ 债务状态已查询并提醒