@oh-story/dsh 0.1.0

package/lib/oh-story/skills/story-short-write/references/hooks-suspense.md

@@ -0,0 +1,352 @@
+# 悬念编排操作手册
+
+悬念构建、强度分级、多线周期、分层钩子、期待接力、震惊分层的完整操作指南。
+
+---
+
+## 决策路由表
+
+| 你在写什么 | 用什么方法 |
+|------------|------------|
+| 设计悬念体系 | 多线悬念周期 + 强度5级分级 |
+| 单章悬念 | 四种信息顺序模板 + 触发型分层钩子 |
+| 跨卷悬念 | 期待接力法 + 震惊分层 |
+| 判断悬念强度 | 强度5级分级表 |
+
+使用方法：先看左列定位你的当前任务，再用右列指定的方法。
+
+---
+
+## 悬念构建核心法则
+
+### 悬念的本质
+
+读者心理预期出现两个及以上不同走向时，剧情就有了悬念——读者觉得都有可能发生。
+
+### 悬念 vs 伏笔：区分清楚
+
+| 维度 | 悬念 | 伏笔 |
+|------|------|------|
+| 目的 | 让读者猜测接下来会怎样 | 为后面的揭示埋下前期线索 |
+| 位置 | 章节结尾/段落结尾 | 叙事中自然带出 |
+| 揭示时机 | 短期内揭晓 | 长期后才揭示 |
+| 情绪效果 | 紧张/好奇/期待 | 震惊/恍然大悟 |
+
+判断依据：短期揭晓+紧张感 = 悬念；长期埋线+揭示时震惊 = 伏笔。两者经常配合使用，但不要混淆。
+
+### 四种悬念信息顺序模板
+
+| 类型 | 结构 | 适用场景 |
+|------|------|----------|
+| 直白剧情 | 提出疑问 → 公布答案 | 基础叙事 |
+| 探索剧情 | 提出疑问 → 正常提示 → 公布答案 | 铺垫段 |
+| 意外剧情 | 提出疑问 → 虚假提示 → 公布答案 | 反转段 |
+| 意外+反转 | 提出疑问 → 虚假提示1 → 虚假对立提示2 → 公布答案 | 高潮段 |
+
+操作要点：选择模板后，严格按结构顺序排列信息。虚假提示必须足够可信，否则读者不买账。
+
+### 触发型钩子（分层钩子）
+
+单章内多层递进悬念，按以下步骤操作：
+
+```
+第1层：展示初步成果 → 观众初步反应
+第2层：揭示这还不是最终结果 → 观众期待升级
+第3层：展示超出预期的元素 → 观众震惊
+第4层：主角还能进一步提升 → 留下钩子，开启下一段
+```
+
+关键要求：每一层都必须有角色的反应来验证悬念的力度。没有角色反应 = 悬念落空。
+
+---
+
+## 悬念强度分级
+
+| 等级 | 名称 | 效果 | 适用 |
+|------|------|------|------|
+| 1 | 微悬念 | 好奇 | 过渡章 |
+| 2 | 小悬念 | 想看下一段 | 正文章 |
+| 3 | 中悬念 | 想看下一章 | 关键章 |
+| 4 | 大悬念 | 放不下书 | 爆发章 |
+| 5 | 极悬念 | 睡不着 | 卷末高潮 |
+
+使用方法：写完每章后对照此表判断悬念等级。过渡章至少要达到1级，正文章至少2级，关键章至少3级。不达标则需要补强。
+
+---
+
+## 多线悬念周期
+
+| 弧线长度 | 跨度 | 示例 |
+|----------|------|------|
+| 短弧 | 2-3 章 | 一场打斗、一次冲突 |
+| 中弧 | 5-8 章 | 一段关系变化、一个小谜题 |
+| 长弧 | 整卷 | 终极秘密、主线大反转 |
+
+规划时同时铺设三种弧线，保证任何时刻都有至少两条悬念线在运行。
+
+### 三段钩子设计（单章内）
+
+按章节进度分配悬念节奏：
+
+1. **种**（前 30%）：埋下钩子种子
+2. **养**（中 50%）：逐步加压，让读者意识到不对劲
+3. **收**（末 20%）：引爆或延迟引爆
+
+延迟引爆 = 比引爆更强的钩子，用于拉到下一章。
+
+---
+
+## 期待接力法
+
+### 基本规则
+
+- 确保读者脑中有三个好奇的东西：两长一短
+- 长期待收回后变短期爆发，同时新的长期待已铺好
+- 短篇中：一个主悬念 + 一个副悬念，结尾同时引爆
+
+### 持续拉期待操作框架
+
+1. 每章结尾必须有至少一个未解的问题或未达成的期待
+2. 期待分三层同时运作：短期（下章）、中期（本卷）、远期（全书）
+3. 当一层即将满足时，先铺好下一层的期待，形成"期待链"不断裂
+
+### 不间断期待与钩子链
+
+- 主角即将得到某样东西但还没得到时，读者期待感最高
+- 在主角得到之前，必须套上另一个钩子
+- 大期待（主线）+ 小期待（支线）来回穿插，一个勾着一个无限循环
+- 任何时刻保持至少两条期待线并行运行
+
+---
+
+## 驱动力公式
+
+**核心公式**：产生诉求 → 给予希望 → 努力解决 → 得偿所愿
+
+| 阶段 | 操作 | 要点 |
+|------|------|------|
+| 产生诉求 | 制造不爽——低地位/困境/威胁/不曾拥有 | 读者看到不公 → "不该如此"的冲动 = 最根本驱动力 |
+| 给予希望 | 展示金手指 = 改变的希望 | 清晰展示金手指 = 给读者看下去的动力 |
+| 努力解决 | 不能太快得偿所愿 | 方式一：困境分层递进；方式二：解决一个 → 新困境升级 |
+| 得偿所愿 | 爽点释放 | 困境层级越高、种类越不同 → 爽感越强 |
+
+**"悬而未决"技巧**：持续的"未解决"状态 = 持续的关注和期待。设置信息差保持张力。
+
+---
+
+## 情绪折线与蓄力释放节奏
+
+### 情绪折线
+
+`铺垫（上行）→ 挫折（下行）→ 再铺垫（上行）→ 再挫折（下行）→ 爆发（大幅上行）`
+
+操作规则：
+- 上行可以多一些，下行要精准控制力度
+- 下行太猛 = 节奏断裂（弃书），太轻 = 打不响
+- 网文的"下行"用小挫折、小波折制造落差，避免让主角真憋屈
+
+### 期待蓄力与释放的力度控制
+
+- 蓄力 = 铺垫期待，释放 = 爽点爆发
+- 蓄力太久 = 读者疲惫；不够 = 爽感不足；断裂 = 弃书
+- 小期待不断（持续满足），大期待适度，每次释放后爽感要比上一次更强
+
+### 道具能力展示的8步期待模板
+
+按顺序执行：
+
+1. 展示宝物功能强大（期待+1）
+2. 配角因信息不足认为鸡肋（信息差，期待打脸+1）
+3. 展示反派，宝物恰好克制反派（期待+1）
+4. 配角拿更强装备打反派失败（期待主角出手+1）
+5. 主角做针对性方案（期待+1）
+6. 主角上场，众人不看好（期待继续+1）
+7. 主角秒杀反派 → 众人震惊 → 鸡肋成神器（期待满足）
+8. 新收获 + 新期待产生
+
+---
+
+## 震惊分层写法
+
+### 震惊三层结构
+
+从弱到强依次使用：
+
+1. **点震惊**：一个人震惊了一下（最弱）
+2. **网震惊**：震惊关系网——不只一个人震惊，周围人都有反应
+3. **深度震惊**：多层震惊叠加——成就1震惊 → 成就2震惊 → 更厉害的成就3引爆震惊
+
+### 关键原则
+
+- 金手指对剧情的效果必须展示得清清楚楚
+- 放了底牌，反派就要受到对应压制
+- 该爽的时候不爽到位，观感上是很毒的
+
+### 关系网震惊层级
+
+| 层级 | 震惊对象 | 效果强度 | 后续价值 |
+|------|----------|---------|---------|
+| 陌生人震惊 | 路人、群演 | 弱 | 纯情绪满足，无后续 |
+| 熟人震惊 | 有过互动的配角 | 中 | 可能产生态度变化 |
+| 重要角色震惊 | 有后续戏份的角色 | 强 | 伴随信息展露、关系进展、拉起期待 |
+| 高位者震惊 | 行业顶层人物、高阶位者 | 最强 | 侧面拉起读者对主角的期待 |
+
+选择依据：根据该角色后续戏份决定震惊层级。有后续的角色震惊才有价值。
+
+### 震惊递进的道具体现法
+
+| 阶段 | 道具表现 | 震惊强度 |
+|------|----------|----------|
+| 成就1 | 对方将椅子把手捏出一道裂痕 | 轻 |
+| 成就2 | 椅子满是裂纹 | 中 |
+| 成就3 | 对方捏爆椅子把手 | 强 |
+
+要点：道具变化比"他震惊了"有力一百倍。每次递进都要有明确的视觉/物理变化。
+
+---
+
+## 期待感设计的核心方法
+
+### 多线运行法（画线法）
+
+1. 一个剧情线一道大横线
+2. 其他期待线在下面画线
+3. 规划剧情节点
+4. 落入正文时再详写
+
+### 永留悬念大结构设计
+
+- 大结构是"欺骗式的主线"：贯穿全文的噱头，并不实际推进
+- 每次看似砍了99%，但总剩1%变成新的100%，一直吊着读者
+
+### 信息差运用
+
+- 读者知道主角获得了强力物品但配角不知道——天然信息差产生期待
+- 反派恰好被克制——期待叠加
+- 别人拿更好装备却失败——期待再加倍
+- 信息差抹平时 = 爽点爆发
+
+### 读者预知法（提前告知大事件制造紧张）
+
+提前告诉读者即将发生的大事件，读者知道但主角不知道，形成紧张感和期待感。"倒计时"变体：把事件变成不断逼近的倒计时，每隔1-2章放一小段进展。
+
+### 底牌前置法
+
+先展示主角底牌，再安排找事的冲突。读者知道主角有底牌但反派不知道。需要两对信息组合：**底牌 + 即将发生的冲突**。
+
+---
+
+## 拉期待手法速查（8大类36种）
+
+| 类别 | 手法 | 说明 |
+|------|------|------|
+| 角色行为 | 持续伪装等待暴露 | 主角持续扮演某身份，期待暴露时刻 |
+| 角色行为 | 非常规能力展示 | 主角用特殊能力解决，期待更大规模 |
+| 角色行为 | 违反人设预期的行为 | 做出与形象不符的行为，制造惊喜 |
+| 角色行为 | 展示部分实力留底牌 | 展现部分实力，期待全面爆发 |
+| 时局/事件 | 突发意外 | 意外事件打破当前平静，迫使剧情加速 |
+| 时局/事件 | 暗中蓄力等待时机 | 角色暗中蓄力，期待亮剑时刻 |
+| 时局/事件 | 高风险中谋利 | 在危险中谋利，紧张感拉满 |
+| 时局/事件 | 混乱中周旋 | 在混乱局面中巧妙保全或谋利 |
+| 关系网扩展 | 跨势力角色串联 | 不同势力角色产生意外联系，扩大冲突面 |
+| 关系网扩展 | 多方势力不同反应 | 多方势力对主角/事件不同反应 |
+| 关系网扩展 | 名声扩散引起新关注 | 名声扩散引起新势力注意 |
+| 关系网扩展 | 帮助支线改变境遇 | 支线角色因主角帮助境遇改变，建立忠诚 |
+| 关系网扩展 | 重要角色遇麻烦等主角出手 | 重要角色遇麻烦，期待主角出手 |
+| 矛盾升级 | 逐步接近目标每步拉期待 | 逐步接近目标，每步拉起新期待 |
+| 矛盾升级 | 暗中威胁浮现 | 暗中威胁线索逐渐浮现，读者先于主角察觉 |
+| 矛盾升级 | 不可调和矛盾到爆发临界 | 不可调和矛盾积累到爆发临界 |
+| 矛盾升级 | 解决一个麻烦引出更大麻烦 | 解决一个麻烦后引出更大麻烦 |
+| 矛盾升级 | 升级引发各方反应 | 各方势力对主角实力升级的不同反应 |
+| 资源/实力 | 获得稀缺资源暗示用途 | 获得稀缺资源，期待用途 |
+| 资源/实力 | 独特方式变废为宝 | 用独特方式将无用变宝物 |
+| 资源/实力 | 恰好解决当前困境的手段 | 恰好有解决当前困境的手段 |
+| 资源/实力 | 信息或实力远超他人认知 | 掌握的信息/实力远超他人认知 |
+| 新线索/设定 | 前往新地图 | 即将前往新区域，刷新场景和冲突 |
+| 新线索/设定 | 新规则或设定揭示 | 新规则/设定/体系的揭示 |
+| 新线索/设定 | 已有能力新组合方式 | 已有能力的新组合方式 |
+| 新线索/设定 | 已知信息下更深内容 | 已知信息下的更深层内容 |
+| 新线索/设定 | 谜团逐步揭开 | 谜团层层揭开，满足好奇心 |
+| 新线索/设定 | 绝路出现转机 | 看似绝路出现转机 |
+| 等级/技能 | 描写升级路径拉期待 | 描写升级路径，期待每次突破 |
+| 等级/技能 | 新能力效果展示 | 展示新能力的具体效果和应用场景 |
+| 等级/技能 | 升级后装逼期待 | 升级后读者期待装逼打脸剧情 |
+| 等级/技能 | 主角能力克制当前对手 | 主角能力恰好克制当前对手 |
+| 等级/技能 | 晋升展现多种能力 | 晋升后展现不同新能力，保持新鲜感 |
+| 情绪/氛围 | 适当隐藏部分信息 | 适当谜语人，隐藏部分信息 |
+| 情绪/氛围 | 重要角色牺牲 | 重要角色牺牲带来的情绪冲击和剧情转折 |
+| 情绪/氛围 | 主角暗中布局期待收网 | 主角暗中布局，期待收网 |
+
+**组合原则**：技巧服务表达，不是为了用而用。构思时可同时考虑多种技巧丰富剧情，没用就丢弃。
+
+---
+
+## 反派强时的三层破局写法
+
+反派应对异常强势时，主角的破局要让读者感到"降维打击"。按层次递进：
+
+| 层次 | 名称 | 做法 |
+|------|------|------|
+| 1 | 硬碰硬 | 实力碾压，简单粗暴 |
+| 2 | 预判反制 | 反派出A，主角早准备了B克制A |
+| 3 | 反预判 | 反派精心准备针对A，主角不仅避开A，还利用A作陷阱引导反派落入预设的B |
+
+核心爽点：主角在更高层面的思考、准备和掌控力。计谋要比反派更早一层。
+
+---
+
+## Hook上瘾模型
+
+套用 Hook 上瘾模型（触发 → 行动 → 奖励 → 投入），每个要素对应一个人性原罪：
+
+| 要素 | 钩子 | 原罪 | 网文对应 |
+|------|------|------|----------|
+| 触发 | 欲望 | 妄想 | 切入点——提醒读者他想要什么，不是硬塞的 |
+| 行动 | 简单 | 懒惰 | 行文标准——开篇繁琐 = 门槛太高，简单才能重复上瘾 |
+| 奖励 | 运气 | 贪婪 | 收获期待——可预见的奖励乏味，随机不确定才让人期待"下一次" |
+| 投入 | 财富 | 痴迷 | 发展高潮——极品装备/排名/宗门小弟 = 沉没成本难以割舍 |
+
+**奖励随机性**：收获感不仅要有，还得出乎意料（预期收获经验和钱，结果偷回一颗龙蛋）。
+
+---
+
+## 悬念深度机制
+
+### 意外 vs 悬念
+
+意外是炸弹突然爆炸；悬念是听到定时器滴答作响——悬念远比意外有力量。
+
+### 章末断章留悬念
+
+每章结尾让人物面临未解决的危险，读者不得不回来。
+
+### 时间锁
+
+故事前期设置必须在限定时间内发生的事件，压缩时间增强紧张感。
+
+### 期待 > 爽点
+
+铺垫期待远比展现爽点更重要。爽是释放过程，不是情绪本身——紧张/好奇/担忧/愤怒/憋屈比"爽"更持久。长篇关键 = 延迟满足。
+
+### "麻烦消失"是失去读者的根本原因
+
+诡异流升级过快变无敌、种田文发展过快变平推——都是麻烦消失。迎合读者短期喜好可能损害长线期待。
+
+---
+
+## 质量检查清单
+
+写完每一章/每一卷后，逐项检查：
+
+- [ ] **悬念等级达标**：对照强度5级分级表，本章悬念等级是否符合章节定位
+- [ ] **期待链不断裂**：是否至少有一条未解的期待线在运行
+- [ ] **角色反应到位**：每个悬念点是否有角色反应来验证力度
+- [ ] **信息差存在**：读者与角色之间、角色与角色之间是否有信息差
+- [ ] **章末有钩子**：每章结尾是否有至少一个未解决的问题或未达成的期待
+- [ ] **下行力度适中**：挫折是否控制在"小波折"范围，没有导致节奏断裂
+- [ ] **震惊有层次**：震惊是否从点 → 网 → 深度递进，而非一次性爆发
+- [ ] **道具变化可视化**：震惊递进是否有明确的视觉/物理变化支撑
+- [ ] **爽感递增**：每次释放后的爽感是否比上一次更强
+- [ ] **麻烦没有消失**：主角解决问题后是否有新的困境或挑战出现
+- [ ] **多线并行**：是否保持至少两条期待线同时运行
+- [ ] **底牌有压制**：展示底牌后反派是否受到对应压制

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

