@oh-story/dsh 0.1.10 → 0.1.12

package/lib/oh-story/skills/story-short-write/references/author-memory.md

@@ -1,6 +1,6 @@
 # 作者记忆协议
 
-作者记忆用于保存跨会话复用的创作偏好，不保存小说世界里的事实。它借鉴“原始证据 → 候选 → 已确认画像 → 变更记录”的记忆管道，但把决定权留给作者。
+作者记忆保存跨会话复用的创作偏好，不保存小说世界里的事实，决定权留给作者。本文件管最常见的时刻：作者说出一条偏好，或要确认、替换、忘掉某条。少见情况读 [author-memory-maintenance.md](author-memory-maintenance.md)：整理作者记忆与超编、画像写满、单书布局与 `state.book` 报错、存量迁移、多事件 `commit`、`check`、冲突候选落定、升级前的旧条目。
 
 ## 边界与优先级
 
@@ -17,61 +17,24 @@
 
 作者记忆不能把本书事实写进 `.story/作者记忆/`，不能覆盖当前请求，不能降低审稿 rubric，也不能让去 AI 味改动剧情意图。小说事实继续由各书的 `追踪/` 和 `设定/` 管理。
 
-## 文件与所有权
+## 存放与路由
 
-作者记忆分两级存放，记忆随书走：
+两级 store，记忆随书走：`{工作区}/.story/作者记忆/` 存 global / genre / workflow 条目（编号 `AP`），`{书}/.story/作者记忆/` 只存本书的 book 条目（编号 `BP`）。每级各有 `作者画像.md`（生效条目）和 `待确认.md`（候选，不参与约束），都从 state 生成，禁止手改；不存在时写作、审稿、去味照常继续，首次 `record` 自动创建。
 
-```text
-{工作区}/.story/作者记忆/          # 项目级 store：global / genre / workflow 条目，编号 AP
-├── _author-memory-state.json  # 唯一结构化权威
-├── 作者画像.md               # 仅 active，供作者查看与管理
-├── 待确认.md                 # pending / conflict，不参与约束
-└── 变更记录.md               # 最近 100 次、最新在前的事务记录
-{书}/.story/作者记忆/            # 书级 store：只存这本书的 book 条目，编号 BP，同样四个文件
-```
-
-三个 Markdown 文件都从 state 确定性生成，禁止手改；完整历史保留在 state，变更记录只展示最近 100 次。`作者画像.md` 是人类管理视图，普通写作 agent 不整份注入，而是调用 `query` 取得本次相关的紧凑上下文。作者记忆不存在时，普通写作、审稿和去味任务直接继续，不自动初始化空目录；首次 `record` 会随事务创建。
-
-**定位规则**：`--workspace` 必须显式传给脚本，指创作工作区根——承载多本书、`.active-book`、`长篇/`、`短篇/` 或 `拆文库/` 的那一层；已有记忆时，是项目级 state（不带 `book` 字段）所在的最近祖先。书目录自己的 `.story/作者记忆/` 是书级 store，`长篇/`、`短篇/` 下的书目录永远不当 `--workspace`；不要把用户主目录当默认工作区。`--book-root` 是当前书的项目目录（`.active-book` 指向、或含 `设定/`、`正文/` 的那一层，如 `{工作区}/长篇/{书名}/`）；书名默认取书级 state 记录的名字，首次建立时取目录名，`--book` 可覆盖。
-
-**单书布局**：书根就是工作区（`--book-root` 与 `--workspace` 同一目录）时，书级 store 改住 `{工作区}/.story/作者记忆/书级/`，与项目级各自一份 state；首次建立的书名优先取项目级存量本书条目里唯一的书名，再取目录名。旧版曾把书级 state 写在项目级位置，此后项目级读写都报 `state.book`；带 `--book-root {工作区}` 运行任一命令（含 `query`）会先把它原样移进 `书级/`，不改内容。这个目录其实是某个工作区里的一本书时（上一层叫 `长篇/` 或 `短篇/`，或某个祖先有 `.active-book` 或项目级 state），工具直接报错、不动任何文件，按报错改传 `--workspace`。
-
-**路由规则**：ID 前缀就是 store——`decide` / `forget` 看 `item_id`（`AP` 进项目级，`BP` 进书级），`remember` / `replace` 看 `scope.level`（`book` 进书级，其余进项目级）。书级操作必须传 `--book-root`，没传直接报错，不会退而写进项目级。一份 `commit` 事务只能写一个 store；`replace` 与 `conflicts_with` 不能跨 store——本书例外按优先级覆盖全局规则，不算冲突，直接 `remember` 为 book 条目即可；要把全局规则改成本书规则，拆成 `forget` ＋ `remember` 两个事件。
-
-**存量迁移，不做双读**：升级前写进项目级 store 的 book 条目不再参与查询与预算估算，也不再接受新的 book 写入；它们仍在 `作者画像.md` 里可见、可 `decide` / `forget`。对每本书运行一次 `migrate --book-root {书目录}` 即可整批搬回来：断言、证据、确认次数、重要度原样保留，换成 `BP` 编号，原 `AP` 条目标 `superseded` 并注明去向；与全局条目的冲突关系在迁移后不再成立，这类候选退回 `pending`。书级每个源条目一笔事务，重跑只补没做完的一半。「整理作者记忆」看到项目级画像里还有「本书：」条目时，把迁移列为默认提案项。
-
-## 什么时候读取
-
-长篇、短篇、去 AI 味开始前，如果 state 已存在，用 `query` 按本书、题材、流程和类型筛选 active 条目：结果是项目级 store 与 `--book-root` 所指书级 store 的合并；不传 `--book-root` 就拿不到任何本书条目。查询输出固定不超过 2048 字节。`--kind` 必传——不传直接报错，不再默认返回全部类型；按任务直接选择 kind：
+- `--workspace` 必须显式传，指创作工作区根——承载多本书、`.active-book`、`长篇/`、`短篇/` 或 `拆文库/` 的那一层；已有记忆时，是项目级 state（不带 `book` 字段）所在的最近祖先。`长篇/`、`短篇/` 下的书目录永远不当 `--workspace`，也不要把用户主目录当默认工作区。
+- `--book-root` 是当前书的项目目录（`.active-book` 指向、或含 `设定/`、`正文/` 的那一层，如 `{工作区}/长篇/{书名}/`）；书名默认取书级 state 记的名字，首次取目录名，`--book` 可覆盖。书根就是工作区时读维护文件「单书布局」。
+- ID 前缀就是 store：`decide` / `forget` 看 `item_id`（`AP` 项目级，`BP` 书级），`remember` / `replace` 看 `scope.level`（`book` 书级，其余项目级）。书级操作必须传 `--book-root`，没传直接报错，不会退而写进项目级。
+- `replace` 与 `conflicts_with` 不能跨 store：本书例外按优先级覆盖全局规则，不算冲突，直接 `remember` 为 book 条目；要把全局规则改成本书规则，拆成 `forget` ＋ `remember` 两个事件。
 
