Explorar el Código

refactor(refs): region-read instructions for 7 hot references; register read-method in loading-map

lingfengQAQ hace 2 semanas
padre
commit
3f923c8008

+ 41 - 37
webnovel-writer/references/index/reference-loading-map.md

@@ -8,43 +8,47 @@
 
 ## 直接 Read 的 md/template
 
-| Skill | 阶段 | 触发 | Reference |
-|-------|------|------|-----------|
-| webnovel-init | Step 1 | always | `skills/webnovel-init/references/system-data-flow.md` |
-| webnovel-init | Step 1 | always | `skills/webnovel-init/references/genre-tropes.md` |
-| webnovel-init | 卖点/题材采集 | always | `references/genre-profiles.md` |
-| webnovel-init | Step 2 | 用户人物扁平 | `skills/webnovel-init/references/worldbuilding/character-design.md` |
-| webnovel-init | Step 4 | always | `skills/webnovel-init/references/worldbuilding/faction-systems.md` |
-| webnovel-init | Step 4 | 涉及修仙/玄幻/高武/异能 | `skills/webnovel-init/references/worldbuilding/power-systems.md` |
-| webnovel-init | Step 4 | always | `skills/webnovel-init/references/worldbuilding/world-rules.md` |
-| webnovel-init | Step 5 | always | `skills/webnovel-init/references/creativity/creativity-constraints.md` |
-| webnovel-init | Step 5 | always | `skills/webnovel-init/references/creativity/selling-points.md` |
-| webnovel-init | Step 5 | 复合题材 | `skills/webnovel-init/references/creativity/creative-combination.md` |
-| webnovel-init | Step 5 | 卡顿 | `skills/webnovel-init/references/creativity/inspiration-collection.md` |
-| webnovel-init | Step 5 | 题材映射命中 | `skills/webnovel-init/references/creativity/anti-trope-*.md` |
-| webnovel-init | Step 6 | always | `skills/webnovel-init/references/worldbuilding/setting-consistency.md` |
-| webnovel-plan | Step 4 | always | `templates/output/大纲-卷节拍表.md` |
-| webnovel-plan | Step 5 | always | `templates/output/大纲-卷时间线.md` |
-| webnovel-plan | Step 6 | always | `references/genre-profiles.md` |
-| webnovel-plan | Step 6 | always | `references/shared/strand-weave-pattern.md` |
-| webnovel-plan | 章纲拆分 | always | `references/outlining/plot-signal-vs-spoiler.md` |
-| webnovel-plan | Step 6 | 需要爽点设计 | `references/shared/cool-points-guide.md` |
-| webnovel-plan | Step 6/7 | 需要冲突设计 | `skills/webnovel-plan/references/outlining/conflict-design.md` |
-| webnovel-plan | Step 7 | 需要追读力分析 | `references/reading-power-taxonomy.md` |
-| webnovel-plan | Step 7 | 需要章纲细化 | `skills/webnovel-plan/references/outlining/chapter-planning.md` |
-| webnovel-plan | Step 6/7 | 特定题材节奏 | `skills/webnovel-plan/references/outlining/genre-volume-pacing.md` |
-| webnovel-write | Step 4 | always | `skills/webnovel-write/references/polish-guide.md` |
-| webnovel-write | Step 4 | always | `skills/webnovel-write/references/writing/typesetting.md` |
-| webnovel-write | Step 4 | always | `skills/webnovel-write/references/style-adapter.md` |
-| webnovel-review | Step 2 | always | `references/shared/core-constraints.md` |
-| webnovel-review | Step 2 | always | `references/review-schema.md` |
-| webnovel-review | Step 2 | 审查涉及爽点或钩子分析 | `references/shared/cool-points-guide.md` |
-| webnovel-review | Step 2 | 审查涉及多线交织 | `references/shared/strand-weave-pattern.md` |
-| webnovel-review | Step 6 | blocking issue 需用户决策 | `references/review/blocking-override-guidelines.md` |
-| webnovel-query | 查询识别后 | 所有查询 | `skills/webnovel-query/references/system-data-flow.md` |
-| webnovel-query | 查询识别后 | 伏笔分析 | `skills/webnovel-query/references/advanced/foreshadowing.md` |
-| webnovel-query | 查询识别后 | 节奏分析 | `references/shared/strand-weave-pattern.md` |
-| webnovel-query | 查询识别后 | 格式查询 | `skills/webnovel-query/references/tag-specification.md` |
+> 「读取方式」:**区段** = 先 `Grep` 匹配 `^#{1,4} ` 定位真实标题锚点行号,再 `Read` offset/limit 取段(七个靶心大文件,锚点见末列);**全文** = 短文件整体读。锚点用文件里的真实标题原文(含中文顿号「、」),不是计划简写。靶心文件与锚点出处见 `docs/architecture/phase0-slimming-and-read-audit-2026-06-06.md` §A.1。
+
+| Skill | 阶段 | 触发 | Reference | 读取方式 | 区段锚点(区段读时匹配此真实标题) |
+|-------|------|------|-----------|---------|-----------|
+| webnovel-init | Step 1 | always | `skills/webnovel-init/references/system-data-flow.md` | 全文 | — |
+| webnovel-init | Step 1 | always | `skills/webnovel-init/references/genre-tropes.md` | 区段 | 当前题材段 |
+| webnovel-init | 卖点/题材采集 | always | `references/genre-profiles.md` | 区段 | 当前 genre 的单个 `### 2.x`;按需加 `## 一、Profile 字段说明` |
+| webnovel-init | Step 2 | 用户人物扁平 | `skills/webnovel-init/references/worldbuilding/character-design.md` | 全文 | — |
+| webnovel-init | Step 4 | always | `skills/webnovel-init/references/worldbuilding/faction-systems.md` | 区段 | 当前世界观所需小节 |
+| webnovel-init | Step 4 | 涉及修仙/玄幻/高武/异能 | `skills/webnovel-init/references/worldbuilding/power-systems.md` | 区段 | 力量体系对应小节 |
+| webnovel-init | Step 4 | always | `skills/webnovel-init/references/worldbuilding/world-rules.md` | 全文 | — |
+| webnovel-init | Step 5 | always | `skills/webnovel-init/references/creativity/creativity-constraints.md` | 区段 | 采集读 `## 一、创意包 Schema (Idea Package)` / `## 六、硬约束驱动创意 (Hard Constraints)` / `## 八、评分系统 (Scoring System)`;评分展示读 `### 8.1 五维评分` |
+| webnovel-init | Step 5 | always | `skills/webnovel-init/references/creativity/selling-points.md` | 区段 | `## 9. 核心卖点定位模板` 骨架;按需补 `### 1.3 核心卖点黄金公式` / `## 7. 实战检查清单` |
+| webnovel-init | Step 5 | 复合题材 | `skills/webnovel-init/references/creativity/creative-combination.md` | 区段 | 当前混搭轴对应小节 |
+| webnovel-init | Step 5 | 卡顿 | `skills/webnovel-init/references/creativity/inspiration-collection.md` | 区段 | 所需采集小节 |
+| webnovel-init | Step 5 | 题材映射命中 | `skills/webnovel-init/references/creativity/anti-trope-*.md` | 区段 | 对应反套路项 |
+| webnovel-init | Step 6 | always | `skills/webnovel-init/references/worldbuilding/setting-consistency.md` | 区段 | 一致性校验小节 |
+| webnovel-plan | Step 4 | always | `templates/output/大纲-卷节拍表.md` | 全文 | — |
+| webnovel-plan | Step 5 | always | `templates/output/大纲-卷时间线.md` | 全文 | — |
+| webnovel-plan | Step 6 | always | `references/genre-profiles.md` | 区段 | 当前 genre 的单个 `### 2.x`;按需加 `## 一、Profile 字段说明` |
+| webnovel-plan | Step 6 | always | `references/shared/strand-weave-pattern.md` | 全文 | — |
+| webnovel-plan | 章纲拆分 | always | `references/outlining/plot-signal-vs-spoiler.md` | 全文 | — |
+| webnovel-plan | Step 6 | 需要爽点设计 | `references/shared/cool-points-guide.md` | 区段 | 所需爽点维度段;题材适配取 `## 九、题材适配` |
+| webnovel-plan | Step 6/7 | 需要冲突设计 | `skills/webnovel-plan/references/outlining/conflict-design.md` | 区段 | 对应冲突类型小节 |
+| webnovel-plan | Step 7 | 需要追读力分析 | `references/reading-power-taxonomy.md` | 区段 | 按需取 `## 一、钩子类型` / `## 二、爽点模式` / `## 三、即时满足/微兑现` |
+| webnovel-plan | Step 7 | 需要章纲细化 | `skills/webnovel-plan/references/outlining/chapter-planning.md` | 区段 | `## 10. 结构化节点规范(CBN/CPNs/CEN)`;需模板时加 `## 7. 章节规划模板` |
+| webnovel-plan | Step 6/7 | 特定题材节奏 | `skills/webnovel-plan/references/outlining/genre-volume-pacing.md` | 全文 | — |
+| webnovel-write | Step 4 | always | `skills/webnovel-write/references/polish-guide.md` | 区段 | 主路径 `## 2. 执行顺序(必须按序)`;Anti-AI 终检 `## 2A. Anti-AI 检测细则` / `## Phase 1 增补:Anti-AI 规范(7层,原版)` |
+| webnovel-write | Step 4 | always | `skills/webnovel-write/references/writing/typesetting.md` | 全文 | — |
+| webnovel-write | Step 4 | always | `skills/webnovel-write/references/style-adapter.md` | 全文 | — |
+| webnovel-review | Step 2 | always | `references/shared/core-constraints.md` | 全文 | — |
+| webnovel-review | Step 2 | always | `references/review-schema.md` | 全文 | — |
+| webnovel-review | Step 2 | 审查涉及爽点或钩子分析 | `references/shared/cool-points-guide.md` | 区段 | 所需爽点维度段;题材适配取 `## 九、题材适配` |
+| webnovel-review | Step 2 | 审查涉及多线交织 | `references/shared/strand-weave-pattern.md` | 全文 | — |
+| webnovel-review | Step 6 | blocking issue 需用户决策 | `references/review/blocking-override-guidelines.md` | 全文 | — |
+| webnovel-query | 查询识别后 | 所有查询 | `skills/webnovel-query/references/system-data-flow.md` | 区段 | 按查询类型取数据源优先级小节 |
+| webnovel-query | 查询识别后 | 伏笔分析 | `skills/webnovel-query/references/advanced/foreshadowing.md` | 全文 | — |
+| webnovel-query | 查询识别后 | 节奏分析 | `references/shared/strand-weave-pattern.md` | 全文 | — |
+| webnovel-query | 查询识别后 | 格式查询 | `skills/webnovel-query/references/tag-specification.md` | 全文 | — |
+
+> 七个靶心大文件(`references/genre-profiles.md`、`skills/webnovel-init/references/creativity/selling-points.md`、`references/reading-power-taxonomy.md`、`skills/webnovel-plan/references/outlining/chapter-planning.md`、`skills/webnovel-init/references/creativity/creativity-constraints.md`、`skills/webnovel-write/references/polish-guide.md`、`references/shared/cool-points-guide.md`)一律区段读,避免 init/plan/write 每跑全量吞入;短文件维持全文读。
 
 ## CSV 检索:直接调用 `reference_search.py`
 

