docs: 建立 skills/reference 重构基线与引用映射

webnovel-writer/references/index/reference-gap-register.md

@@ -0,0 +1,57 @@
+# Reference Gap Register
+
+> 本文件记录本轮 skills/references 重构的基线状态与确认缺口。
+> 来源：`docs/superpowers/specs/2026-04-09-skills-restructure-and-reference-gaps.md`
+
+---
+
+## 一、Skills 现状与重写方向
+
+| Skill | Priority | Current problem | Target role | Existing references | Missing references |
+|-------|----------|-----------------|-------------|---------------------|-------------------|
+| webnovel-write | P0 | 326 行，主链过重，references 平铺式列出 | 主链总控 skill：流程+闸门+交付物+恢复 | anti-ai-guide, polish-guide, style-adapter, style-variants, writing/* (6 files), reading-power-taxonomy, genre-profiles, core-constraints | 命名规则 CSV, 场景写法 CSV, AI 味替换 CSV |
+| webnovel-review | P0 | 135 行，阻断裁决链不够清楚 | 独立审查入口：reviewer 调用→报告→blocking 处理 | review-schema, core-constraints | blocking-override-guidelines |
+| webnovel-plan | P0 | 272 行，题材/冲突/节奏规则混在正文 | 规划流程入口：卷纲→时间线→章纲 | (无独立 reference 文件) | plot-signal-vs-spoiler, 场景写法 CSV (卷级结构) |
+| webnovel-init | P1 | 434 行，接近 mini-spec，采集/策略/约束混杂 | 初始化访谈与生成工作流 | genre-profiles | 命名规则 CSV |
+| webnovel-query | P1 | 192 行，偏操作手册，低层命令暴露过多 | 查询/分析型 skill | (内联) | 暂无刚需 |
+| webnovel-dashboard | P2 | 74 行，过轻，缺验证与恢复结构 | 工具启动型 skill | (无) | 暂无刚需 |
+| webnovel-learn | P2 | 45 行，过轻，缺边界与恢复 | 轻量记录型 skill | (无) | 暂无刚需 |
+
+## 二、确认缺口清单
+
+### 新增 md reference
+
+| Reference | Main skill | Step/trigger | Gap type | Why not inline |
+|-----------|------------|--------------|----------|----------------|
+| `references/review/blocking-override-guidelines.md` | webnovel-review | Step 6 / blocking issue 需用户决策 | 缺陷补偿 | 涉及可/不可 override 场景判断，需独立正反例 |
+| `references/outlining/plot-signal-vs-spoiler.md` | webnovel-plan | 章纲拆分 / always | 提醒 + 知识补充 | 信号 vs 剧透的判断标准需独立说明，skill 一句话覆盖不了 |
+| `references/shared/naming-and-voice-gaps.md` | webnovel-write (主), init/plan (次) | Step 2 / 多角色对话、新角色命名 | 缺陷补偿 | 命名同质化、口吻趋同、题材语汇漂移涉及多类稳定错误 |
+
+### 新增 CSV 知识库
+
+| CSV 文件 | 主来源 | 服务 skill | 说明 |
+|---------|--------|-----------|------|
+| `references/csv/命名规则.csv` | 新建 | init, plan, write | 角色/地点/势力/功法/道具/书名命名规则与正反例 |
+| `references/csv/场景写法.csv` | 从现有 writing/*.md 迁移 + 新建 | write, plan | 战斗/对话/情感/桥段/卷级结构写法与正反例 |
+| `references/csv/写作技法.csv`（候选） | 从现有 writing/*.md 迁移 | write | 对话声线、AI味替换、情感描写等技法条目 |
+
+### 从现有 md 迁移到 CSV 的文件
+
+| 现有 md | 迁移到 CSV | 迁移后处置 |
+|---------|-----------|-----------|
+| `writing/combat-scenes.md` (229 行) | 场景写法.csv（场景类型=战斗） | 删除或保留空壳指向 CSV |
+| `writing/dialogue-writing.md` (231 行) | 写作技法.csv（分类=对话） | 同上 |
+| `writing/emotion-psychology.md` (265 行) | 写作技法.csv（分类=情感） | 同上 |
+| `writing/scene-description.md` (263 行) | 写作技法.csv（分类=场景） | 同上 |
+| `writing/desire-description.md` (311 行) | 写作技法.csv（分类=情感） | 同上 |
+| `writing/genre-hook-payoff-library.md` (85 行) | 场景写法.csv（场景类型=钩子/兑现） | 同上 |
+
+### 延迟（当前不纳入，条件触发后补回）
+
+| 原提案 | 过滤理由 | 恢复条件 |
+|--------|---------|---------|
+| init/title-patterns-and-anti-patterns.md | 可作为命名规则.csv 中几行条目 | CSV 覆盖不够、书名模板化严重时升级 |
+| init/protagonist-flaw-patterns.md | Claude 通用能力可覆盖 | 网文场景缺陷设计空泛化时补 CSV 条目 |
+| query/entity-alias-resolution.md | 别名解析是代码逻辑 (entity_linker.py) | 语义歧义频发时补 |
+| query/foreshadowing-urgency-rules.md | 紧急度排序已在 context-agent 实现 | 输出解释不稳定时补 |
+| learn/pattern-taxonomy.md | 分类规则可内联 skill | 分类质量持续不稳时补 CSV |

webnovel-writer/references/index/reference-loading-map.md

@@ -0,0 +1,47 @@
+# Reference Loading Map
+
+> 本文件记录 skill → step → trigger → reference 的统一映射。
+> 来源：`docs/superpowers/specs/2026-04-09-skills-restructure-and-reference-gaps.md` §6.1-6.7
+
+---
+
+## md 必读（直接 Read）
+
+| Skill | Step | Trigger | Reference |
+|-------|------|---------|-----------|
+| webnovel-write | Step 1 | always | `references/reading-power-taxonomy.md` |
+| webnovel-write | Step 1 | always | `references/genre-profiles.md` |
+| webnovel-write | Step 1 | always | `skills/webnovel-write/references/style-variants.md` |
+| webnovel-write | Step 2 | always | `references/shared/core-constraints.md` |
+| webnovel-write | Step 2 | always | `skills/webnovel-write/references/anti-ai-guide.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 6 | blocking issue 需用户决策 | `references/review/blocking-override-guidelines.md` |
+| webnovel-plan | 章纲拆分 | always | `references/outlining/plot-signal-vs-spoiler.md` |
+| webnovel-init | 卖点/题材采集 | always | `references/genre-profiles.md` |
+
+## CSV 检索（调用 `reference_search.py`）
+
+| Skill | Step | Trigger | 检索参数 |
+|-------|------|---------|---------|
+| webnovel-write | Step 2 | 本章有新角色首次出场 | `--skill write --table 命名规则 --query "角色命名" --genre {题材}` |
+| webnovel-write | Step 2 | 本章有战斗/对峙场景 | `--skill write --query "战斗描写" --genre {题材}` |
+| webnovel-write | Step 2 | 本章有多角色对话 | `--skill write --query "对话声线 口吻区分"` |
+| webnovel-write | Step 2 | 本章有情感/心理描写 | `--skill write --query "情感描写 心理"` |
+| webnovel-write | Step 2 | 本章涉及高频桥段 | `--skill write --table 场景写法 --query "{桥段类型}"` |
+| webnovel-write | Step 4 | ai_flavor issue 存在 | `--skill write --query "AI味 反例 替换"` |
+| webnovel-review | Step 4 | ai_flavor issue ≥ 3 | `--skill review --query "AI味 反例 替换"` |
+| webnovel-plan | 卷级规划 | always | `--skill plan --table 场景写法 --query "卷级结构 叙事功能"` |
+| webnovel-plan | 章纲拆分 | 新增角色出现 | `--skill plan --table 命名规则 --query "角色命名" --genre {题材}` |
+| webnovel-init | 起名采集 | 用户设定角色/书名/势力名 | `--skill init --table 命名规则 --query "{命名对象} {题材}" --genre {题材}` |
+
+## 无独立 reference 需求的 skills
+
+| Skill | 说明 |
+|-------|------|
+| webnovel-query | 参考需求主要是项目私有知识（CLI、数据源），已内联 skill |
+| webnovel-dashboard | P2，当前功能自洽，不挂独立 reference |
+| webnovel-learn | P2，分类规则可内联 skill |