-| 任务 | query kinds | 注入位置 |
-|---|---|---|
-| 正文初稿 / 续写 | `prose_style` + `story_design` | 主会话与实际正文 agent |
-| 去 AI 味 / 改写 | `prose_style` | 主会话与实际改写 agent |
-| 设定 / 大纲 | `story_design` + `workflow` + `interaction` | 主会话，不传正文 agent |
-| 审稿 | `delivery` + `interaction` + 必要的 `prose_style` | 主会话，不降低 rubric |
+## 查询
 
-审稿匹配项只用于交付格式、协作方式和“作者有意采用的表达选择”说明；问题严重度和 PASS/FAIL 仍由 rubric 决定。
+各 skill 入口已写好本任务的 `query` 命令（长篇正文由组装脚本代查）；没写命令的长篇设定、大纲等任务查 `story_design` + `workflow` + `interaction`，结果只给主会话、不传正文 agent。四类任务的映射表见维护文件。state 存在才查（两级都不存在时返回空结果、零写入）；结果合并项目级与 `--book-root` 所指书级（不传就拿不到本书条目），`--kind` 必传，输出不超过 2048 字节。
 
-待确认项不进入 prompt 约束，也不应为了确认它们中断当前任务。只有用户主动查看作者画像、候选积累到适合回顾的节点，或新偏好与 active 条目冲突时，才集中呈现。
+普通创作只做一次本地 `query`，完整画像、证据、候选和 journal 不进 prompt。查询项是低优先级倾向，不是逐条打卡清单：自然吸收，不复述画像、不刻意提高词面命中率，不为命中牺牲连贯、节奏、字数或本书既定笔调。**`omitted_ids` 非空＝记忆超编**，不是「没有更多了」：转告作者并建议「整理作者记忆」，不得改读完整画像规避预算。待确认项不进 prompt，也不为确认它们中断任务；只在作者主动查看、候选积累到适合回顾的节点，或新偏好与 active 条目冲突时集中呈现。
 
-## 可靠性与负荷边界
+## 记不记、记成什么
 
-- 明确“记住 / 确认 / 替换 / 忘掉”的请求走单事件 `record`，不要求 agent 手工读取修订号或拼多操作事务。成功响应会给出 `Author Memory Receipt: rN · APxxx`；没有回执就不得声称“已经记住”。怎么告诉作者见「回执怎么告诉作者」。
-- 普通创作只做一次本地 `query`，没有 state 时返回空结果且不创建文件；有记忆时也只返回相关 active 条目，硬上限 2048 字节。完整画像、证据、候选和 journal 不进入正文 prompt。
-- **写入不因注入预算失败**：`record` / `commit` 照常成功、给回执；工具按上表四类任务组合估算最坏查询情形（全局条目＋各 scope 维度最重的单一切片，切片按大小写无关归并、轻重按写作时真正读到的字段算，与真实查询同一把尺），装不进 2048 字节的组合在返回的 `warnings` 里点名将被略过的条目及其断言首句。收到提醒就用白话转告作者并建议「整理作者记忆」。写入落盘后另一级 store 读不出来（书目录不存在、`--book` 与书级记录不符等）也照常给回执，`warnings` 注明本次提醒没算上它——已有回执就是已记住，不要换 `event_id` 重试。写书级条目时「本书＋全局」按实际条目精确计算；写项目级条目时只看得到项目级 store，顺手传 `--book-root` 就把当前这本书也算进提醒。查询按 **重要度 → 本书例外 → 最近更新** 排序装填（同一范围的条目必在同一 store，「最近」按该 store 的修订号比，不跨 store 比较），先丢的恒是重要度较低的条目——`importance` 决定超编时谁留在 prompt 里，写入时按偏好的实际分量填，不要一律 `high`。
-- 注入预算之外还有一道硬上限：`作者画像.md` 超过 12288 字节时写入会直接失败并要求先整理。active 条目攒到几十上百条才会碰到（远在注入预算之后），碰到就走「整理作者记忆」；`forget` 这类减量操作在满编时照常可用。
-- 查询项是低优先级倾向，不是逐条打卡清单。自然吸收即可，不复述画像、不刻意提高词面命中率，也不得为命中偏好牺牲正文连贯、节奏、字数或本书既定笔调。
-- 不安装会记录全部用户消息的 prompt hook，也不在作者没开口时观察他：不从反复修改、成稿或操作轨迹推断偏好写入。只记作者明确表达的偏好；自然语言是否属于长期习惯仍需 agent 判断，拿不准就只执行不记录。需要确定写入时，用户可明确说“记住：……”，并以回执验收。
-
-## 回执怎么告诉作者
-
-回复就两行纯文本，不加代码块或引用格式：第一行用一句人话说记住了什么、管哪本书或哪类场合，如「记住了：《{书名}》的对话一律用「」，以后写这本书都照这个来；想改随时说。」；第二行是机器回执作凭证，如「技术备注：Author Memory Receipt: r1 · BP001」。
-
-- 确认、替换、忘掉同理：「好，这条生效了：……」「换成了：……，原来的「……」不再用」「忘掉了：……」。只进待确认时说「这条先记在待确认里，你说"确认"才生效」；有冲突时用原话说明跟哪条旧习惯冲突。
-- `warnings` / `omitted_ids` 不原样贴：说「你的习惯攒得有点多，写正文时这几条可能顾不上：「……」」，并建议说「整理作者记忆」。不提字节、prompt、kind、scope；编号只能跟着原话出现。
-
-## 捕获判定
+不装记录全部用户消息的 prompt hook，不在作者没开口时观察他，只记作者明确表达的偏好。是否属于长期习惯由 agent 判断，拿不准就只执行不记录；作者可明说“记住：……”，以回执验收。
 
 | 输入证据 | 处理 |
 |---|---|
@@ -83,59 +46,44 @@
 | 角色、时间线、伏笔、世界观、当前剧情走向 | 写项目设定/追踪，不写作者记忆 |
 | 助手自己生成的文字、默认模板、工具告警、rubric 结论 | 不自我学习 |
 
-保留用户的否定词、限定词和适用范围，`quote` 写原话，`assertion` 只做不改变语义的紧凑归纳，**新建条目限一句话（≤120 字节，约 40 个字）**；需要解释的背景写进 `reason`（不进 prompt 载荷），不另开字段。
-
-**一条偏好就是一条记录，例外和限定不许拆出去单列。** 「以后少用破折号，对话里也别用，除非表示打断」是一条带例外的偏好，必须整条写成一个 `assertion`（「破折号少用、对话里也不用，只在表示打断时保留」）。超编时条目是逐条被丢的，把「除非表示打断」拆成独立一条，就可能只丢掉例外、把作者明说过的限定变成送进正文的绝对禁令。只有原话确实塞了**几条互不依赖**的偏好（如「多用短句」＋「章末留钩子」）才拆成几条。整句写不进 120 字节时压缩措辞，不要切掉限定词。
+保留否定词、限定词和适用范围：`quote` 写原话，`assertion` 只做不改变语义的紧凑归纳，**新建条目限一句话（≤120 字节，约 40 个字）**，写不下就压缩措辞、不切限定词；背景写进 `reason`（不进 prompt），不另开字段。
 