+ 1 - 1
webnovel-writer/skills/webnovel-init/SKILL.md

@@ -29,7 +29,7 @@ argument-hint: "[书名或灵感(可选)]"
 | 题材/卖点采集 | always | `../../references/genre-profiles.md`(只读当前 genre 段) |
 | 角色卡顿 | 人物扁平 | `references/worldbuilding/character-design.md` |
 | 世界观/力量 | 按需 | `references/worldbuilding/faction-systems.md`、`references/worldbuilding/power-systems.md`、`references/worldbuilding/world-rules.md`、`references/worldbuilding/setting-consistency.md` |
-| 创意约束 | Step 6 | `references/creativity/creativity-constraints.md`、`references/creativity/selling-points.md`;复合题材读 `creative-combination.md`;卡顿读 `inspiration-collection.md`;题材命中读 `anti-trope-*.md` |
+| 创意约束 | Step 6 | `references/creativity/creativity-constraints.md`(区段:采集读 `## 一、创意包 Schema (Idea Package)`、`## 六、硬约束驱动创意 (Hard Constraints)`、`## 八、评分系统 (Scoring System)`,评分展示读 `### 8.1 五维评分`)、`references/creativity/selling-points.md`(区段:`## 9. 核心卖点定位模板` 骨架,按需补 `### 1.3 核心卖点黄金公式`、`## 7. 实战检查清单`);复合题材读 `creative-combination.md`;卡顿读 `inspiration-collection.md`;题材命中读 `anti-trope-*.md` |
 | 命名 | 开始命名 | `python -X utf8 "${SCRIPTS_DIR}/reference_search.py" --skill init --table 命名规则 --query "{命名对象} {题材}" --genre {题材}` |
 
 按需读取上述长细则(创意约束、反套路库、世界观设计指南、卖点模板),不内联其条目。

