@lemoncat7/dsh-partner 2.8.1 → 2.8.2

package/resources/skills/story-creation/upstream/skills/story-long-write/references/project-files.md

@@ -0,0 +1,114 @@
+# 项目文件与产物协议
+
+#### 项目文件结构
+
+需落盘时在用户指定目录按下表组织；只讨论不建工程，仅规划只创建本次产物所需目录，不为凑齐目录树生成正文或追踪：
+
+```
+{书名}/
+├── 设定/
+│   ├── 世界观/
+│   │   ├── 背景设定.md        # 时代背景、地理、历史
+│   │   ├── 力量体系.md        # 修炼/能力/等级体系
+│   │   └── ...
+│   ├── 角色/
+│   │   ├── 沈栀.md            # 每个人物一个文件，文件名用角色名
+│   │   └── ...
+│   ├── 势力/
+│   │   ├── 天机阁.md          # 每个势力/组织一个文件
+│   │   └── ...
+│   ├── 关系.md                # 角色关系映射
+│   ├── 题材定位.md            # 题材核心梗+对标分析+终局底牌/升级台阶（防写无可写）
+│   └── 题材正文提示卡.md       # 题材正文核心：边界/期待/爽点/节奏/禁漂移
+├── 大纲/
+│   ├── 大纲.md                # 全书卷级结构
+│   ├── 卷纲_第一卷.md         # 每卷一个：卷契约+故事线+剧情单元卡+情绪弧线+人物弧线+伏笔+反转
+│   ├── 排纲底稿_L1-01.md      # 每单元一份：供给自查+建纲追加
+│   └── 细纲_第001章.md        # 每章一个：九个必填字段+四个小节+结尾设定和钩子
+├── 正文/
+│   ├── 第001章_章名.md
+│   └── ...
+├── 对标/                          ← 拆文产出的结构化资产
+│   └── {对标书名}/
+│       ├── 原文/
+│       │   ├── 第001章_章名.md
+│       │   └── ...
+│       ├── 角色/                  ← 从拆文库/结构化输出同步
+│       │   └── {角色名}.md
+│       ├── 剧情/                  ← 从拆文库/结构化输出同步
+│       │   ├── {剧情单元名}.md
+│       │   ├── 故事线.md
+│       │   ├── 节奏.md             # 关键信息推进 + 情绪触动点 + 爆发节奏（权威节奏索引）
+│       │   └── 情绪模块.md         # 读者需求/情绪引擎 + 可复现模块（权威模块索引）
+│       ├── 设定/                  ← 从拆文库/结构化输出同步
+│       │   ├── 世界观/             ← 按主题拆分到子目录
+│       │   │   ├── 背景设定.md
+│       │   │   ├── 力量体系.md
+│       │   │   ├── 地理.md
+│       │   │   └── 金手指.md
+│       │   └── 势力/
+│       │       └── {势力名}.md
+│       └── 拆文报告.md
+├── 追踪/
+│   ├── _tracking-state.json        ← 唯一结构化权威状态
+│   ├── 上下文.md                  ← 派生续写状态卡（固定 7 栏），≤12KB
+│   ├── 逐章记录/第NNN章.md          ← 未来相关紧凑记录，≤3072 字节
+│   ├── 角色状态/{角色名}.md         ← 派生核心角色当前快照
+│   ├── 伏笔.md                    ← 派生伏笔当前视图
+│   └── 时间线/{作者真相.md,读者已知.md}
+├── 参考资料/
+│   └── {topic}.md             # story-researcher 输出的研究资料
+├── .story/work/第NNN章/        ← 本章临时文件（分组 segment、prompt 留档、事务 JSON），提交后自动删除
+```
+
+**产物映射表**（创建模板详见 [references/artifact-protocols.md](artifact-protocols.md)）：
+
+| 文件 | 粒度 | 创建阶段 | 读取时机 |
+|------|------|---------|---------|
+| 设定/关系.md | 全书 | Phase 2 | 按需：story-explorer relationship 查询、story-review 查设定（不在每章写作回路里逐章读） |
+| 设定/题材定位.md（含 `主对标书` 字段，多对标时必填） | 全书 | Phase 1 建，Phase 2 补全 | Phase 3 大纲、每卷开始前、Phase 4 写前召回 |
+| 设定/题材正文提示卡.md | 全书/题材 | 写第 1 章前由写前召回生成（导入项目可能已有） | Phase 4 每章写作前：按 `genre-prose-cards.md` 索引匹配后读取 `genre-prose-cards/` 目录对应单题材卡优先、`style-genre-modules.md` 通用模块兜底，与通用正文要求、情绪/节奏召回和文风一起组装 prompt |
+| 设定/角色/{角色名}.md、设定/势力/{名}.md | 角色/势力 | Phase 2 建主角与关键角色；Phase 3 细纲后增量补全 | Phase 4 状态筛选/写作 |
+| 设定/文风.md（自定义文风·优先级最高） | 本书 | 用户自写（Claude Code 可代写）；导入/拆解不覆盖 | Phase 4 每章写作前：含实质内容则取代对标文风作权威风格基 |
+| 对标/{书名}/文风.md | 对标书 | analyze Stage 6 输出 → story-import 显式绑定或本 skill 首次引用时同步 | Phase 4 每章写作前（文风召回；有自定义文风时降为参考/句长兜底） |
+| 大纲/卷纲_第X卷.md | 卷 | Phase 3 | **一律走取段器 `outline_view.py --unit/--contract/--toc`，不整读**（见「路径与术语约定」）；段位契约与 checker 见 artifact-protocols.md |
+| 大纲/排纲底稿_{单元ID}.md | 剧情单元 | Phase 3；正文「细纲没给」追加进「建纲追加」 | 只在排纲/补纲时读 |
+| 追踪/_tracking-state.json | 全书 | 首次写正文前初始化（规划阶段不建） | 唯一结构化权威，不进正文 prompt；每章运行 `tracking_commit.py check` 读取章号和修订号 |
+| 追踪/伏笔.md | 全书当前视图 | 与 state 同时初始化 | 续写状态卡缺项时按 ID 定点查询；每 ID 只一行 |
+| 追踪/时间线/{作者真相.md,读者已知.md} | 全书当前事实/认知派生视图 | 与 state 同时初始化 | 按作者真相或读者认知的实际问题选择视图 |
+| 对标/{书名}/拆文报告.md | 对标书 | 用户手动+analyze | Phase 2 核心设定、Phase 3 大纲、Phase 4 写作 |
+| 追踪/逐章记录/第NNN章.md | 章 | Phase 4 每章事务 | 日更不读；目标 ≤1536 字节、硬上限 3072 字节，按需查询历史原因 |
+| 追踪/上下文.md（续写状态卡，≤12KB） | 全书当前状态 | 与 state 同时初始化 | 日更每章整份读；由事务工具整份重建，固定 7 栏 |
+| 参考资料/{topic}.md | 按需 | Phase 4（story-researcher 输出） | Phase 4 后续章节写作时复用 |
+| 追踪/角色状态/{角色名}.md | 核心角色 | 首次进入正文或导入初始化 | 久别角色按名读取一个小快照；目标 ≤4096 字节、硬上限 8192 字节；静态人设仍读 `设定/角色/` |
+| 对标/{书名}/角色/{角色名}.md | 对标书 | analyze 输出 | Phase 4 模块召回（角色参考） |
+| 对标/{书名}/剧情/{剧情单元名}.md | 对标书 | analyze 输出 | Phase 3 卷纲选段与细纲成批（剧情单元卡「对标剧情参照」）、Phase 4 模块召回（剧情模块参考） |
+| 对标/{书名}/剧情/情绪模块.md | 对标书 | analyze Stage 3 输出 → story-import 显式绑定或本 skill 首次引用时同步 | Phase 2 核心设定、Phase 3 大纲、Phase 4 每章写作前（读者需求 / 情绪引擎、可复现模块选择） |
+| 对标/{书名}/剧情/节奏.md | 对标书 | analyze Stage 3 输出 → story-import 显式绑定或本 skill 首次引用时同步 | Phase 3 大纲、Phase 4 每章写作前（关键信息推进、情绪触动点、爆发节奏参考） |
+| 对标/{书名}/设定/*.md | 对标书 | analyze 输出 | Phase 2 设定参考、Phase 4 世界观约束 |
+
+**缺失文件处理**：先按进度、报告总章数与逐章覆盖识别资料代际；当前契约缺项时显式修复，不拼装降级结果：
+1. **角色状态文件缺失** → 当前协议项目先运行 `tracking_commit.py check`，再重跑产生该状态的完整事务；已有正文但 `_tracking-state.json` 缺失时重新 `/story-import`。不得从前文临时推断后直接手写快照。
+2. **角色、普通剧情单元或设定等非主产物子目录缺失** → 按「对标书路径查找」查找项目视图与根目录数据源，仍缺失则跳过该可选模块。本条不适用于 `剧情/情绪模块.md` 和 `剧情/节奏.md`。
+3. **当前契约的 `剧情/情绪模块.md` / `剧情/节奏.md` 缺失** → 写前准备必须停下，设置 `missing_primary_contract: true` 并给出 `repair_action`：重跑 `/story-long-analyze` Stage 3+ 或重新 `/story-import`，不得用摘要文件假装已召回权威模块。
+4. **有对标书但 `文风.md` 缺失** → 若有 `设定/文风.md`（含实质内容）走自定义文风模式继续；否则日更文风召回 fail-fast，提示先运行 `/story-long-analyze` Stage 6 并 `/story-import` 同步。**完全无对标项目**则跳过文风召回、不阻塞（有 `设定/文风.md` 时用它写作）。情绪/节奏轴（`missing_primary_contract`）独立，自定义文风模式不豁免其 fail-fast。
+5. **伏笔/时间线文件缺失** → 视为当前状态损坏，停止写正文；先运行 `tracking_commit.py check`，再用事务修复。卷纲/大纲中的计划不能代替已发生的事实。
+6. **`设定/题材正文提示卡.md` 缺失** → 不阻塞；写前从 `设定/题材定位.md` 精确匹配 `references/genre-prose-cards.md` 索引，并只读取 `references/genre-prose-cards/` 中对应题材单卡（高/中/低置信照原卡标注），无命中再用 `references/style-genre-modules.md` 通用流派模块即时生成短 `genre_prose_card`。只有 `设定/题材定位.md` 也缺失时，退回细纲和目标平台做低置信题材卡，并在意图确认写明。
+
+**对标分析权威优先级（权威读取顺序）**：
+1. `剧情/情绪模块.md` 是读者需求 / 情绪引擎、爽文套路框架、可复现模块和重组指南的权威来源。
+2. `剧情/节奏.md` 是关键信息推进、章节扩写技法聚合、情绪触动点和爆发节奏的权威来源。
+3. `文风.md` 只管句长、标点、对话潜台词、原文锚点等风格；它不能覆盖情绪模块或节奏意图。**自定义文风 `设定/文风.md`（用户自写、不被导入/拆解覆盖）优先级高于对标 `文风.md`**：含实质内容时作权威风格基，对标文风降为参考与句长数值兜底；句长、停顿标点、视角与修辞按 `references/style-resolution.md` 裁决；段间空行等文件结构仍按交付协议，不把通用表达禁令称为硬安全线。
+4. `章节/第K章_摘要.md` 是具体章节证据，用来校验和补足权威索引，不反向覆盖 `情绪模块.md` / `节奏.md`。
+5. `拆文报告.md`、`剧情/故事线.md` 是投影/摘要；若与 `剧情/情绪模块.md` 或 `剧情/节奏.md` 冲突，写作以两个权威文件为准，并在写前准备 `gaps.conflict` 记录冲突来源。
+6. **公共灵感召回**（工作区有 `灵感库/` 时）按任务标签选 Top 3–8 张 active CBA；不传 IA/NM，不把灵感卡当风格样本；灵感卡只影响设计选择，与上述权威文件或细纲事实冲突时以后者为准。
+
+**文件组织原则：**
+- **人物一个一个文件**：`角色/角色名.md`，方便按需读取
+- **势力一个一个文件**：`势力/势力名.md`，组织/门派/家族/国家等
+- **世界观按主题拆分**：背景、力量体系、社会结构等各自独立
+- **细纲一章一个文件**：`细纲_第XXX章.md`，含钩子设计，与正文一一对应
+- **正文按章拆分**：每章一个文件，`第XXX章_章名.md`
+- 每章写完直接写入 `正文/` 目录，不要先输出到对话
+
+对标/ 下的文件由 `/story-long-analyze` 与 `/story-import` 产出；手写的对标摘要不能代替 `剧情/情绪模块.md`、`剧情/节奏.md` 两份主产物（缺了写前召回会停下）。

package/resources/skills/story-creation/upstream/skills/story-long-write/references/reader-contract-and-progression.md

@@ -0,0 +1,117 @@
+# 读者契约与终局储备
+
+本文件是 `story-long-write` 关于读者契约、主角代理权（叙事能动性/主导性）、利益安全与阶段推进的权威参考文件。洞察来自授权社区的避坑样本，是经验共识，不替代具体题材、平台和对标书判断。
+
+**安全边界**：本文件不得包含来源站点隐私数据、访问凭证、cookies、tokens、请求签名、私有标识符，或任何能反推出私域账号/请求环境的信息。
+
+## 0. 契约四问（排纲、写正文、批末核对只用这四问）
+
+1. 主角是不是靠自己的选择挣到了结果？（因果权 + 结算权，拿不准过「关键节点四问」）
+2. 核心收益或高光有没有被配角、机构或巧合无交换地拿走？（期待所有权、利益安全）
+3. 有没有动用本阶段还不该解锁的终局底牌，或把某条升级线顶到天花板？（终局储备、透支两问）
+4. 旧期待付了利息没，又给读者留了什么期待？新地图、新机构、新谜团有没有被拿来逃避旧承诺？（期待债、换书债）
+
+四问都过＝契约安全；有一问勉强但能靠铺垫/交换/成本补上＝需补强；补不上＝契约破坏。答不上来的那问再读下面对应小节。
+
+## 1. 核心概念
+
+### 读者契约
+- 读者契约 = 开篇、题材、主角配置、叙事口吻共同许诺的阅读快感。
+- 写作前先确认：读者是来看主角解决问题、见证团队群像、看导师托举后辈，还是看制度合作建设？不同契约下同一情节风险不同。
+
+### 主角代理权：因果权 + 结算权
+- 主角代理权首先看**因果权 + 结算权**，不看出场时长，也不要求主角永远亲自动手或垄断每个镜头。
+- 主角不可替代首先体现为因果权：主角通过决策、布局、授权、不可替代的信息/资源，或主动选择关键后果，决定事情为什么发生、如何进入与怎样转向。
+- 结算权 = 核心收益、认可、权力或关键后果依照既有承诺回到应得者。可以借力、组队、被救、接受指导或让他人执行局部动作，只要因果与结算没有被无声夺走。
+- 职业/权力幻想题材尤其敏感：读者通常期待主角掌握资源、做出决策、承担或选择后果并拿回可见收益。
+- 题材例外（直给爽文）：番茄战神/赘婿/打脸/都市异能等，主角亲自出手、当面碾压本身就是契约兑现，代理权不能拿来给主角划水、让下属封神；只有布局/权谋/经营/群像/导师题材才默认可幕后运筹、隔人兑现。
+
+### 期待所有权
+- 承诺的兑现/高光属于本卷或本单元已经许诺的主角或其他承诺所有者；配角可以执行局部动作，但不能无声夺走期待所有权。
+- 群像、导师或制度合作可把期待所有权明确给团队成员/学生/机构角色；关键是预先承诺、按约结算，而非事后解释抢戏合理。
+
+### 关键节点四问
+第一问拿不准时逐条问（可指向本卷已承诺的其他所有者）：
+1. 谁决定事情为什么发生/如何进入？
+2. 谁作出不可替代的关键选择？
+3. 谁承担或选择关键后果？
+4. 核心收益/认可/权力最终结算给谁？
+
+### 利益安全与兑现归属
+- 利益安全 = 读者相信自己追的核心卖点不会被没收、稀释、转赠或交给无关角色消化。
+- 兑现归属 = 谁铺垫、谁承压、谁选择，谁就应拿到主要情绪回报；旁观者/配角反应可以放大爽点，不能替代主角爽点。
+- 核心资产（金手指、关键资源、身份底牌、独家技术、关键证据）不得无交换地交出、暴露给外部机构或被上级接管。若必须交出，需要可见交换：权力、保护、资源、渠道、名分、债权、信息、阶段胜利或更大局面的主动权。
+
+### 期待债
+- 每次埋承诺（主角会反击、资源会升级、身份会揭开、感情会推进）都产生期待债。
+- 期待债可以延期，但要付利息：阶段性进展、新信息、局势变化、情绪释放或更清晰的下一目标。
+- 用解释、设定或机构流程拖延兑现，会增加合理化债务。
+
+### 终局储备与推进节奏
+
+“写无可写”的病根是两类**宏观资源**被提前打光，跟单章涨多少关系不大。管住这两类、放开单章密度，才既不透支又不憋屈。
+
+**两类会打光的宏观资源（开书时定，逐卷解锁）**
+- **终局底牌**：头号宿敌、终极真相/身世、金手指上限、身份/地位终点、核心情感的最终确定。一次性资源，用了就没。开书时列进 `设定/题材定位.md` 的「终局底牌与升级台阶」小节，每项标最早可解锁的卷/阶段（从终局倒推成卷级里程碑，一卷只解锁一个大里程碑）。
+- **升级台阶**：境界/等级/地图/势力层级的剩余档数。开书时做一次台阶检查——体系档数 × 每档停留篇幅 ≥ 全书目标字数；台阶不够是设计病，设计期补（拉长体系/加地图层），不靠每章憋。敌人/目标/地图成**梯队**，逐级解锁，禁止越级提前秒顶级 boss / 解决终极目标。
+
+**单章 / 单个剧情单元放开密度（爽感来源，不要压）**
+- 每个剧情单元设 1 条**主推线**（战力线/资源线/身份线/关系线/信息线/地图线/制度线/势力线/事业线/情感确定性等升级线其一，承担本轮最大高潮），其余线按剧情自然给**战果**（轻触到大涨皆可）。**一战多得——一场大胜同时破境、缴获、收势力、涨声望、抱得美人——是允许且常见的好设计，该给就给。**
+- 章级推进按平台/题材分档：快节奏（番茄/爽文）保留“每章要有可见事件或爽点推进”的下限；慢热/种田/情感文才放宽到“改变目标 / 风险 / 信息 / 关系 / 资源 / 身份 / 情绪立场七类状态之一即可”。低压/过渡章用小而可见的变化承接，不强求每章高潮。
+- 高潮/兑现后可安排一段短暂低压，让读者先拿小而可见的收益/奖励，再进下一轮压力；不强制兑现后立即加危机。
+- 可选工具：行动成本/成功代价。重要成功可带时间、关系、暴露、资源消耗或新敌意等成本；低压/过渡/纯奖励章不强制附加代价。
+
+**推进过快判定（透支两问）**
+1. 是否动用了本阶段还不该解锁的终局底牌（宿敌了结、终极真相、身份终点、金手指触顶）？
+2. 是否让某条升级线逼近天花板、后面没台阶接？
+
+任一为“是” = 真正的透支预警 → 回退或改纲；两者皆否，多线齐涨放行。档位与里程碑按本书题材、平台与对标调整，不是硬门槛。
+
+### 合理化债务
+- 解释成本用于说明机构响应/接管、保密、资源调动、跨区执法、组织协作等为什么成立。
+- 检查：这些解释是否服务核心情绪？若解释本身吞掉爽点、代入或主角高光，就先缩短解释、改为可见交换，或把机构反应降级为旁观/阻碍/资源接口。
+
+## 2. 制度/机构与旁观者设计
+
+- 提到政府、宗门总部、跨国组织、多国公司等不天然有毒；它们只是高层级叙事开关。
+- 国家合作 / 政府合作类故事可以算契约安全，前提是开篇已承诺制度合作，主角保持不可替代，并获得可见权力、保护、资源、收益或更高行动权限。
+- 若本书承诺的是个人逆袭、职业掌控、独享金手指，外部机构接管核心问题通常需要强交换与主角主动选择。
+- 旁观者/反应层适合做：震惊、误判、舆论扩散、资源报价、敌我站队、见证主角选择。避免让旁观者替主角复仇、替主角做最终裁决、替主角拿核心收益。
+
+## 3. 契约风险三级
+
+| 等级 | 定义 | 处理 |
+|---|---|---|
+| 契约安全 | 与开篇题材契约一致；主角仍拥有关键选择/不可替代贡献；收益归属清楚 | 可写，注意把交换和收益可视化 |
+| 需补强 | 可能稀释主角高光或推进过快，但能通过铺垫、交换、成本、题材声明修复 | 写前补理由、补代价或调整为阶段性而非终局兑现 |
+| 契约破坏 | 没收核心卖点；自愿让渡同时造成**长期净收益为负 + 主角控制/因果权下降**（尤其没有可见战略交换）；无关角色夺走期待所有权；核心资产无交换上交或被接管 | 修纲；战略性让步可用局部聚光灯/资源换取更大控制、未来收益、关系/制度权力、信息优势，或兑现已承诺的群像/导师高光，不按让渡本身判红灯 |
+
+## 4. 好/坏例与例外
+
+### 职业/权力幻想主角自愿让出聚光灯
+- 红灯组合：让渡同时导致长期净收益为负、主角控制/因果权下降，且看不到战略交换；不是任何自愿让渡都算 契约破坏。
+- 好：主角授权下属执行，但方案、关键资源、最终谈判和风险承担由主角掌控；或用局部聚光灯/资源换取更大控制、未来收益、关系/制度权力、信息优势。下属表现反过来证明主角识人/组织能力。
+- 例外：若本书从开篇承诺“导师/经营组织/群像成长”，主角的高光可以是培养体系、选人眼光和关键兜底。
+
+### 给出资源或核心资产
+- 坏：主角把独家技术、金手指产物、关键证据无条件交给机构，换来口头感谢，后续由机构推进主线。
+- 好：主角交换到牌照、保护、渠道、话语权、独占收益或更大舞台，并保留不可替代的控制点。
+
+### 无关角色替主角复仇
+- 坏：压迫主角多章的敌人，被路过强者或随机事故解决，主角没选择、没出手、没获得认知/资源/地位变化。
+- 好：配角可以助攻或见证，但关键证据、布局、决断、公开裁决或最后反击由主角完成。
+- 例外：悲剧、悬疑、群像战争可让他人完成局部动作，但要让主角获得新的核心任务、代价或认知推进。
+
+### 提前打光终局储备（多线齐涨本身没问题）
+- 坏：一个剧情单元把全书级底牌一次性烧光——解决头号宿敌、揭终极身世、坐实终局身份、金手指直接触顶，后面没大目标可写。
+- 好：本单元让主角一战多得（破境+缴获+声望齐涨），但都在体系台阶之内、不碰终局底牌；宿敌只退一个梯队、真相只揭一层，大底牌留到后续卷偿还期待债。
+
+### 合法群像 / 导师故事例外
+- 群像契约：每个 POV 有自己的目标和偿还，主角不是唯一爽点来源；卷契约应写清谁在本卷拥有高光。
+- 导师契约：导师主角的高光在设计训练、识破困局、关键兜底、承担更高层代价，而不是每次亲手收割。
+- 制度合作契约：开篇即承诺国家/机构协作，主角以专家、指挥者、关键资源拥有者或不可替代执行者身份获得明确权力和收益。
+
+## 5. 续接与换书债
+
+- **换书债**：引入新地图、新机构、新能力、新敌人或新谜团，既要支付必要的铺垫成本，也会新增期待债；不能靠新鲜元素逃避旧承诺。
+- **题材特定高风险**：在履约爽文/能力幻想中，主角反复因愚蠢或可避免的无能制造灾难，再由别人收拾，会持续损害因果权、控制感和结算信任；这是依题材契约判断的高风险，不是所有故事的绝对禁令。

package/resources/skills/story-creation/upstream/skills/story-long-write/references/reference-index.md

@@ -0,0 +1,86 @@
+# 长篇参考资料索引
+
+## 参考资料索引
+
+按场景加载 workflow，以下技法按需补充。
+
+### Phase 1：选题方向
+
+| 场景 | 加载文件 |
+|------|---------|
+| 确定题材类型 | `references/long-genre-catalog.md` |
+| 判断市场方向 | `references/genre-readers.md` |
+| 特殊题材考量 | `references/plot-special-topics.md` |
+| 女频长篇（题材/文案/平台/感情线） | `references/female-audience-writing.md` |
+
+### Phase 2：核心设定
+
+| 场景 | 加载文件 |
+|------|---------|
+| 设定人物 | `references/character-basics.md` |
+| 设计关系 | `references/character-relations.md` |
+| 题材框架与定位 | `references/long-genre-catalog.md` + `references/long-genre-mechanics.md` |
+| 创建 artifact | `references/artifact-protocols.md` |
+| 读者契约与主角高光 | `references/reader-contract-and-progression.md` |
+
+### Phase 3：大纲搭建
+
+| 场景 | 加载文件 |
+|------|---------|
+| 搭建大纲 | `references/outline-methods.md` |
+| 设计矛盾与结构 | `references/outline-conflict.md` |
+| 深度结构设计 | `references/outline-structure-theory.md` |
+| 节奏与升级感 | `references/outline-rhythm.md` |
+| 小纲与卡文 | `references/plot-core-methods.md` |
+| 选择叙事框架 | `references/plot-frameworks.md` |
+| 题材结构 | `references/genre-prose-cards.md` 索引 + `references/genre-prose-cards/` 单题材卡 |
+| 黄金三章 | `references/opening-design.md` |
+| 情绪弧线 | `references/emotional-arc-design.md` |
+| 契约/终局储备/剧情单元契约四问 | `references/reader-contract-and-progression.md` |
+| 反转设计 | `references/long-reversal.md` |
+| 细纲结构检查 | `scripts/check-outline-contract.js`（新建/补建后跑，只判字段与表结构） |
+
+### Phase 4：正文写作
+
+| 场景 | 加载文件 |
+|------|---------|
+| 章节钩子 | `references/long-chapter-hooks.md` |
+| 悬念设计 | `references/long-suspense.md` |
+| 题材正文提示卡 / 题材分类卡 | `references/genre-prose-cards.md` 索引 + `references/genre-prose-cards/` 单题材卡目录（按题材分类优先） + `references/style-genre-modules.md`（通用流派补充） |
+| 打斗/装逼 | `references/style-combat-face.md` |
+| 写作技法 | `references/style-craft.md` |
+| 商业创作核心方法 | `references/commercial-core-methods.md` |
+| 对话 | `references/dialogue-mastery.md` |
+| 人物深化 | `references/character-design-methods.md` |
+| 情绪技法 + 叙事单元 | `references/plot-emotion-system.md` + `references/emotional-methods.md` |
+| 写作技法全程参考 | `references/writing-craft.md` |
+| 格式 | `references/long-format.md`（章节、段落、对话、标点与工程元信息） |
+| 当前剧情单元与契约校准 | `references/reader-contract-and-progression.md` |
+
+### Phase 5：质量检查
+
+| 场景 | 加载文件 |
+|------|---------|
+| 质量检查 | `references/long-chapter-quality.md` + `references/reader-contract-and-progression.md` |
+| 禁用词扫描 | `references/banned-words.md` |
+| AI句式脚本复扫 | `scripts/check-ai-patterns.js` |
+| 去AI味 | `references/anti-ai-writing.md` |
+
+### 按主题快速定位（横切主题）
+
+有些主题横跨多个阶段、散在多个文件里。下表给每个主题一个**权威文件**（先读它，通常够用），配套文件只在需要那个角度时再加载。括号是该文件里对应的小节。
+
+| 主题 | 权威文件（先读） | 配套文件（按角度补充） |
+|------|-----------------|----------------------|
+| 爽点（按意图分流） | **`references/plot-emotion-system.md`**（爽点设计体系：本质/六种类型/倒推法——"怎么设计爽点"先读这个） | 翻盘/高潮式爽点→`references/plot-core-methods.md`（假胜→崩解）· 打脸/装逼释放→`references/style-combat-face.md`· 题材声线与长线约束→`references/genre-prose-cards.md`· 爽文循环/多层→`references/outline-methods.md`·`references/outline-conflict.md` |
+| 情绪模块 | **`对标/{书名}/剧情/情绪模块.md`（项目/书级权威）**；排纲时设计新模块才读 `references/plot-emotion-system.md`（写正文无对标时取细纲与单元卡，不加读） | `references/outline-rhythm.md` 只作理论参考；不得覆盖对标书权威模块 |
+| 节奏 | **`对标/{书名}/剧情/节奏.md`（项目/书级权威）**；排纲时设计新节奏才读 `references/outline-rhythm.md`（写正文无对标时同上） | `references/plot-core-methods.md` 只作理论参考；不得覆盖对标书权威节奏 |
+| 高潮 | **`references/plot-core-methods.md`**（高潮构建公式：蓄能→假胜→崩解） | `references/outline-rhythm.md`（高潮分类与反推）· `references/outline-methods.md`（八节点故事结构：结构定位） |
+| 金手指 | **`references/plot-special-topics.md`**（金手指拆分理解与战力防崩 + 进阶设计） | `references/outline-conflict.md`（金手指与身份：四点统一） |
+| 感情线 | **`references/character-relations.md`**（好感度体系/四阶段 + 男女频差异；后宫文女主 / 男频极简爱情线构型也在这里） | `references/outline-conflict.md`（感情线设计）· `references/plot-special-topics.md`（爱情线提纯策略） |
+| 反转 | **`references/long-reversal.md`**（单元/卷级/全书反转、铺垫、有效性自检） | `references/plot-core-methods.md`（假胜：先给希望再击碎） |
+| 人物 | **`references/character-basics.md`**（主角/配角/反派/动机模板速填） | `references/character-design-methods.md`（三层标签反差/九维深化）· `references/character-relations.md`（关系类型/感情线） |
+| 女频写作 | **`references/female-audience-writing.md`**（女频长篇：核心原则/文案/题材/感情线长线/平台） | `references/genre-readers.md`（读者心理/平台差异）· `references/character-relations.md`（感情线总框架） |
+| 去AI味 | **`references/anti-ai-writing.md`**（AI指纹/核心规则/Show Don't Tell） | `references/banned-words.md`（禁用词扫描）· `references/long-chapter-quality.md`（成稿检查） |
+
+---

package/resources/skills/story-creation/upstream/skills/story-long-write/references/stop-and-fix.md

@@ -0,0 +1,9 @@
+# 写正文前缺东西：停下修
+
+workflow-chapter 或 workflow-daily 发现缺文件、追踪对不上时读。本轮不写正文，修好再从 workflow-chapter 步骤 1 开始；告诉作者时用 workflow-chapter「写不下去、要停下时」的问法。
+
+- **追踪检查不过**：按 `tracking_commit.py check` 的提示修。
+- **已有正文却缺 `_tracking-state.json`**：停止写作，请作者走 `/story-import`「旧追踪项目迁移」。（新书还没有正文时不算缺，按 workflow-chapter 开头初始化。）
+- **派生视图与 state 不一致**：按 [tracking-transaction.md](tracking-transaction.md) 为该章提交 `mode=revision` 事务整份重建，不手改、不继续下一章。
+- **登记了对标却缺情绪模块／节奏**：请作者用 `/story-long-analyze` 补拆。作者定了不对标不算缺。
+- **要找某类文件放哪**：读 [project-files.md](project-files.md) 照做。