-升级前写下的长断言不受新上限约束：原样重申它会**强化**原条目（确认次数 +1），不会因超长被拒；只有真正新建条目才校验 120 字节。
+**一条偏好就是一条记录，例外和限定不许拆出去单列。** 「以后少用破折号，对话里也别用，除非表示打断」整条写成「破折号少用、对话里也不用，只在表示打断时保留」：超编时条目逐条被丢，拆开就可能只丢掉例外，把作者说过的限定变成绝对禁令。只有原话塞了**几条互不依赖**的偏好（如「多用短句」＋「章末留钩子」）才拆。
 
-范围规则：
+范围：“本书 / 这个角色 / 这次连载” → `book`；“都市文 / 这类题材” → `genre`；交稿、检查、确认节奏等操作习惯 → `workflow`；“以后 / 一贯 / 我习惯”且无更窄限定 → `global`；含糊但可能稳定 → 最窄合理范围并置 `pending`。
 
-- “本书 / 这个角色 / 这次连载” → `book`；
-- “都市文 / 这类题材” → `genre`；
-- 交稿、检查、确认节奏等操作习惯 → `workflow`；
-- “以后 / 一贯 / 我习惯”且无更窄限定 → `global`；
-- 范围含糊但可能稳定 → 取当前最窄合理范围并置 `pending`。
+类型：`prose_style`、`story_design`、`workflow`、`delivery`、`interaction`。置信度与重要度均为 `low | medium | high`；超编时先丢重要度低的，按偏好的实际分量填，不要一律 `high`。`source` 只接受 `explicit_user`、`accepted_suggestion`、`manual`，工具拒绝推断类来源。
 
-类型可选：`prose_style`、`story_design`、`workflow`、`delivery`、`interaction`。置信度与重要度均为 `low | medium | high`。`source` 只接受 `explicit_user`、`accepted_suggestion`、`manual`；工具会拒绝推断类来源，存量 state 里的旧来源条目照常可读、可确认、可退役。
+## 确认、替换、忘掉与冲突
 
-## 冲突、撤回与强化
+- 同一类型、范围、归纳文本再出现，脚本强化原条目（累加证据与确认次数），不重复建条。
+- 新偏好与同一 store 的 active 条目矛盾：以 `conflict` 记候选，`conflicts_with` 列冲突 ID，本轮仍按当前要求执行；本书例外与全局规则不算冲突。冲突候选不能直接 activate，落定见维护文件「冲突候选」。
+- pending 用 `decide=activate|reject`。同一范围的规则改版用 `replace`，新条目启用、旧条目标 `superseded`；只有作者明确撤销或改变旧规则范围才跨范围替换。
+- 作者说“忘掉 / 这不再是我的习惯”用 `forget`，保留历史证据但不再加载。active 条目的语义不可原地偷改，语义变化必须 replace，历史才可审计。
 
-- 同一类型、范围、归纳文本再次出现时，脚本强化原条目，累加证据和确认次数，不重复建条目。
-- 新偏好与同一 store 里的 active 条目矛盾时，先以 `conflict` 记候选，并在 `conflicts_with` 列出冲突 ID；当前任务仍按本轮明确要求执行。本书例外与全局规则不算冲突。
-- 同一范围的规则改版用 `replace`，启用新条目并将旧条目标成 `superseded`。本书例外用 `remember` 新建 book 条目（传 `--book-root`），保留 global 习惯；只有作者明确撤销或改变旧规则范围时才跨范围替换，跨 store 时拆成 `forget` ＋ `remember`。
-- pending 可以用 `decide=activate|reject`；冲突候选不能绕过旧规则直接 activate。
-- 作者说“忘掉 / 这不再是我的习惯”时用 `forget`，保留历史证据但不再加载。
-- active 条目的语义不可原地偷改；语义变化必须 replace，历史才可审计。
+## 回执怎么告诉作者
 
-## 整理作者记忆
+回复就两行纯文本，不加代码块或引用格式：第一行用一句人话说记住了什么、管哪本书或哪类场合，如「记住了：《{书名}》的对话一律用「」，以后写这本书都照这个来；想改随时说。」；第二行是机器回执作凭证，如「技术备注：Author Memory Receipt: r1 · BP001」。
 
-作者说「整理作者记忆」，或回执 `warnings`／查询 `omitted_ids` 提示超编时：读项目级与当前书的 `作者画像.md`（每条都标了范围、重要度、把握和确认次数，重要度就是超编时的去留依据），提出合并同义条（`replace` 多合一）、退役过时条（`forget`）、给错标成 `high` 的条目下调重要度、把超长断言压缩成一句话的提案；项目级画像里还有「本书：」条目时，「对该书运行 `migrate --book-root`」列为默认提案项。清单用原话逐条列给作者确认（编号只放括号里），确认后按 store 各汇成一份 `commit` 事务提交（一份事务只写一个 store）。合并时保住每条的否定词、限定词和适用范围——合不动就退役其中一条，不要靠删限定词把两条凑成一条。整理只由作者发起或确认，不自动执行。
+- 确认、替换、忘掉同理：「好，这条生效了：……」「换成了：……，原来的「……」不再用」「忘掉了：……」。只进待确认时说「这条先记在待确认里，你说"确认"才生效」；有冲突时用原话说明跟哪条旧习惯冲突。
+- `warnings` / `omitted_ids` 不原样贴：说「你的习惯攒得有点多，写正文时这几条可能顾不上：「……」」，并建议说「整理作者记忆」。不提字节、prompt、kind、scope；编号只能跟着原话出现。
 
 ## 运行工具
 
-先依次尝试 `python3`、`python`、`py -3` 找到 Python 3，再从当前 skill 根运行本地副本：
+依次尝试 `python3`、`python`、`py -3` 找到 Python 3，从当前 skill 根运行本地副本：
 
 ```text
-{PYTHON} {当前 skill 根}/scripts/author_memory_commit.py init    --workspace {工作区} [--book-root {书目录}]
-{PYTHON} {当前 skill 根}/scripts/author_memory_commit.py record  --workspace {工作区} [--book-root {书目录}] --input {工作区}/.story/work/作者记忆-事件.json
-{PYTHON} {当前 skill 根}/scripts/author_memory_commit.py query   --workspace {工作区} --book-root {书目录} --kind {类型}（必传，可重复） [--genre {题材}] [--workflow {流程}]
-{PYTHON} {当前 skill 根}/scripts/author_memory_commit.py commit  --workspace {工作区} [--book-root {书目录}] --input {工作区}/.story/work/作者记忆-事务.json
-{PYTHON} {当前 skill 根}/scripts/author_memory_commit.py migrate --workspace {工作区} --book-root {书目录}
-{PYTHON} {当前 skill 根}/scripts/author_memory_commit.py check   --workspace {工作区} [--book-root {书目录}]
+{PYTHON} {当前 skill 根}/scripts/author_memory_commit.py record --workspace {工作区} [--book-root {书目录}] --input {工作区}/.story/work/作者记忆-事件.json
+{PYTHON} {当前 skill 根}/scripts/author_memory_commit.py query  --workspace {工作区} --book-root {书目录} --kind {类型}（必传，可重复） [--genre {题材}] [--workflow {流程}]
 ```
 
