docs: align agent chapter file path guidance

webnovel-writer/agents/consistency-checker.md

@@ -27,10 +27,12 @@ model: inherit
   "project_root": "{PROJECT_ROOT}",
   "storage_path": ".webnovel/",
   "state_file": ".webnovel/state.json",
-  "chapter_file": "正文/第{NNNN}章.md"
+  "chapter_file": "正文/第{NNNN}章-{title_safe}.md"
 }
 ```
 
+`chapter_file` 应传实际章节文件路径；若当前项目仍使用旧格式 `正文/第{NNNN}章.md`，同样允许。
+
 **Parallel reads**:
 1. Target chapters from `正文/`
 2. `{project_root}/.webnovel/state.json` (current protagonist state)

webnovel-writer/agents/continuity-checker.md

@@ -27,10 +27,12 @@ model: inherit
   "project_root": "{PROJECT_ROOT}",
   "storage_path": ".webnovel/",
   "state_file": ".webnovel/state.json",
-  "chapter_file": "正文/第{NNNN}章.md"
+  "chapter_file": "正文/第{NNNN}章-{title_safe}.md"
 }
 ```
 
+`chapter_file` 应传实际章节文件路径；若当前项目仍使用旧格式 `正文/第{NNNN}章.md`，同样允许。
+
 **Parallel reads**:
 1. Target chapters from `正文/`
 2. Previous 2-3 chapters (for transition context)

webnovel-writer/agents/data-agent.md

@@ -20,7 +20,7 @@ model: inherit
 ```json
 {
   "chapter": 100,
-  "chapter_file": "正文/第0100章.md",
+  "chapter_file": "正文/第0100章-章节标题.md",
   "review_score": 85,
   "project_root": "D:/wk/斗破苍穹",
   "storage_path": ".webnovel/",
@@ -28,6 +28,8 @@ model: inherit
 }
 ```
 
+`chapter_file` 必须传入实际章节文件路径。若详细大纲已有章节名，优先使用带标题文件名；旧的 `正文/第0100章.md` 仍兼容。
+
 **重要**: 所有数据写入 `{project_root}/.webnovel/` 目录：
 - index.db → 实体、别名、状态变化、关系、章节索引 (SQLite)
 - state.json → 进度、配置、节奏追踪 + chapter_meta
@@ -80,7 +82,7 @@ python "${SCRIPTS_DIR}/webnovel.py" --project-root "{project_root}" where
 ### Step A: 加载上下文 (v5.1 SQL 查询)
 
 使用 Read 工具读取章节正文:
-- 章节正文: `正文/第0100章.md`
+- 章节正文: 实际章节文件路径（优先 `正文/第0100章-章节标题.md`，旧格式 `正文/第0100章.md` 仍兼容）
 
 使用 Bash 工具从 index.db 查询已有实体:
  ```bash
@@ -181,7 +183,7 @@ python "${SCRIPTS_DIR}/webnovel.py" --project-root "{project_root}" rag index-ch
 - 子块: `chunk_type='scene'`, `chunk_id='ch0100_s{scene_index}'`, `parent_chunk_id='ch0100_summary'`
 - `source_file`:
   - summary: `summaries/ch0100.md`
-  - scene: `正文/第0100章.md#scene_{scene_index}`
+  - scene: `{chapter_file}#scene_{scene_index}`
 
 ### Step H: 风格样本评估
 

webnovel-writer/agents/pacing-checker.md

@@ -27,10 +27,12 @@ model: inherit
   "project_root": "{PROJECT_ROOT}",
   "storage_path": ".webnovel/",
   "state_file": ".webnovel/state.json",
-  "chapter_file": "正文/第{NNNN}章.md"
+  "chapter_file": "正文/第{NNNN}章-{title_safe}.md"
 }
 ```
 
+`chapter_file` 应传实际章节文件路径；若当前项目仍使用旧格式 `正文/第{NNNN}章.md`，同样允许。
+
 **Parallel reads**:
 1. Target chapters from `正文/`
 2. `{project_root}/.webnovel/state.json` (strand_tracker history)

webnovel-writer/agents/reader-pull-checker.md

@@ -17,7 +17,7 @@ model: inherit
 - **上章钩子**: `state.json → chapter_meta` 或 `index.db`
 
 ## 输入
-- 章节正文（`正文/第{NNNN}章.md`）
+- 章节正文（实际章节文件路径，优先 `正文/第{NNNN}章-{title_safe}.md`，旧格式 `正文/第{NNNN}章.md` 仍兼容）
 - 上章钩子与模式（从 `state.json → chapter_meta` 或 `index.db`）
 - 题材 Profile（从 `state.json → project.genre`）
 - 是否为过渡章标记

webnovel-writer/skills/webnovel-resume/references/workflow-resume.md

@@ -120,12 +120,12 @@ B) 跳过审查，直接润色（推荐）
 <output>
 恢复选项：
 A) 继续润色（推荐）⭐
-   - 打开并继续润色 正文/第0007章.md
+   - 打开并继续润色实际章节文件（优先 `正文/第0007章-章节标题.md`）
    - 保存文件
    - 继续 Step 5（Data Agent）
 
 B) 删除润色稿，从 Step 2A 重写
-   - 删除 正文/第0007章.md
+   - 删除实际章节文件（优先 `正文/第0007章-章节标题.md`）
    - 重新生成章节内容
 
 请选择（A/B）：

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

@@ -8,7 +8,7 @@ allowed-tools: Read Write Edit Grep Bash Task
 
 ## 目标
 
-- 以稳定流程产出可发布章节：`正文/第{NNNN}章.md`。
+- 以稳定流程产出可发布章节：优先使用 `正文/第{NNNN}章-{title_safe}.md`，无标题时回退 `正文/第{NNNN}章.md`。
 - 默认章节字数目标：2000-2500（用户或大纲明确覆盖时从其约定）。
 - 保证审查、润色、数据回写完整闭环，避免“写完即丢上下文”。
 - 输出直接可被后续章节消费的结构化数据：`review_metrics`、`summaries`、`chapter_meta`。
@@ -28,7 +28,7 @@ allowed-tools: Read Write Edit Grep Bash Task
 - `/webnovel-write --minimal`：Step 1 → 2A → 3（仅3个基础审查）→ 4 → 5 → 6
 
 最小产物（所有模式）：
-- `正文/第{NNNN}章.md`
+- `正文/第{NNNN}章-{title_safe}.md` 或 `正文/第{NNNN}章.md`
 - `index.db.review_metrics` 新纪录（含 `overall_score`）
 - `.webnovel/summaries/ch{NNNN}.md`
 - `.webnovel/state.json` 的进度与 `chapter_meta` 更新

webnovel-writer/skills/webnovel-write/references/polish-guide.md

@@ -24,7 +24,7 @@ version: "6.0"
 
 ```json
 {
-  "chapter_file": "正文/第0123章.md",
+  "chapter_file": "正文/第0123章-章节标题.md",
   "overall_score": 82,
   "issues": [
     {"agent": "consistency-checker", "type": "POWER_CONFLICT", "severity": "critical", "location": "第6段", "suggestion": "境界越权"},
@@ -34,6 +34,8 @@ version: "6.0"
 }
 ```
 
+`chapter_file` 必须是当前章节的实际文件路径；若项目尚未迁移到带标题文件名，也可传 `正文/第0123章.md`。
+
 ## 2. 执行顺序（必须按序）
 
 1. 修复审查报告中的问题（先 `critical/high`）