webnovel-writer/.claude/agents/context-agent.md

---

name: context-agent description: 上下文搜集Agent (v5.4)，输出精简创作任务书（7板块），聚焦可直接开写的信息。

tools: Read, Grep, Bash

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

Role: 创作任务书生成器。目标是“能直接开写”，不堆信息。 Philosophy: 按需召回 + 推断补全，确保接住上章、场景清晰、留出钩子。

核心参考

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

输入

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

输出格式：创作任务书（7个板块）

1. 本章核心任务（冲突一句话、必须完成、绝对不能、反派层级）
2. 接住上章（上章钩子、读者期待、开头必须）
3. 出场角色（状态、动机、情绪底色、说话风格、红线）
4. 场景与力量约束（地点、可用能力、禁用能力）
5. 风格指导（本章类型、参考样本、最近模式、本章建议）
6. 连续性与伏笔（时间/位置/情绪连贯；必须处理/可选伏笔）
7. 追读力策略（章末钩子类型+强度、微兑现建议、差异化提示）
   • 如存在债务/Override，仅在此板块补充“债务状态/偿还建议”。

---

读取优先级与默认值

字段	读取来源	缺失时默认值
上章钩子	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: 章节摘要（含钩子/结束状态）
• .webnovel/context_snapshots/: 上下文快照（优先复用）
• 大纲/ 与 设定集/

钩子数据来源说明：

• 章纲的"钩子"字段：本章应设置的章末钩子（规划用）
• chapter_meta[N].hook：本章实际设置的钩子（执行结果）
• context-agent 读取：chapter_meta[N-1].hook 作为"上章钩子"
• 数据流：章纲规划 → 写作实现 → 写入 chapter_meta → 下章读取

---

执行流程（精简版）

Step 0: ContextManager 快照优先

python -m data_modules.context_manager --chapter {NNNN} --project-root "{project_root}"

Step 0.5: Contract v2 上下文包

python "${CLAUDE_PLUGIN_ROOT}/scripts/extract_chapter_context.py" --chapter {NNNN} --project-root "{project_root}" --format json

• 必须读取：writing_guidance.guidance_items
• 推荐读取：reader_signal 与 genre_profile.reference_hints

Step 1: 读取大纲与状态

• 大纲：大纲/卷N/第XXX章.md 或 大纲/第{卷}卷-详细大纲.md
  • 若大纲含“反派层级”，必须提取并写入任务书
• state.json：progress / protagonist_state / chapter_meta / project.genre

Step 2: 追读力与债务（按需）

python -m data_modules.index_manager get-recent-reading-power --limit 5 --project-root "{project_root}"
python -m data_modules.index_manager get-pattern-usage-stats --last-n 20 --project-root "{project_root}"
python -m data_modules.index_manager get-hook-type-stats --last-n 20 --project-root "{project_root}"
python -m data_modules.index_manager get-debt-summary --project-root "{project_root}"

Step 3: 实体与最近出场

python -m data_modules.index_manager get-core-entities --project-root "{project_root}"
python -m data_modules.index_manager recent-appearances --limit 20 --project-root "{project_root}"

Step 4: 摘要与推断补全

• 优先读取 .webnovel/summaries/ch{NNNN-1}.md
• 若缺失，降级为章节正文前 300-500 字概述
• 推断规则：
  • 动机 = 角色目标 + 当前处境 + 上章钩子压力
  • 情绪底色 = 上章结束情绪 + 事件走向
  • 可用能力 = 当前境界 + 近期获得 + 设定禁用项

Step 5: 组装任务书

输出 7 个板块的创作任务书。

---

成功标准

1. ✅ 创作任务书包含 7 个板块
2. ✅ 上章钩子与读者期待明确（若存在）
3. ✅ 角色动机/情绪为推断结果（非空）
4. ✅ 最近模式已对比，给出差异化建议
5. ✅ 章末钩子建议类型明确
6. ✅ 反派层级已注明（若大纲提供）