-所有子命令都可加 `--book {书名}` 覆盖书名；正在写某本书时一律带上 `--book-root`，书级操作没有它会直接报错。事件与事务 JSON 写在 `{工作区}/.story/work/` 下（不写系统 `/tmp`），成功后删掉；`book` 条目的 `scope.value` 填书名（书级 store 已记着书名就用它，首次取书目录名）。
-
-- `record`：常用单事件入口，按路由规则落到项目级或书级 store，自动读取该 store 的当前修订、首次自动初始化；`event_id` 相同且内容相同会幂等返回原回执，内容不同会失败。原样重申已有条目的 `assertion` 会强化该条（不受 120 字节新建上限约束）。返回里的 `store` / `book` 说明写到了哪一级，`warnings` 是预算提醒，按「回执怎么告诉作者」用白话转告。
-- `query`：只读相关 active 条目，项目级与书级合并返回；`--kind` 必传、可重复，两级 state 都不存在时返回空结果且零写入。输出按 重要度 → 本书例外 → 最近更新 排序装填；装不下的条目跳过而不中断（一条长的不挡后面的短条），漏下的 ID 按同一优先级报进 `omitted_ids`（最多列 20 条，`omitted` 是真实总数）。**`omitted_ids` 非空＝记忆超编**——转告作者并建议「整理作者记忆」，它不是「没有更多了」，也不得改读完整画像规避预算。
-- `commit`：高级批量入口；一份事务只写一个 store，先在内存完成 schema、引用、容量和所有视图校验，最后原子替换 state。事务文件在成功前必须保留；过期修订会在任何写入前失败。
-- `migrate`：把项目级 store 里某本书的存量 book 条目整批搬进 `--book-root` 的书级 store，幂等，中途失败直接重跑；返回 `migrated`（源→新编号），没有存量时为空。
-- `check`：从 state 重建并逐字核验所有派生视图；传 `--book-root` 时两级一起核验。
+- 子命令都可加 `--book {书名}`；写某本书时一律带 `--book-root`。事件 JSON 写在 `{工作区}/.story/work/`（不写系统 `/tmp`），成功后删掉；book 条目的 `scope.value` 填书名（书级 store 已记的名字，首次取目录名）。
+- 明确的“记住 / 确认 / 替换 / 忘掉”都走单事件 `record`：自动读该 store 当前修订、首次自动初始化，不手工读修订号或拼多操作事务。同一 `event_id` 同内容幂等返回原回执，内容不同则失败；返回的 `store` / `book` 说明写到了哪一级。
+- 成功才有 `Author Memory Receipt: rN · APxxx`，没有回执不得声称“已经记住”。**写入不因注入预算失败**：`warnings` 只是提醒（另一级 store 读不出来也在这里注明），按上节转告；有回执就是已记住，不要换 `event_id` 重试。
 
-## 事务格式
+## 事件格式
 
-常用单事件新增或强化：
+新增或强化（`record` 输入；book 范围传 `--book-root`）：
 
 ```json
 {
@@ -147,11 +95,11 @@
       "kind": "prose_style",
       "scope": {"level": "global", "value": null},
       "assertion": "对话尽量短，用动作承接情绪，不用大段解释",
-        "quote": "以后对话都短一点，情绪放动作里，别让角色长篇解释。",
-        "source_ref": "conversation:2026-08-25",
-        "source": "explicit_user",
-        "confidence": "high",
-        "importance": "high",
+      "quote": "以后对话都短一点，情绪放动作里，别让角色长篇解释。",
+      "source_ref": "conversation:2026-08-25",
+      "source": "explicit_user",
+      "confidence": "high",
+      "importance": "high",
       "status": "active",
       "reason": "用户以“以后”明确声明长期偏好",
       "conflicts_with": []
@@ -160,36 +108,10 @@
 }
 ```
 
-把文件交给 `record`（book 范围的事件同时传 `--book-root`）。待确认项的 `status` 用 `pending`；冲突候选用 `conflict` 并填写同一 store 里的 active ID。确认或拒绝候选时，把下列对象作为新事件的 `operation`（`BP` 编号的事件传 `--book-root`）：
+待确认用 `"status": "pending"`；冲突候选用 `conflict` 并填同一 store 的 active ID。确认、替换、忘掉时，把下列对象换进新事件的 `operation`（`BP` 编号传 `--book-root`）；`replace.preference` 字段同上但不传 `status`、`conflicts_with`，新条目直接 active：
 
 ```json
 {"action":"decide","item_id":"AP002","decision":"activate","quote":"对，这就是我的长期习惯。","reason":"作者明确确认"}
-```
-
-用新规则替代一个或多个旧条目时，`replace.preference` 与上例字段相同，但不传 `status`、`conflicts_with`，新条目直接 active；下列对象同样作为 `operation`：
-
-```json
-{
-  "action": "replace",
-  "old_ids": ["AP001"],
-  "preference": {
-    "kind": "prose_style",
-    "scope": {"level": "global", "value": null},
-    "assertion": "以后对话允许更长的试探，但避免解释设定",
-    "quote": "把以前对话都要短的习惯替换掉：以后可以让对话慢一点，多试探，但还是别拿台词讲设定。",
-    "source_ref": "conversation:2026-08-25",
-    "source": "explicit_user",
-    "confidence": "high",
-    "importance": "high",
-    "reason": "作者明确替换原有全局规则，不是新增本书例外"
-  }
-}
-```
-
-撤回条目的 `operation`：
-
-```json
+{"action":"replace","old_ids":["AP001"],"preference":{"kind":"prose_style","scope":{"level":"global","value":null},"assertion":"以后对话允许更长的试探，但避免解释设定","quote":"……","source_ref":"conversation:2026-08-25","source":"explicit_user","confidence":"high","importance":"high","reason":"作者明确替换原有全局规则，不是新增本书例外"}}
 {"action":"forget","item_id":"AP003","quote":"忘掉这个偏好。","reason":"作者明确撤回"}
 ```
-
-需要把多个动作绑定成一次原子提交时才用高级 `commit`：顶层传 `schema_version`、唯一 `transaction_id`、当前 `expected_state_revision` 和含 1–32 项的 `operations`。操作按数组顺序应用，任一步失败则整份事务零写入。成功后删除临时输入文件；显式记忆请求按「回执怎么告诉作者」转告。

