docs: clarify chapter_brief carries reasoning metadata, outline is authority

webnovel-writer/agents/context-agent.md

@@ -59,6 +59,16 @@ python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "{project_root}" memo
 
 这些字段由 `story-system` 引擎根据题材自动裁决，必须在阶段 D 织入任务书第 4 段"这章怎么写更顺"。
 
+**数据权重（高→低）**：
+1. 用户明确要求
+2. 大纲/章纲原文（`大纲/第X卷-详细大纲.md` 中的本章内容）
+3. Story Contracts 中的 `MASTER_SETTING`（题材、调性、核心禁忌）
+4. `chapter_{NNN}.json` 的 `reasoning` 字段（裁决层的风格/节奏/毒点建议）
+5. accepted `CHAPTER_COMMIT`（写后事实）
+6. CSV 检索结果（创作参考，不覆盖大纲）
+
+**注意**：`chapter_{NNN}.json` 的 `chapter_focus` 字段是 CSV 检索派生的参考，不代表本章实际目标。本章目标以章纲原文为准。`chapter_{NNN}.json` 的核心价值是 `reasoning` 中的裁决元数据。
+
 写后真源（已发布章节的"定稿状态"）：
 - latest accepted `.story-system/commits/chapter_{NNN}.commit.json` - 章节提交记录（accepted 才是有效定稿）
 

webnovel-writer/skills/webnovel-write/SKILL.md

@@ -156,6 +156,11 @@ python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${WORKSPACE_ROOT}" \
 - `.story-system/volumes/volume_{volume_num}.json` - `VOLUME_BRIEF`，本卷节奏合同（卷级目标、爽点密度）
 - `.story-system/reviews/chapter_{chapter_num}.review.json` - `REVIEW_CONTRACT`，本章审查合同（必须覆盖节点、本章禁区）
 
+**chapter_brief 定位说明**：
+- `.story-system/chapters/chapter_{chapter_num}.json` 的 `chapter_focus` 是 CSV 检索派生的参考，不是本章实际目标
+- 本章目标以 `大纲/第X卷-详细大纲.md` 中的章纲原文为最高权重（仅次于用户意见）
+- `chapter_{chapter_num}.json` 的核心价值是 `reasoning` 字段中的裁决元数据（风格优先级、节奏策略、反模式）
+
 **阻断规则**：
 - 合同缺失或生成失败 → 直接阻断，不进入正文起草
 - 类比：作者没过完大纲就开写，容易写崩