@@ -0,0 +1,165 @@
+---
+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。
+---
+
+# 输出契约：story-short-analyze ↔ story-short-write
+
+`story-short-analyze` 拆完一篇短篇后，产物落盘到 `拆文库/{书名}/`。`story-short-write`
+写下一篇同题材短篇时，**同时**读这个目录下的全部产出。
+
+---
+
+## 输出目录与文件树
+
+```
+拆文库/{书名}/
+├── 原文/                  # 管道前置步骤产出，存放源文件备份
+├── 拆文报告.md             # 人类可读综合报告（Stage 2-6 综合）
+├── 情节节点.md             # Stage 2 情节节点清单
+├── 写作手法.md             # Stage 4 写作手法分析
+└── _meta.json             # 管道元数据 + 结构计数（resume + 验收数值依据）
+```
+
+**文件名约定**：`拆文报告.md / 情节节点.md / 写作手法.md` 由 `story-short-write` 硬编码
+消费，不可重命名。分析叙事走 markdown，数字/枚举走 `_meta.json.structure_counts`。
+
+---
+
+## Stage → 文件映射
+
+| Stage | 名称 | 落地文件 | 主要内容 |
+|-------|------|----------|---------|
+| 2 | 结构+情节节点 | `拆文报告.md`（故事核/结构/梗概段） + `情节节点.md` | 故事核 / 4-6 段结构 / 故事梗概 / 情节节点清单 |
+| 3 | 情感线+爆点 | `拆文报告.md`（情感曲线段+爆点段） | 情感曲线 ≥5 节点 / 爆点 6 维度 / 期待感 |
+| 4 | 反转+写作手法 | `拆文报告.md`（反转段） + `写作手法.md` | 前置反转检查 / 反转分析（铺垫 ≥2） / 写作手法 ≥5 项 |
+| 5 | 人物+开头结尾 | `拆文报告.md`（人物段+首尾段） | 人物分类+功能评估 / 开头分析 / 结尾分析 / 首尾呼应 |
+| 6 | 综合评估 | `拆文报告.md`（综合段） + `_meta.json`（写 structure_counts） | 五维评分 / 爆点性 / 话题性 / 共鸣 ≥3 层 / 可复用结构 ≥3 条 / 节奏速报 |
+
+---
+
+## `_meta.json` schema
+
+`_meta.json` 是管道元数据 + 结构计数。**不放分析内容**，只放数字和枚举——给验收
+检查做完整性校验用。分析叙事都在 `拆文报告.md` 里。
+
+```jsonc
+{
+  "version": "2.0",
+  "word_count": 5234,                   // 源文字数（Phase 1 探针填入）
+  "genre_detected": "追妻",             // Phase 1 题材识别；未识别填 "通用"
+  "created_at": "{ISO8601 时间戳}",      // 拆文启动时间，写入时填当前 UTC
+  "stages_completed": [2, 3, 4, 5],     // 已完成 Stage，按完成顺序 append
+  "last_stage_in_progress": null,       // 当前正在执行的 Stage；空闲为 null
+
+  "structure_counts": {                 // Stage 6 完成时一次性写入；structure_counts 数值校验依据
+    "beats": 5,                         // 结构段数（结构划分，开端/发展/高潮/结局，Stage 2）
+    "hooks": 4,                         // 钩子数（Stage 3）
+    "setup_clues": 3,                   // 反转铺垫线索数（Stage 4）
+    "character_archetypes": 3,          // 有反差人物数（Stage 5）
+    "reusable_structures": 3,           // 可复用手法条数（Stage 6）
+    "reversal_type": "视角反转"          // 反转类型枚举（视角/身份/动机/时间线/信息/认知/无反转）；甜宠/喜剧/报应型填「无反转」
+  }
+}
+```
+
+### 写入顺序（crash safety）
+
+1. **Stage N 开始前**：`last_stage_in_progress = N`，写盘。
+2. **Stage N 文件写完后**：non-empty + 最小长度合理性检查（如 `拆文报告.md` 新增段 ≥ 200 字）。
+3. **通过**：清空 `last_stage_in_progress`，append `N` 到 `stages_completed[]`。
+4. **失败**：`stages_completed` 不动，`last_stage_in_progress` 保留为 `N`。
+5. **Stage 6 完成时额外动作**：把 `structure_counts` 一次性算出并写入 `_meta.json`，
+   然后才进入验收。
+
+### Resume 协议
+
+- `last_stage_in_progress` 非空 → 该 Stage 上次中断，**从头**重跑（不复用半成品）。
+- `last_stage_in_progress` 为空 → 从 `max(stages_completed) + 1` 开始。
+- `stages_completed` 含 6 → 已完成，询问用户覆盖/取消。
+
+**Stage 6 = 内容写完 AND 验收通过**。验收未过前 `last_stage_in_progress` 保持 `6`、`stages_completed` 不含 `6`；resume 时正文/structure_counts 已在盘上，只重跑验收检查，不重写 Stage 6 正文。
+
+---
+
+## 验收接入点
+
+Stage 6 内容写完后、`stages_completed[6]` append 前，跑三道检查：
+
+### Step 1：拆文报告 AI 腔自检
+
+扫描 `拆文报告.md` 全文 against 拆文流程本地加载的禁用词表与报告 AI 腔规则。
+这是拆文报告质量门；成稿去 AI 规则由写作流程在自己的 Skill 内维护，不跨 Skill 读取参考文件，也不要把两套规则混用。
+命中 → 不写 `stages_completed[6]`，列出位置请用户修订**拆文报告本身**的 AI 腔
+（源文里有 AI 腔不算——这里扫的是分析师写的报告）。
+
+### Step 2：`_meta.json.structure_counts` 数值校验
+
+| 字段 | 最低值 | 不达标 |
+|------|--------|--------|
+| `structure_counts.beats` | ≥ 4（结构段：开端/发展/高潮/结局）| 阻断 |
+| `structure_counts.hooks` | ≥ 3 | 阻断 |
+| `structure_counts.setup_clues` | ≥ 3（reversal_type=无反转时跳过本行）| 阻断 |
+| `structure_counts.character_archetypes` | ≥ 2 | 阻断 |
+| `structure_counts.reusable_structures` | ≥ 3 | 阻断 |
+| `structure_counts.reversal_type` | 在枚举内（含「无反转」）| 阻断 |
+| `genre_detected` | 非空 | 阻断 |
+
+> 情节节点数（15-60 个，按字数分档）走 `情节节点.md` 自己的密度校验（见 material-decomposition.md），不在本表。`beats` 是结构段数，不是情节节点数。
+
+### Step 3：`story-short-analyze` BLOCK 项扫描
+
+扫拆文流程本地加载的输出模板，确认所有 `[BLOCK]` 标注项对应的产出段均在 `拆文报告.md` 出现。
+任一缺失 → 阻断。`[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.version` 与本文件 `sync-policy` 联动。
+- breaking change（字段重命名 / 类型变更 / 必填变更）必须 bump major version 并同步两侧
+  副本，CI 通过 `scripts/check-shared-files.sh` 拦截单边修改。
+- additive change（新增可选字段）可 bump minor；producer、consumer 与两侧副本必须在同一变更中升级到当前 schema。