package/lib/oh-story/skills/story-short-write/references/banned-words.md

@@ -6,7 +6,7 @@
 
 ## 默认优先检查的句式（先对照本书文风）
 
-写网文最毒的 AI 句式，作者一旦养成就会反复出现。Gate A 第一遍扫描必须命中：
+写网文最毒的 AI 句式，作者一旦养成就会反复出现。以下是优先检查的句式：
 
 | 毒级 | 句式 | 错误例 | 修法 |
 |------|------|--------|------|
@@ -21,7 +21,7 @@
 | ★★★ | 抽象命运/开端收束："命运……棋局/獠牙" / "这一刻终于明白" / "反击才刚刚开始" | "命运终于露出獠牙；属于他的反击才刚刚开始" | 回到角色当下可见的文件、动作、对话或物理后果 |
 | ★★ | 章末预告 "他不知道的是……" | "他不知道的是，更大的风暴即将来临" | 用具体钩子物件/事件收束，避免空泛预告 |
 
-> 凡命中 ★★★★★ 一处即视为重度AI味的强证据；★★★★ 命中 ≥2 处即触发中度复扫。
+> ★★★★★ 命中一处就要改；轻/中/重分档只按去 AI 味诊断的密度指标定。
 
 `check-ai-patterns.js` 的 `formulaic-parallelism` 还会提示「至于X不X，怎么X」和同动词「不V A，不V B」。这两类可能是功能性口语，因此只做 advisory；Gate B 必须连同台词读语境复核，若只是复述细纲/前文就压成一次判断，不能因 hook 豁免台词而跳过。
 

package/lib/oh-story/skills/story-short-write/references/benchmark-recall.md

@@ -4,26 +4,6 @@
 
 > **拆文库/对标关系**：`拆文库/` = analyze skill 的原始产出（数据源），位于项目根目录。`对标/` = 当前短篇的引用视图，位于 `{短篇标题}/对标/`。短篇写作优先读取 `{短篇标题}/对标/{书名}/`，不存在则读取项目根 `拆文库/{书名}/`。
 
-推荐目录结构：
-
-```
-项目根/
-├── 拆文库/
-│   └── {书名}/
-│       ├── 拆文报告.md
-│       ├── 情节节点.md
-│       └── 写作手法.md
-└── {短篇标题}/
-    ├── 设定.md
-    ├── 小节大纲.md
-    ├── 正文.md
-    └── 对标/
-        └── {书名}/
-            ├── 拆文报告.md
-            ├── 情节节点.md
-            └── 写作手法.md
-```
-
 **对标发现（先于下方反应式加载）**：项目根 `拆文库/` 有拆过的短篇时，先按题材主动推荐一本对标，不要被动等用户开口。
 
 1. `ls 拆文库/` 列书目；先从当前项目目录名和 `设定.md`「基本信息」识别本篇标题，排除同名或来源指向当前 `正文.md` 的 `拆文库/{当前书}/`。story-import 生成的本书拆文分析属于续写基线，不是对标候选。排除后为空 → 跳过（无对标按题材包写，见 Phase 1 情绪→题材包表）。
@@ -55,6 +35,6 @@
 5. 写入本篇 `设定.md` 的“对标摘要”区，写作时每个场景从中召回 1-2 个相关技法
 6. 如只找到原文、未找到拆文报告，提示用户先运行 `/story-short-analyze`；如用户要求继续，也可只按原文做弱参考
 
-> **拆文产出格式**：analyze 落盘的完整文件树、`_meta.json` schema、Stage→文件映射，以及「story-short-write 怎么读这些产出」的下游消费规范，见 [references/output-contract.md](output-contract.md)。
+> **拆文产出怎么用**：`_meta.json` 可选，缺了不挡写作，有就按 `structure_counts.reversal_type` 选反转骨架；`情节节点.md` 看每个节点的字数位置、功能和触发事件，给新故事排节奏；`写作手法.md` 与 `原文/` 只学写法（对话调子、节奏、画面感），不抄具体情节。
 
 > **多对标书时**：参 `references/cross-book-recall.md`，副对标 anchor 入「对标摘要」区

package/lib/oh-story/skills/story-short-write/references/emotional-methods.md

@@ -152,7 +152,7 @@
 | **太赶** | 重大转折只用了 1 节铺垫 | 给转折至少 3 节铺垫 |
 | **假虐** | 读者不心疼，只是看着难受 | 检查羁绊铺设是否具体 |
 | **割裂** | 前半部分和后半部分像两篇不同的故事 | 用伏笔/物件/主题贯穿 |
-| **烂尾** | 反转后拖了 2000 字还在交代 | 反转后 500 字内收尾 |
+| **烂尾** | 反转后还在补交代、新开事件 | 篇幅按小节大纲分配；反转后只写兑现与余韵 |
 | **人设崩** | 角色在关键时刻的行为不符合前面的人设 | 回顾人设，确保行为逻辑一致 |
 
 ---

package/lib/oh-story/skills/story-short-write/references/genre-writing-formulas.md

@@ -415,18 +415,3 @@
 | 情感/虐心 | 中强 | 情感、反差、余韵 |
 | 古言/宫斗 | 中强 | 底牌、打脸、代价 |
 | 年代/亲情 | 中 | 情感、反差、余韵 |
-
----
-
-## 质量检查清单
-
-> 写完每个公式后逐项核对。全部通过才算合格。
-
-- [ ] **公式对位**：所用公式与题材标签匹配，没有混用不相关公式
-- [ ] **情绪节拍完整**：情绪曲线与公式要求的节拍一致，没有跳过或乱序
-- [ ] **必选场景齐全**：每个"必选场景"都在文中出现，没有遗漏
-- [ ] **核心规则遵守**：公式"规则"部分的每一条都已落实
-- [ ] **篇幅合规**：章/节数量在公式规定范围内
-- [ ] **女频/男频区分**：如果是复仇打脸类，已按公式十四的核心差异调整写法
-- [ ] **牵引不断线**：钩子落在预期、行动方向或关系判断变化处，没有连续多个小节只提问不兑现
-- [ ] **开头3秒抓人**：第一段/第一句已建立核心冲突或信息炸弹，没有慢热铺垫

package/lib/oh-story/skills/story-short-write/references/output-contract.md

@@ -2,11 +2,7 @@
 name: output-contract
 description: |
   story-short-analyze 输出契约。定义 Stage → 文件映射、_meta.json schema、
-  下游消费规范（story-short-write 读全套 markdown + 原文 + _meta.json 写新短篇）。
-sync-policy: |
-  本文件在 story-short-analyze 与 story-short-write 之间需保持字节一致（byte-equal）。
-  修改任一副本后，必须同步另一副本，并通过 bash scripts/check-shared-files.sh 验证。
-  禁止把本文件加入 IGNORE_NAMES 列表——它必须保持同步，不属于 intentional differences。
+  写入顺序、Resume 与验收接入点。story-short-write 怎么读这些产出由写作侧自己维护。
 ---
 
 # 输出契约：story-short-analyze ↔ story-short-write