+ 1 - 1
webnovel-writer/skills/webnovel-plan/SKILL.md

@@ -46,7 +46,7 @@ python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" pla
 |------|---------|------|
 | Step 4 | 全文 | `${SKILL_ROOT}/../../templates/output/大纲-卷节拍表.md` |
 | Step 5 | 全文 | `${SKILL_ROOT}/../../templates/output/大纲-卷时间线.md` |
-| Step 6 always | 全文 | `${SKILL_ROOT}/../../references/genre-profiles.md`(仅当前 genre 的 `### 2.x` 段) |
+| Step 6 always | 区段 | `${SKILL_ROOT}/../../references/genre-profiles.md`(仅当前 genre 的 `### 2.x` 段) |
 | Step 6 always | 全文 | `${SKILL_ROOT}/../../references/shared/strand-weave-pattern.md` |
 | 章纲拆分 always | 区段 | `${SKILL_ROOT}/../../references/outlining/plot-signal-vs-spoiler.md` |
 | Step 6 需要爽点 | 区段 | `${SKILL_ROOT}/../../references/shared/cool-points-guide.md` |

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

@@ -129,7 +129,7 @@ python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" rev
 
 ### Step 4:润色
 
-加载 `references/polish-guide.md`、`references/writing/typesetting.md`、`references/style-adapter.md`。
+`references/polish-guide.md` 区段读:先 `Grep` 匹配 `^#{1,3} ` 定位锚点行号,再 `Read` 的 offset/limit 取段——主路径取 `## 2. 执行顺序(必须按序)`;Anti-AI 终检单独区段取 `## 2A. Anti-AI 检测细则` 与 `## Phase 1 增补:Anti-AI 规范(7层,原版)`(词库段),不全文读。`references/writing/typesetting.md`、`references/style-adapter.md` 短文件,全文读
 
 顺序:修复非 blocking issue → 风格适配 → 排版 → Anti-AI 终检。