@@ -29,6 +25,7 @@ sync-policy: |
 
 **文件名约定**：`拆文报告.md / 情节节点.md / 写作手法.md` 由 `story-short-write` 硬编码
 消费，不可重命名。分析叙事走 markdown，数字/枚举走 `_meta.json.structure_counts`。
+写作侧怎么读这些产出（读哪几段、按什么顺序用）由 `story-short-write` 自己的参考文件维护，不在本契约里。
 
 ---
 
@@ -38,7 +35,7 @@ sync-policy: |
 |-------|------|----------|---------|
 | 2 | 结构+情节节点 | `拆文报告.md`（故事核/结构/梗概段） + `情节节点.md` | 故事核 / 4-6 段结构 / 故事梗概 / 情节节点清单 |
 | 3 | 情感线+爆点 | `拆文报告.md`（情感曲线段+爆点段） | 情感曲线 ≥5 节点 / 爆点 6 维度 / 期待感 |
-| 4 | 反转+写作手法 | `拆文报告.md`（反转段） + `写作手法.md` | 前置反转检查 / 反转分析（铺垫 ≥2） / 写作手法 ≥5 项 |
+| 4 | 反转+写作手法 | `拆文报告.md`（反转段） + `写作手法.md` | 前置反转检查 / 反转分析（铺垫 ≥3） / 写作手法 ≥5 项 |
 | 5 | 人物+开头结尾 | `拆文报告.md`（人物段+首尾段） | 人物分类+功能评估 / 开头分析 / 结尾分析 / 首尾呼应 |
 | 6 | 综合评估 | `拆文报告.md`（综合段） + `_meta.json`（写 structure_counts） | 五维评分 / 爆点性 / 话题性 / 共鸣 ≥3 层 / 可复用结构 ≥3 条 / 节奏速报 |
 
@@ -96,7 +93,7 @@ Stage 6 内容写完后、`stages_completed[6]` append 前，跑三道检查：
 
 扫描 `拆文报告.md` 全文 against 拆文流程本地加载的禁用词表与报告 AI 腔规则。
 这是拆文报告质量门；成稿去 AI 规则由写作流程在自己的 Skill 内维护，不跨 Skill 读取参考文件，也不要把两套规则混用。
-命中 → 不写 `stages_completed[6]`，列出位置请用户修订**拆文报告本身**的 AI 腔
+命中 → 不写 `stages_completed[6]`，逐处修订**拆文报告本身**的 AI 腔后重扫
 （源文里有 AI 腔不算——这里扫的是分析师写的报告）。
 
 ### Step 2：`_meta.json.structure_counts` 数值校验
@@ -111,55 +108,20 @@ Stage 6 内容写完后、`stages_completed[6]` append 前，跑三道检查：
 | `structure_counts.reversal_type` | 在枚举内（含「无反转」）| 阻断 |
 | `genre_detected` | 非空 | 阻断 |
 
-> 情节节点数不设阈值，按 `情节节点.md` 的语义变化边界提取（见 material-decomposition.md），不在本表。`beats` 是结构段数，不是情节节点数。
+> 情节节点数不设阈值，按 `情节节点.md` 的语义变化边界提取（见拆文流程的情节节点提取规则），不在本表。`beats` 是结构段数，不是情节节点数。
 
 ### Step 3：`story-short-analyze` BLOCK 项扫描
 
-扫拆文流程本地加载的输出模板，确认所有 `[BLOCK]` 标注项对应的产出段均在 `拆文报告.md` 出现。
+扫拆文流程本地质量检查清单的全部 `[BLOCK]` 项，确认对应产出均已写出。
 任一缺失 → 阻断。`[WARN]` 项 → 写入拆文报告末尾「待补」清单，不阻断。
 
 ### Step 4：通过
 
-清空 `_meta.json.last_stage_in_progress`，append `6` 到 `stages_completed[]`，提示
-用户「拆解完成，可调用 `/story-short-write` 写下一篇」。
-
----
-
-## 下游消费规范（story-short-write 怎么用）
-
-> `story-short-write` 当前硬编码读 `拆文报告.md / 情节节点.md / 写作手法.md` 三个 markdown。
-> `_meta.json` 是可选增强：read 容忍，不存在不阻塞写作。
-
-| 文件 | 角色 | 怎么读 |
-|------|------|--------|
-| `_meta.json`（可选）| 数字门面 + 题材识别 | 看 `genre_detected` 决定哪个题材标尺，读 `structure_counts` 确认拆文完整性，读 `structure_counts.reversal_type` 选反转骨架 |
-| `拆文报告.md` | 分析叙事主体 | 读「故事核」「结构」「情感曲线」「爆点」「反转分析」「人物」「五维评分」「共鸣分析」「可复用结构」「同类型写作动作」段，是 writer 的主输入 |
-| `情节节点.md` | 节奏锚点 | 看每个节点的字数位置 + 功能 + 触发事件，给新故事排节奏 |
-| `写作手法.md` | 手法库 | POV / 对话 / 时间 / 信息控制 等具体手法 + 原文示例，新篇里复用 |
-| `原文/` | 语感源 | 抄对话调子、节奏、画面感、打脸张力。**不抄具体情节**，抄写法。 |
-
-### 写作流程建议
-
-1. 看 `_meta.json.genre_detected` 和 `structure_counts.reversal_type` 选骨架。
-2. 读 `拆文报告.md` 的「核心手法」「共鸣分析」「可复用结构」段，决定要保留 / 调整哪些。
-3. 读 `情节节点.md` 把节奏锚点抄到新故事的字数位置上。
-4. 写场景时翻 `写作手法.md` + `原文/`，参考具体写法。
-5. 写完后（可选）在新文档 frontmatter 写 `derived_from: 拆文库/{书名}/` 追溯。
-
-### 维护者本地烟雾测试
-
-```bash
-ls 拆文库/{书名}/   # 应有：原文/ 拆文报告.md 情节节点.md 写作手法.md _meta.json
-/story-short-write 拆文库/{书名}/
-# 通过：输出 8000+ 字同题材新短篇，prose 有源文对话节奏和画面感
-# 失败：写得像填空 / 或 short-write 找不到三个 markdown
-```
+清空 `_meta.json.last_stage_in_progress`，append `6` 到 `stages_completed[]`，按拆文
+流程 SKILL 的完成汇报告诉作者。
 
 ---
 
 ## 版本约定
 
-- `_meta.json.version` 与本文件 `sync-policy` 联动。
-- breaking change（字段重命名 / 类型变更 / 必填变更）必须 bump major version 并同步两侧
-  副本，CI 通过 `scripts/check-shared-files.sh` 拦截单边修改。
-- additive change（新增可选字段）可 bump minor；producer、consumer 与两侧副本必须在同一变更中升级到当前 schema。
+`_meta.json.version` 跟本契约走：字段改名、类型或必填变更升 major，新增可选字段升 minor。

package/lib/oh-story/skills/story-short-write/references/reference-index.md

@@ -1,55 +1,23 @@
 # 短篇参考资料索引
 
-## 参考资料
-
-按当前阶段 Reference Gate 和写前准备加载必需文件，其余按需：
+各阶段必读项按 SKILL.md「写前必读」与各 workflow 执行；检测与验收脚本由 workflow 直接给出命令。下表只列按需资料：
 
 | 文件 | 何时加载 |
 |------|----------|
-| [references/short-format.md](short-format.md) | 写作前必读（短篇正文格式，两平台模板） |
-| [references/submission-craft.md](submission-craft.md) | 投稿前必读（平台基调 知乎/小程序/番茄 · 导语门面 · 付费点断点） |
-| [references/short-craft.md](short-craft.md) | 写作全程参考（短篇通用底座：情绪直写与场景支撑、在场叙述、超短章节制） |
-| [references/genre-styles/](genre-styles/) | **定方向后必读**：按题材加载对应风格包（追妻火葬场 / 世情打脸 / 复仇打脸 / 总裁豪门 / 宅斗宫斗 / 民俗怪谈 / 悬疑 / 甜宠 / 双男主 / 沙雕脑洞），正文风格随之切换 |
-| [references/short-deslop.md](short-deslop.md) | 去AI味时必读（短篇专属，只杀真·AI腔，不杀情绪烈度） |
-| [references/workflow-design.md](workflow-design.md) | Phase 2 构思、设计字段、Agent 调用与完成门禁；Phase 3/4 不预加载 |
-| [references/workflow-draft.md](workflow-draft.md) | Phase 3 写正文前必读：参数与逐场景写作；完成门槛见入口 |
-| [references/workflow-revision.md](workflow-revision.md) | Phase 4 精修/自检前必读：检查分工、去味调用、扫描与交付验收 |
-| [references/writing-workflow.md](writing-workflow.md) | Phase 2 设计任务 + Phase 4 精修 |
-| [references/genre-writing-formulas.md](genre-writing-formulas.md) | 冷门题材结构骨架补充（核心 10 题材直接用 genre-styles/） |
-| [references/genre-writing-techniques.md](genre-writing-techniques.md) | 跨题材通用技法（震惊场景/三翻四震/感情线四阶段/喜剧flag） |
-| [references/emotional-methods.md](emotional-methods.md) | 设计情感时 |
-| [references/hooks-chapter.md](hooks-chapter.md) | 章节钩子设计 |
-| [references/short-suspense.md](short-suspense.md) | 短篇悬念设计 |
-| [references/hooks-paragraph.md](hooks-paragraph.md) | 段落钩子技巧 |
-| [references/villain-and-reveal.md](villain-and-reveal.md) | Phase 2 设计反派时 |
-| [references/short-reversal.md](short-reversal.md) | 设计短篇反转时 |
-| [references/short-prose-quality.md](short-prose-quality.md) | 精修检查时 |
-| [references/banned-words.md](banned-words.md) | 禁用词表 |
-| [scripts/normalize-punctuation.js](../scripts/normalize-punctuation.js) | Phase 4 文件模式确定性标点收尾 |
-| [scripts/check-ai-patterns.js](../scripts/check-ai-patterns.js) | Phase 3 完成门槛与 Phase 4 复扫；报告高危 AI 句式、破折号、碎句号、长段落、微动作复读、套式反应细节、抽象总结、套词/比喻密度、解释链、系统公告腔、提纲感短段、低连接密度 |
-| [scripts/check-degeneration.js](../scripts/check-degeneration.js) | Phase 3 完成门槛与 Phase 4 复扫；报告模型退化（复读/截断/工程词泄漏），blocking 需重新生成 |
-| [scripts/check-phase2-contract.js](../scripts/check-phase2-contract.js) | Phase 2 产物确定性验收；返回具名失败与最小 repair_scope |
-| [scripts/check-delivery-contract.js](../scripts/check-delivery-contract.js) | 最终交付确定性验收；按用户参数检查非空白字符、节数与小节格式 |
-| [references/dialogue-mastery.md](dialogue-mastery.md) | 写对话时 |
-| [references/output-contract.md](output-contract.md) | Phase 2 对标上下文加载时（理解 analyze 产出格式与消费规范） |
-
-### 按主题快速定位（横切主题）
-
-有些主题散在多个文件里。下表给每个主题一个**权威文件**（先读它，通常够用），配套文件只在需要那个角度时再加载。括号是该文件里对应的小节。
-
-| 主题 | 权威文件（先读） | 配套文件（按角度补充） |
-|------|-----------------|----------------------|
-| 情绪落地（怎么写情绪） | **`references/short-craft.md` 第2节**（情绪直写、场景支撑与重复说明取舍） | 各 `genre-styles/` 包的「情绪烈度与模式」 |
-| 情绪设计（情感结构） | **`references/emotional-methods.md`**（情感三板斧 + 拉扯节奏 + 失败模式） | `references/genre-writing-techniques.md`（情绪操控核心法则 / 情绪三层次） |
-| 反转 | **`references/short-reversal.md`**（反转类型 / 铺垫 / 揭示位置 / 有效性自检） | `references/villain-and-reveal.md`（真相揭露机制 / 反转有效性自检） |
-| 反派揭露 | **`references/villain-and-reveal.md`**（反派模板 / 揭露机制 / 报应设计） | `references/short-reversal.md` |
-| 人物 | **各 `genre-styles/{题材}.md` 的「对话风格」「招式库」**（受害者-复仇者主角声线、白月光软刀、施害者道德绑架人设，corpus-grounded） | `references/villain-and-reveal.md`（反派/揭露）· `references/genre-writing-techniques.md`（三层标签反差 / 人设从缺点开始）· `references/dialogue-mastery.md`（声线差异） |
-| 钩子 | **`references/hooks-chapter.md`**（章节/开篇钩子类型） | `references/hooks-paragraph.md`（段落钩子）· `references/short-suspense.md`（悬念设计） |
-| 女频写作 | **对应 `genre-styles/{题材}.md`**（追妻火葬场 / 总裁豪门 / 宅斗宫斗 / 甜宠 / 世情打脸的题材声线、虐爽比例、招式） | `references/genre-writing-techniques.md`（女频读者心理与写作技法 / 感情线四阶段推进法）· `references/emotional-methods.md`（情绪拉扯） |
-| 题材风格 | **`references/genre-styles/{题材}.md`**（核心 10 题材的腔调/开篇/钩子/情绪烈度/招式/收尾，corpus-grounded） | `references/genre-writing-formulas.md`（冷门题材结构骨架）· `references/genre-writing-techniques.md`（核心梗 / 卖点 / 通用技法） |
-| 开头 | **各 `genre-styles/{题材}.md` 的「开篇范式」**（关系锚 + 全弧剧透导语 + 火葬场预告，真实开篇范例）+ `short-craft.md` 第12节（开头事件密度） | `references/hooks-chapter.md`（开篇钩子类型）· `references/hooks-paragraph.md`（段钩密度） |
-| 格式与节奏 | **`references/short-format.md`**（短篇正文格式，两平台模板） | `references/short-craft.md`（情绪落地/三维度揉进/疏密）· `references/writing-workflow.md`（设计/精修工作流） |
-| 对话 | **`references/dialogue-mastery.md`**（对话技法主文件：差异化/潜台词/对话节奏） | `references/short-craft.md`（三类台词与对话权力博弈）· 各 `genre-styles/` 包的真实金句库 |
-| 去AI味 | **`references/short-deslop.md`**（短篇专属：只杀真·AI腔，不杀情绪烈度/审判句/火葬场预告） | `references/banned-words.md`（禁用词扫描）· `scripts/check-ai-patterns.js`（AI句式复扫）· `references/short-prose-quality.md`（成稿检查） |
+| [short-format.md](short-format.md) | 写正文前（短篇正文格式，两平台模板） |
+| [submission-craft.md](submission-craft.md) | 定平台、写导语、定付费点 |
+| [short-craft.md](short-craft.md) | 写作全程（情绪直写与场景支撑、在场叙述、超短章节制） |
+| [scene-craft.md](scene-craft.md) · [agent-calls.md](agent-calls.md) | 写正文的场景写法（三维度揉进、疏密）；派写手写正文或精修去味的 prompt |
+| [genre-styles/](genre-styles/) | 定方向后按题材读一个风格包（追妻火葬场 / 世情打脸 / 复仇打脸 / 总裁豪门 / 宅斗宫斗 / 民俗怪谈 / 悬疑 / 甜宠 / 双男主 / 沙雕脑洞） |
+| [genre-writing-formulas.md](genre-writing-formulas.md) | 冷门题材结构骨架（核心 10 题材用 genre-styles/） |
+| [genre-writing-techniques.md](genre-writing-techniques.md) | 跨题材通用技法（震惊场景 / 三翻四震 / 感情线四阶段 / 喜剧 flag / 女频读者心理） |
+| [emotional-methods.md](emotional-methods.md) | 设计情感结构（三板斧 / 拉扯节奏 / 失败模式） |
+| [short-reversal.md](short-reversal.md) | 设计反转（类型 / 铺垫 / 揭示位置 / 有效性自检） |
+| [villain-and-reveal.md](villain-and-reveal.md) | 设计反派与真相揭露、报应 |
+| [hooks-chapter.md](hooks-chapter.md) · [hooks-paragraph.md](hooks-paragraph.md) · [short-suspense.md](short-suspense.md) | 章节/开篇钩子、段落钩子、悬念设计 |
+| [dialogue-mastery.md](dialogue-mastery.md) | 写对话（差异化 / 潜台词 / 对话节奏） |
+| [short-deslop.md](short-deslop.md) | 去 AI 味（只杀真·AI 腔，不杀情绪烈度、审判句、火葬场预告） |
+| [short-prose-quality.md](short-prose-quality.md) · [banned-words.md](banned-words.md) | 精修检查、禁用词 |
+| [output-contract.md](output-contract.md) | 对标上下文加载时理解 analyze 产出格式 |
 
----
+**同一主题先读谁**：情绪怎么写 → `short-craft.md` 第 2 节；人物声线与开篇 → 题材包的「对话风格」「开篇范式」；反转 → `short-reversal.md`，反派揭露 → `villain-and-reveal.md`；格式与节奏 → `short-format.md`。

package/lib/oh-story/skills/story-short-write/references/scene-craft.md

@@ -0,0 +1,40 @@
+# 短篇场景写法
+
+写正文时刻读（构思不读）：一场戏落到纸面怎么揉信息、怎么分疏密。
+
+## 1. 场景写法：三维度揉进
+
+发生、感知、反应是可选信息维度，不是逐段配额。关键子事件只把确有新信息的维度**织进同一段连续正文，不按维度分段**；上下文已清楚时可以留空：
+
+| 维度 | 内容 | 要点 |
+|------|------|------|
+| 发生 | 事情出现了 | 1-2 句，含一个具体细节 |
+| 感知 | 主角注意到什么 | 只取会改变理解、判断或气氛的声音、物件、空间或身体感受，不按感官凑数 |
+| 反应 | 角色接下来怎么办 | 选择、台词、策略、任务动作、明确感受或有后果的身体变化；不默认补手/眼/呼吸微动作 |
+
+任务卡点也按需取三维：发生 = 事情办不下去；感知 = 主角看到、摸到或听到卡住的具体证据；反应 = 当场判断、选择或下一步反击。不要把流程单独写成说明段，也不要在场景末尾补动作尾巴解释意义。
+
+反模式（绝对禁止）：把三维度拆成三段依次写完，同一件事掰开写三遍。
+
+- 正确（揉进式，《闻笙有两意》原文）：我以为陆池是真心跟我道歉，但摸到那碗凉掉的排骨汤时，我的心更冰冷了。上面还浮着凝固的油，根本喝不了。（摸汤、凝固的油、心冰冷揉在一段里）
+- 错误（把上面这段拆成三段堆叠）：我摸到那碗排骨汤。／ 汤是凉的，浮着凝固的油。／ 我的心更冰冷了。（同一件事掰成三句，读者看三遍）
+
+**句子要连**：一句里超过三个动作，用「就、才、又、便、却、倒」接出先后因果，别写成逗号清单；「没A，也没B」式否定排比全篇至多一两处；对话按人物身份带「吧、呢、啊、嘛」这类口气；单独成行的碎句只留给钩子、反转和情绪峰值。
+
+**画面分段**：揉进不等于一段到底。按新动作 / 新物件 / 新信息 / 新对话 / 视线转移断段，不按维度断段。一段承载一个镜头拍点或一条连续推理 / 氛围 / 情绪链。
+
+---
+
+## 2. 疏密分配 + 动静起伏
+
+**疏密**：不要每个 beat 一样长一样细（平均用力是 AI 腔的根）。
+
+| beat 类型 | 笔墨 |
+|---|---|
+| 爽点 / 打脸 / 反转 / 情绪高潮 | 密（详写，感知动作对话铺满，慢镜头逐拍） |
+| 过场 / 赶路 / 信息交代 / 时间跳转 | 疏（1-2 句带过，不展开三维度） |
+| 铺垫 / 日常 / 关系升温 | 中（挑一两个有代入感的细节写实，其余略） |
+
+**动静有起伏**：整篇要有推进与停顿，但不要求动作冲击后固定接一段安静感知。停顿可以是信息悬置、对话空白、等待或环境压力，不用微动作填格。避免长时间全动造成疲劳，也避免长时间全静造成拖沓。
+
+**主语节奏**：段首 / 场景切换 / 多人同场用主角名建立主语；同一动作链内用代词 / 省略流动；关键转折再点名。避免连续多句都以同一主角名开头。