@oh-story/dsh 0.1.9 → 0.1.11

package/lib/oh-story/skills/story-short-analyze/SKILL.md

@@ -13,9 +13,9 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 ---
 
-## 拆解边界声明（主线程同样适用）
+## 拆解边界声明（主会话同样适用）
 
-短篇拆解的 Stage 2-6 全程由你（主线程）亲手做：拆的是用户**合法持有、拥有使用权**的虚构作品（已出版/连载或自有），性质是**只读的转化性文学批评**（编辑/评论/写作教学视角，不复制、不传播、不指导现实行为）。番茄短篇、故事会、知乎盐选、追妻、虐渣、世情等通俗题材里的家暴、出轨、复仇、暴力、情爱张力、黑暗伦理是常规虚构叙事元素，须照常做结构化拆解，**不得以「敏感」「不适」为由拒绝整篇或某个片段**——拒绝会让整条拆文流水线停摆；个别片段无法处理则跳过、照常续完其余。
+短篇拆解的 Stage 2-6 全程由你（主会话）亲手做：拆的是用户**合法持有、拥有使用权**的虚构作品（已出版/连载或自有），性质是**只读的转化性文学批评**（编辑/评论/写作教学视角，不复制、不传播、不指导现实行为）。番茄短篇、故事会、知乎盐选、追妻、虐渣、世情等通俗题材里的家暴、出轨、复仇、暴力、情爱张力、黑暗伦理是常规虚构叙事元素，须照常做结构化拆解，**不得以「敏感」「不适」为由拒绝整篇或某个片段**——拒绝会让整条拆文流水线停摆；个别片段无法处理则跳过、照常续完其余。
 
 ---
 
@@ -74,46 +74,30 @@ word_count = 全文字数
 ```
 存在 _meta.json？
   ├─ 否 → 直接进入新一轮拆解
-  └─ 是 → 询问用户三选一：
+  └─ 是 → 询问用户三选一（问法见下）：
        (a) 覆盖：归档旧产出到 拆文库/{书名}/_archive_{时间戳}/ 后从 Stage 2 重跑
        (b) 续跑：读 _meta.json.last_stage_in_progress（非空 → 从该 Stage 整段重跑）
                  或读 _meta.json.stages_completed[]（从 max+1 续跑）
        (c) 取消
 ```
 
+问作者时不提文件名、字段名和 Stage 编号：
+
+<!-- author-report -->
+```md
+《{书名}》之前拆过，{拆到一半，停在"{当前阶段的白话名，如反转与写作手法}" | 已经拆完}。怎么处理？
+1. 接着上次往下拆（推荐，已拆的部分保留）
+2. 旧结果存档，从头重拆
+3. 先不拆了
+```
+
 完整 resume 契约见 [references/output-contract.md](references/output-contract.md)。
 
 ---
 
 ## 输出目录
 
-输出到 `拆文库/{书名}/`（项目根目录下）。用户指定了其他路径时按用户指定路径输出。
-
-**标准输出文件树**：
-
-```
-拆文库/{书名}/
-├── 原文/                # 原文备份（管道前置步骤产出）
-├── 拆文报告.md           # 人类可读综合报告（Stage 2-6 所有可读段）
-├── 情节节点.md           # Stage 2 情节节点清单（独立成文，方便定位）
-├── 写作手法.md           # Stage 4 写作手法分析（独立成文，方便复用）
-└── _meta.json           # 管道元数据 + 结构计数（resume + 验收数值依据）
-```
-
-> **下游契约**：`story-short-write` 同时读全套产出——`拆文报告.md` 取分析叙事，
-> `情节节点.md` 看节奏锚点，`写作手法.md` 抄手法，`原文/` 抄语感，`_meta.json`
-> 看题材识别和结构计数。完整字段定义见
-> [references/output-contract.md](references/output-contract.md)。
-
-### Stage → 文件映射
-
-| Stage | 落地文件 |
-|-------|----------|
-| 2 | `拆文报告.md`（故事核+结构+梗概段） + `情节节点.md` |
-| 3 | `拆文报告.md`（情感曲线+爆点段） |
-| 4 | `拆文报告.md`（反转段） + `写作手法.md` |
-| 5 | `拆文报告.md`（人物+首尾段） |
-| 6 | `拆文报告.md`（综合段） + `_meta.json.structure_counts`（数值计入元数据） |
+输出到 `拆文库/{书名}/`（项目根目录下；用户指定了其他路径时按用户指定）：`原文/`、`拆文报告.md`、`情节节点.md`、`写作手法.md`、`_meta.json`。三个 markdown 由下游 `story-short-write` 硬编码读取，不可改名；文件树、Stage → 文件映射与 `_meta.json` 字段见 [references/output-contract.md](references/output-contract.md)。
 
 ### 原文备份（管道前置步骤）
 
@@ -140,80 +124,50 @@ word_count = 全文字数
 
 | 阶段 | 名称 | 输入 | 输出 | 完成标志 |
 |------|------|------|------|----------|
-| 2 | 结构+情节节点 | 全文 | 故事核 + 故事梗概 + 功能分段（4-6段，必须含开端/发展/高潮/结局）+ 情节节点清单。节点以语义变化为边界提取，见 material-decomposition.md「情节节点提取规则」。 | 结构划分 ≥4 段 + 故事核已提取 |
+| 2 | 结构+情节节点 | 全文 | 故事核 + 故事梗概 + 功能分段（4-6段，必须含开端/发展/高潮/结局）+ 情节节点清单（以语义变化为边界提取）。 | 结构划分 ≥4 段 + 故事核已提取 |
 | 3 | 情感线+爆点 | 故事核+结构划分+情节节点数据 | 情感曲线（≥5节点）+ 爆点分析（6维度）+ 期待感分析。 | 爆点分析 6 维度齐全 |
-| 4 | 反转+写作手法 | 节点+情感数据 | 前置反转检查 + 反转机制（铺垫≥2条）+ 写作手法（≥5项维度：POV/对话/时间/信息/其他）。 | 写作手法 ≥5 项 |
+| 4 | 反转+写作手法 | 节点+情感数据 | 前置反转检查 + 反转机制（铺垫≥3条）+ 写作手法（≥5项维度：POV/对话/时间/信息/其他）。 | 写作手法 ≥5 项 |
 | 5 | 人物+开头结尾 | 情节节点+全文 | 所有人物（分类+功能标签+功能评估）+ 开头分析（前50/100字）+ 结尾分析（收束检查）。 | 人物功能评估完成 |
-| 6 | 综合评估 + `_meta.json` 写计数 | 全部数据 | 五维评分 + 爆点性 + 话题性 + 共鸣分析（≥3层）+ 可复用结构（≥3条）+ 节奏速报 + **算出并写入 `_meta.json.structure_counts`**。 | 五维评分完成 + 爆点性/话题性已分析 + 共鸣≥3层 + 可复用≥3条 + 节奏速报已包含 + `_meta.json.structure_counts` 各字段达「structure_counts 数值校验」阈值 |
+| 6 | 综合评估 + `_meta.json` 写计数 | 全部数据 | 五维评分 + 爆点性 + 话题性 + 共鸣分析（≥3层）+ 可复用结构（≥3条）+ 节奏速报 + **算出并写入 `_meta.json.structure_counts`**。 | 左列输出齐全 + `structure_counts` 各字段达「structure_counts 数值校验」阈值 |
 
 > 管道执行顺序：2 → 3 → 4 → 5 → 6（严格串行，每阶段依赖前一阶段数据）。可选模块
-> （同类对比、平台适配、详细节奏）可在 Stage 6 后执行。
+> （同类对比、平台适配、详细节奏）可在 Stage 6 后执行，读 [references/optional-modules.md](references/optional-modules.md)。
 
-**Stage 写盘协议**（crash safety）：每个 Stage 开始前先把 `_meta.json.last_stage_in_progress`
-置为当前 Stage 编号；该 Stage 所有目标文件写完后再做 non-empty / 最小长度检查，通过
-才清空 `last_stage_in_progress` 并 append 到 `stages_completed[]`。半成品文件不被
-信任，resume 时该 Stage 整段重跑。完整协议见
-[references/output-contract.md](references/output-contract.md) 「写入顺序 (crash safety)」段。
+### 按时刻读
 
-**非标文本分段**：对话体、聊天记录、帖子体、书信体等非标准章节格式，先按时间/说话人
-切换/信息揭示点分段，再映射到开端、发展、高潮、结局；不要机械按自然段数量切分。
+管道分两个时刻，进入时刻只读该行的文件；两个时刻之间只靠落盘的 `拆文报告.md`、`情节节点.md`、`写作手法.md` 和 `_meta.json` 交接，续跑或换新对话都按 `_meta.json` 的进度接上。
+
+| 时刻 | 读 | 交接 |
+|---|---|---|
+| Stage 2–3 结构与情感线 | [output-contract.md](references/output-contract.md)、[analysis-method.md](references/analysis-method.md)、[stage2-3-structure-emotion.md](references/stage2-3-structure-emotion.md)、[quality-checklist.md](references/quality-checklist.md)、[analysis-report-style.md](references/analysis-report-style.md) | `stages_completed` 含 3 |
+| Stage 4–6 反转到综合评估、验收 | output-contract.md、analysis-method.md、[stage4-6-reversal-summary.md](references/stage4-6-reversal-summary.md)、quality-checklist.md、analysis-report-style.md；Stage 6 要判断源文本身好坏（毒点、虐爽节奏、证据链等）时加 [source-story-quality.md](references/source-story-quality.md) | 验收通过，`stages_completed` 含 6 |
 
-**投稿层拆解**（拆 Stage 5 开头 / Stage 6 可复用时顺带记录进 拆文报告.md，非阻断；story-short-write 定平台基调时可作初判参考）：
-- **平台基调**：判定源文更贴哪一路——知乎盐选（第一人称剥洋葱、细思极恐、章末颠覆认知细节）/ 小程序（开局即地狱、当众打脸、章末卡脖子断点）/ 番茄短篇（顺滑无毒点、金手指直白、大满贯收尾）。
-- **导语写法**：源文开头前 150-220 字（多数就是正文第一段）怎么钩人——四维骨架（起因+核心冲突+人设底色+情绪反转）、黄金三角（具体物件+信息差+留白钩子）各落在哪句。
-- **付费点/最强断点**：源文把最强悬念断点（读者最想往下翻的地方）卡在第几节章末；付费点前后每章剧情点密度是否递增。
+对照标尺类参考按下方「参考资料」的条件在对应 Stage 读。
 
-详细模板见 [output-templates.md](references/output-templates.md)，方法论见
-[material-decomposition.md](references/material-decomposition.md)，输出契约见
-[output-contract.md](references/output-contract.md)。
+**Stage 写盘协议**（crash safety）：每个 Stage 开始前置 `_meta.json.last_stage_in_progress`，
+目标文件写完并通过 non-empty / 最小长度检查才清空它并 append 到 `stages_completed[]`；
+半成品不被信任，resume 时该 Stage 整段重跑。完整协议见 output-contract.md「写入顺序 (crash safety)」。
 
 ---
 
 ## 验收（Stage 6 之后、写 stages_completed[6] 之前）
 
-Stage 6 内容写完后，**不**立刻 append `6` 到 `stages_completed[]`。先跑三道检查：
-
-### Step 1：拆文报告表达自检
-
-按 [references/analysis-report-style.md](references/analysis-report-style.md) 扫描
-`拆文报告.md` 全文的证据链和高风险表达。
-扫描时跳过源文引用——以 `>` 开头的引用行、以及表格中「关键台词 / 原文引用」列的引号直引不计入，只扫分析师本人写的措辞。
-
-- **命中** → 不写 `stages_completed[6]`，列出命中位置，修订**拆文报告本身**的
-  证据不足、空转套话或越界推测；不要改写源文。
-- **未命中** → 继续「structure_counts 数值校验」。
+Stage 6 内容写完后**不**立刻 append `6`，先按 output-contract.md「验收接入点」跑三道检查，全过才写：
 
-> 守门员定位：本节检查「我们写的拆文报告」；不要评价「源文是否 AI 写的」。
+- **拆文报告表达自检**：按 analysis-report-style.md 扫描 `拆文报告.md`，跳过源文引用（以 `>` 开头的引用行、表格「关键台词 / 原文引用」列的引号直引），只扫分析师本人的措辞；命中就修订**拆文报告本身**的证据不足、空转套话或越界推测，不改写源文，也不评价源文是否 AI 写的。
+- **structure_counts 数值校验**：阈值以 output-contract.md 为准（单一权威），注意「无反转」是合法枚举，此时 `setup_clues` 跳过、不计入阻断。
+- **BLOCK 项扫描**：扫 quality-checklist.md 全部 `[BLOCK]` 项；`[WARN]` 缺项不阻断，写入 `拆文报告.md` 末尾「待补」清单供用户决定。
 
-### Step 2：`_meta.json.structure_counts` 数值校验
+任一阻断 → 回到对应 Stage 补足；原文确实没有、补不出来时，用故事话告诉作者缺什么（如「反转前的铺垫线索只找到 1 条」），不报字段名和 Stage 编号。全通过 → 清空 `_meta.json.last_stage_in_progress`，append `6` 到 `stages_completed[]`，按下方格式告诉作者：
 
-按 [references/output-contract.md](references/output-contract.md) 「structure_counts 数值校验」表
-逐项检查 `_meta.json` 里 Stage 6 写入的结构计数。阈值与 carve-out 以 output-contract.md 为准（单一权威，不在此重复内联表以免漂移）——特别注意两条合法产出态：`reversal_type` 枚举**含「无反转」**（甜宠/喜剧/报应型）；`reversal_type=无反转` 时 **`setup_clues` 跳过该行、不计入阻断**。
-
-任一项不达标 → 阻断；列出未达标字段，提示用户回到对应 Stage 补足。
-
-### Step 3：`output-templates.md` [BLOCK] 项扫描
-
-扫描 `output-templates.md` 中所有 `[BLOCK]` 标注项，确认对应产出段已完成。任一缺失
-→ 阻断。`[WARN]` 项不阻断，但写入 `拆文报告.md` 末尾的「待补」清单供用户决定。
-
-### Step 4：通过
-
-「拆文报告 AI 腔自检」「structure_counts 数值校验」和「BLOCK 项扫描」全通过 → 清空 `_meta.json.last_stage_in_progress`，append `6` 到
-`stages_completed[]`，提示用户「拆解完成，可调用 `/story-short-write` 写下一篇」。
-
----
-
-## 质量检查概要
-
-各阶段完成后需通过质量检查。逐项 checklist 见
-[output-templates.md 质量检查必填字段](references/output-templates.md)。
-
-质量标准的阈值、数值与计算方式的唯一权威定义见
-[material-decomposition.md 质量标准](references/material-decomposition.md)。
-
-强阻断 / 警告区分：见 `output-templates.md` 每条 checklist 末尾的 `[BLOCK]` /
-`[WARN]` 标注。`[BLOCK]` 不通过 → 「BLOCK 项扫描」阻断。
+<!-- author-report -->
+```md
+《{书名}》拆完了，结果在 `拆文库/{书名}/`。
+- 这篇靠什么抓人：{一句话故事核}
+- 最值得学的 3 点：{白话，各附一句原文或情节例子}
+- 还缺的：{拆文报告末尾"待补"里需要作者决定的项；没有就写"无"}
+下一步：想照这个路子写一篇，运行 `/story-short-write`。
+```
 
 ---
 
@@ -232,38 +186,30 @@ Stage 6 内容写完后，**不**立刻 append `6` 到 `stages_completed[]`。
 
 ## 参考资料
 
-### 核心方法论（拆文时必须加载）
-
-| 文件 | 何时加载 |
-|------|----------|
-| [references/output-contract.md](references/output-contract.md) | 全程：Stage→文件映射 / `_meta.json` schema（含 structure_counts）/ 下游消费规范 / 验收接入点 |
-| [references/output-templates.md](references/output-templates.md) | 拆文时：输出模板 + 结构库 + 质量检查（含 [BLOCK]/[WARN] 标注） |
-| [references/material-decomposition.md](references/material-decomposition.md) | 拆文方法论：情节节点提取 + 写作手法 + 情感线 + 节奏分析 + 共鸣分析 + 人物规则 + **质量标准唯一权威** |
-| [references/source-story-quality.md](references/source-story-quality.md) | 评估**源文**质量时：短篇拆书的质量自检清单（评估对象的好坏，不是评估拆文报告本身） |
-| [references/analysis-report-style.md](references/analysis-report-style.md) | 「拆文报告表达自检」：检查**报告本身**的证据链、高风险套话与推测边界（不是源文滤镜） |
+核心方法与模板按上方「按时刻读」加载；以下是对照标尺，按条件读。
 
-### 按需加载（拆解对应题材 / 维度时作为对照标尺）
+### 按需加载（拆解对应题材 / 维度时作为对照标尺，一次只查一份）
 
 | 文件 | 何时加载 |
 |------|----------|
-| [references/deconstruction-examples.md](references/deconstruction-examples.md) | 校准拆文方法时：3 个完整案例作为参照 |
-| [references/zhihu-style.md](references/zhihu-style.md) | 拆解知乎盐言故事时作为平台特性对照 |
-| [references/analysis-short-genres.md](references/analysis-short-genres.md) | 拆解特定题材时：按短篇源文的识别锚点、读者承诺和结算归属判断主副类型 |
-| [references/analysis-short-hooks.md](references/analysis-short-hooks.md) | 拆解段落/小节边界、钩子链与候选付费断点时作为短篇源文观察标尺 |
-| [references/analysis-short-suspense.md](references/analysis-short-suspense.md) | 拆解主副问题、信息差、证据释放、阶段答案与回收时作为短篇源文观察标尺 |
-| [references/analysis-paragraph-hooks.md](references/analysis-paragraph-hooks.md) | 拆解段落钩子时作为 11 种段落级钩子对照 |
-| [references/analysis-character-basics.md](references/analysis-character-basics.md) | 拆解人物基础设定时作为人设要素对照 |
-| [references/analysis-character-design.md](references/analysis-character-design.md) | 拆解人物内在矛盾时作为三层标签反差对照（contradiction_axis 来源） |
-| [references/analysis-character-relations.md](references/analysis-character-relations.md) | 拆解人物关系网时作为关系类型对照 |
-| [references/analysis-short-mechanics.md](references/analysis-short-mechanics.md) | 拆解核心梗、有限复现、规则兑现、代价与主角代理权时作为观察标尺 |
-| [references/analysis-reader-profile.md](references/analysis-reader-profile.md) | 拆解读者心理与期待管理时作为读者画像对照 |
+| [references/deconstruction-examples.md](references/deconstruction-examples.md) | 校准拆文方法：3 个完整案例 |
+| [references/zhihu-style.md](references/zhihu-style.md) | 拆知乎盐言故事：平台特性对照 |
+| [references/analysis-short-genres.md](references/analysis-short-genres.md) | Phase 1 / Stage 2 判主副类型：识别锚点、读者承诺、结算归属 |
+| [references/analysis-short-hooks.md](references/analysis-short-hooks.md) | Stage 3 / 5：段落与小节边界、钩子链、候选付费断点 |
+| [references/analysis-short-suspense.md](references/analysis-short-suspense.md) | Stage 3 / 4：主副问题、信息差、证据释放、阶段答案与回收 |
+| [references/analysis-paragraph-hooks.md](references/analysis-paragraph-hooks.md) | Stage 3 / 5：11 种段落级钩子对照 |
+| [references/analysis-character-basics.md](references/analysis-character-basics.md) | Stage 5：人设要素对照 |
+| [references/analysis-character-design.md](references/analysis-character-design.md) | Stage 5 细拆反差手法：按标题查「三层标签反差人设法」（数反差人物用 stage4-6 的判定，不读本文件） |
+| [references/analysis-character-relations.md](references/analysis-character-relations.md) | Stage 5：关系类型对照 |
+| [references/analysis-short-mechanics.md](references/analysis-short-mechanics.md) | Stage 2 / 6：核心梗、有限复现、规则兑现、代价与主角代理权 |
+| [references/analysis-reader-profile.md](references/analysis-reader-profile.md) | Stage 3 / 6：读者心理与期待管理 |
 
 ### 补充资料（拆 Stage 6「可复用结构」时按需对照）
 
 > **短篇结构模式**：`references/analysis-short-patterns.md`（比较源文实际功能链、偏离方式
 > 与失败条件；不按固定章位、百分比或线索数判“合标”）
 > **通用写作技法**：`references/analysis-writing-techniques.md`（情绪操控 / 感情线 /
-> 震惊场景 / 喜剧机制——拆 reusable_structures.fail_mode 时引用「感情线四阶段推进法」表「禁忌」列）
+> 震惊场景 / 喜剧机制——拆 reusable_structures.fail_mode 时按标题只查「感情线四阶段推进法」表的「禁忌」列，不整读）
 > **市场数据**：`references/real-market-data.md`（跨平台写作差异对照表）
 
 所有 references 在 `story-short-analyze` 中都是**观察标尺**——先报告源文实际发生了什么，

package/lib/oh-story/skills/story-short-analyze/references/analysis-character-relations.md

@@ -161,7 +161,7 @@
 
 检查角色行为是否只是为了让剧情往某方向发展。如果角色"恰好"做了推进剧情的事但没有自身动机，标记为"人设偏移"，必须为该行为补充角色层面的合理理由。
 
-### 第二步：情绪目标确认
+### 第二步：目标情绪确认
 
 写每段前明确三个要素：
 1. 本段目标情绪：这段剧情要让读者产生什么情绪？

package/lib/oh-story/skills/story-short-analyze/references/analysis-method.md

@@ -0,0 +1,42 @@
+# 短篇拆解思路
+
+Stage 2–3 与 Stage 4–6 两个时刻都读本文件：拆什么、按什么顺序拆、不能怎么拆。
+
+## 拆解思路
+
+### 核心原则
+
+| 原则 | 说明 |
+|------|------|
+| 故事核驱动 | 先找到故事的核心梗（一句话），所有分析围绕故事核展开。故事核变了，整篇的分析方向都会变 |
+| 读者视角优先 | 每一步从读者体验出发——读者看到了什么？感受到了什么？为什么在意？不猜测创作者动机，只分析文本实际制造的读者体验 |
+| 可复用性导向 | 每个分析点都要输出可迁移的结构、功能位或风险阈值；纯欣赏型分析不合格 |
+| 爆点为中心 | 短篇拆文的核心问题是——什么让读者情绪爆发？什么让读者想转发？找到爆点，拆解它的铺垫和释放机制 |
+| 共鸣决定传播 | 一篇短篇能火，关键在引发共鸣；文笔好坏不单独决定传播。共鸣层次越多，传播性越强 |
+
+### 分析顺序（从外到内，层层递进）
+
+故事核（写的是什么，锚定一切分析的起点）→ 结构（怎么布局的）→ 人物（谁在推动故事）→ 情感线（读者感受到了什么）→ 写作手法（怎么写出来的）→ 共鸣+爆点性+话题性（为什么能火）→ 综合评估（可借鉴结构）
+
+### 每个阶段的核心问题
+
+拆文目标是回答问题，不能机械填表。每个阶段都有一个核心问题：
+
+| 阶段 | 核心问题 | 回答不了说明 |
+|------|----------|-------------|
+| 故事核 | 一句话讲清楚这个故事卖什么？ | 还没读懂，别急着拆 |
+| 结构 | 文本如何布局？开端/发展/高潮/结局各占多少？ | 布局决定了节奏，不知道布局就不知道节奏 |
+| 人物 | 谁是主人公？谁是主动型角色？谁是被动型角色？ | 不知道谁在推故事，就不知道故事怎么动的 |
+| 情感线 | 读者的情绪是怎么被一步步拉扯的？ | 这是短篇的核心价值，拆不出来等于白拆 |
+| 写作手法 | 文本用了什么手法让读者产生这种体验？ | 手法必须被拆成可复用功能位，否则无法迁移 |
+| 共鸣+爆点 | 为什么这篇能火？触发了什么共鸣？ | 不回答这个问题，拆文就变成了文学鉴赏 |
+| 综合评估 | 哪些结构可复用？复用条件和风险是什么？ | 不能指导下一份 artifact 的拆文没有意义 |
+
+### 拆解约束
+
+1. **禁止主观评价** — 不评价好坏，只拆解机制。输出中不得出现"写得好/写得差"类评价
+2. **从体验反推手法** — 先定位读者情绪高峰，再反推文本用什么手法制造了这个高峰
+3. **深度优先于全面** — 核心维度（故事核/爆点/共鸣）必须深入，可选维度按需
+4. **可复用性导向** — 每个分析点必须输出复用条件、可迁移做法和风险边界
+
+---

package/lib/oh-story/skills/story-short-analyze/references/optional-modules.md

@@ -0,0 +1,97 @@
+# 可选模块：同类对比、平台适配、详细节奏
+
+作者要求或 Stage 6 之后需要时读本文件；不在主管道里。
+
+## 方法
+
+### 同类对比
+
+将分析对象与同题材、同结构的其他作品对比：
+
+| 维度 | 本文 | 对标作品A | 对标作品B |
+|------|------|----------|----------|
+| 情感曲线形态 | | | |
+| 核心手法 | | | |
+| 开头钩子强度 | 1-5 | 1-5 | 1-5 |
+| 反转惊喜度 | 1-5 | 1-5 | 1-5 |
+| 结尾余韵 | 1-5 | 1-5 | 1-5 |
+
+**差异化亮点**：关键差异是优势还是劣势？
+
+### 平台适配评估
+
+| 平台 | 适配度 | 原因 | 调整动作 |
+|------|--------|------|----------|
+| 知乎盐言 | 高/中/低 | 偏重文笔和情感深度，8000-12000字 | |
+| 番茄短篇 | 高/中/低 | 偏重节奏和爽感，5000-10000字 | |
+| 七猫短篇 | 高/中/低 | 偏重故事完整性和可读性，6000-12000字 | |
+
+### 详细节奏分析
+
+逐节标注节奏指标，形成节奏分布图：
+
+| 节 | 字数 | 事件密度 | 对话占比 | 冲突占比 | 节奏判断 |
+|----|------|----------|----------|----------|----------|
+
+---
+
+## 输出模板
+
+### 同类对比模板
+
+> 方法见上方「同类对比」。
+
+| 维度 | 本文 | 对标作品A | 对标作品B |
+|------|------|----------|----------|
+| 情感曲线形态 | {如：压缩弹簧} | {如：V形} | {如：波浪} |
+| 核心手法 | {如：假死+信息差} | {如：时间线反转} | {如：套娃反转} |
+| 开头钩子强度 | {1-5} | {1-5} | {1-5} |
+| 反转惊喜度 | {1-5} | {1-5} | {1-5} |
+| 结尾余韵 | {1-5} | {1-5} | {1-5} |
+
+**差异化亮点**：{本文与同类作品的关键差异，是优势还是劣势}
+
+---
+
+### 平台适配评估模板
+
+> 方法见上方「平台适配评估」。
+
+| 平台 | 适配度 | 原因 | 调整动作 |
+|------|--------|------|----------|
+| 知乎盐言 | {高/中/低} | {原因} | {如有} |
+| 番茄短篇 | {高/中/低} | {原因} | {如有} |
+| 七猫短篇 | {高/中/低} | {原因} | {如有} |
+
+---
+
+### 详细节奏分析模板
+
+> 指标与异常类型见 [stage4-6-reversal-summary.md](stage4-6-reversal-summary.md)「节奏分析」。
+
+#### 节奏指标
+
+> 各维度数值只作文本描述。判断须回到具体节点、状态变化和后果，并在存在对标时与同题材、同平台样本比较。
+
+| 维度 | 数值 | 判断 |
+|------|------|------|
+| 事件密度 | {N}个/千字 | {文本分布与真实状态变化} |
+| 对话密度 | {X%} | {文本倾向、对白功能与无对白推进方式} |
+| 冲突密度 | {X%} | {直接冲突与任务/证据/空间/关系压力的关系} |
+| 信息密度 | {X%} | {读者模型变化与消化效果} |
+
+#### 逐节节奏分布
+
+| 节 | 字数 | 事件密度 | 对话占比 | 冲突占比 | 节奏判断 |
+|----|------|----------|----------|----------|----------|
+| 1 | {N} | {X/千字} | {Y%} | {Z%} | {快/中/慢/过渡} |
+
+#### 节奏异常
+
+| 异常类型 | 位置 | 说明 |
+|----------|------|------|
+| {节奏塌陷/压力过载/信息洪峰/对白失效/对白挤压场景/反转过载} | {节N} | {具体说明} |
+
+如无异常，注明"节奏无明显异常"。
+
+---

package/lib/oh-story/skills/story-short-analyze/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-analyze/references/quality-checklist.md

@@ -0,0 +1,80 @@
+# 质量检查与验收清单
+
+每个 Stage 写完按对应小节自检；Stage 6 之后的「BLOCK 项扫描」扫本文件全部 `[BLOCK]` 项。
+
+## 质量检查必填字段
+
+Stage 完成前逐项检查，缺一即不完整。**节点密度、对话占比等只作结构化描述；质量判断须引用具体场景功能、状态变化和同题材对标，不设通用数值阈值。**
+
+**标注约定**：
+
+- `[BLOCK]`：量化或必备产物，缺失 → 「BLOCK 项扫描」阻断，不写 `_meta.json.stages_completed[6]`，自己回去补写那一部分；原文确实没有、补不出来时，用故事话告诉作者缺什么（如「反转前的铺垫线索只找到 1 条」）。
+- `[WARN]`：质性或辅助项，缺失 → 写入 `拆文报告.md` 末尾「待补」清单，**不阻断**进入下一阶段。
+
+**Stage 2（结构+情节节点）**：
+- [ ] 故事核已提取（一句话核心梗） `[BLOCK]`
+- [ ] 结构划分 4-6 段（必须含开端/发展/高潮/结局），每段有字数范围、占比和功能 `[BLOCK]`
+- [ ] 结局类型已标注 `[WARN]`
+- [ ] POV 已识别 `[WARN]`
+- [ ] 叙事时间线已标注 `[WARN]`
+- [ ] 情节节点覆盖全文真实变化，没有为凑数量重复记录同一事件（见 [stage2-3-structure-emotion.md](stage2-3-structure-emotion.md)「情节节点提取规则」） `[BLOCK]`
+- [ ] 每个节点有情绪标记（类型 + 强度值） `[BLOCK]`
+
+**Stage 3（情感线+爆点）**：
+- [ ] 至少 5 个情感节点，覆盖每一处情绪立场、期待或压力变化，每个有字数位置、强度值和方向（虐-9~爽+9） `[BLOCK]`
+- [ ] 每个节点标注了钩子类型（含"无"） `[WARN]`
+- [ ] 曲线特征 5 项齐全（起始/走向/极值/方向差/翻转次数） `[BLOCK]`
+- [ ] 爆点分析 6 维度齐全（铺垫/积累/延迟/爆发点/余波/印象） `[BLOCK]`
+- [ ] 期待感表已完成 `[WARN]`
+
+**Stage 4（反转+写作手法）**：
+- [ ] 前置反转检查已执行（存在/不存在） `[WARN]`
+- [ ] 反转类型已识别 `[BLOCK]`
+- [ ] 铺垫线索至少 3 条，含原文位置（无反转/报应型不查） `[BLOCK]`
+- [ ] 误导方向已说明 `[WARN]`
+- [ ] 写作手法分析 ≥5 项维度 `[BLOCK]`
+- [ ] POV 策略已分析（选择效果+代价+切换） `[WARN]`
+- [ ] 对话指标已量化（占比+潜台词率） `[WARN]`
+
+**Stage 5（人物+开头结尾）**：
+- [ ] 所有有名人物已提取，有二维分类（叙事角色：主人公/重要配角/功能人物 + 行动角色：主动型/被动型/转变型） `[BLOCK]`
+- [ ] 人物功能评估已完成 `[BLOCK]`
+- [ ] 人物关系已标注演变轨迹 `[WARN]`
+- [ ] 前 3 句话原文引用 `[BLOCK]`
+- [ ] 前50字/前100字检查已完成 `[WARN]`
+- [ ] 开头情绪强度已标注（1-10） `[WARN]`
+- [ ] 结尾类型和情绪落点已说明 `[WARN]`
+- [ ] 钩子回收检查已完成 `[WARN]`
+- [ ] 首尾呼应分析已完成 `[WARN]`
+- [ ] 所有钩子已标注回收状态（已回收/留白/遗漏） `[WARN]`
+
+**Stage 6（综合评估）**：
+- [ ] 一句话评价是具体机制（非泛泛赞美） `[WARN]`
+- [ ] 五维评分每项有具体说明（非泛泛而谈） `[BLOCK]`
+- [ ] 爆点性已分析 `[BLOCK]`
+- [ ] 话题性已分析 `[BLOCK]`
+- [ ] 共鸣分析至少 3 层 `[BLOCK]`
+- [ ] 至少 3 条可复用结构，每条含适用场景 `[BLOCK]`
+- [ ] 同类型写作动作是具体行动 `[WARN]`
+- [ ] `_meta.json.structure_counts` 已写入且各字段达「structure_counts 数值校验」阈值（详见 [output-contract.md](output-contract.md) 同名表） `[BLOCK]`
+- [ ] 节奏速报已包含
+
+**验收接入**：以上 `[BLOCK]` 项与 [output-contract.md](output-contract.md)「structure_counts 数值校验」表共同构成「BLOCK 项扫描」的检查清单，在 Stage 6 内容写完后、`stages_completed[6]` append 前调用本节。
+
+## 质量标准
+
+### 拆解完整性检查
+
+| 指标 | 阈值 | 计算 | 不达标处理 |
+|------|------|------|------------|
+| 情节节点覆盖 | ≥90% | 有明确功能的节点数 / 总节点数 | <90% 检查遗漏 |
+| 情感曲线完整度 | 100% | 每个节点都有情绪标记 | 补充缺失标记 |
+| 写作手法识别数 | ≥5项 | 识别出的手法维度的数量 | <5 项深入分析 |
+| 对话分析覆盖 | ≥80% | 已分析的对话条数 / 总对话条数 | <80% 补充分析 |
+| 人物提取完整 | 100% | 有名人物全部提取 | 补充遗漏人物 |
+
+### 拆文报告质量检查
+
+即上方 Stage 2、Stage 6 清单的报告项：故事核一句话点明核心梗；五维评分每项有具体说明（非"写得很好"）；爆点性与话题性具体指出传播点；共鸣至少 3 层；可复用结构至少 3 条，含手法名+用法+适用场景；同类型写作动作是具体行动，不是"多练习"。
+
+---

package/lib/oh-story/skills/story-short-analyze/references/source-story-quality.md

@@ -2,11 +2,11 @@
 # 源文质量评估清单
 
 > **定位**：story-short-analyze（短篇拆书）的质量自检清单，评估**拆解对象（源文）**的成文质量时逐项核对。
-> 拆书管道本身的质量检查见 output-templates.md「质量检查必填字段」；所有数值阈值的唯一权威定义见 material-decomposition.md「质量标准」与「节奏分析」，本清单不自定义数值。
+> 拆书管道本身的质量检查见 quality-checklist.md「质量检查必填字段」；所有数值阈值的唯一权威定义见 quality-checklist.md「质量标准」与 stage4-6-reversal-summary.md「节奏分析」，本清单不自定义数值。
 >
 > **三类质量的分工（别混用）**：
 >
-> 1. **拆书管道质量检查**（执行过程中）→ [output-templates.md「质量检查必填字段」](output-templates.md)。每条带 `[BLOCK]` / `[WARN]` 标注；`[BLOCK]` 缺失 → 「BLOCK 项扫描」阻断。
+> 1. **拆书管道质量检查**（执行过程中）→ [quality-checklist.md「质量检查必填字段」](quality-checklist.md)。每条带 `[BLOCK]` / `[WARN]` 标注；`[BLOCK]` 缺失 → 「BLOCK 项扫描」阻断。
 > 2. **评估对象（源文）质量**（拆什么样的料）→ 本文件。回答"这篇源文写得好不好"。
 > 3. **拆文报告本身质量**（写什么样的报告）→ [analysis-report-style.md](analysis-report-style.md)。报告自身由「拆文报告表达自检」守门；源文中的套话和 AI 腔仍是分析对象，不作输入过滤。
 
@@ -81,6 +81,7 @@
 ### 五维评分标准
 
 每个维度 0-100 分，根据评分结果选择精修策略。
+严重度：critical、high＝必须修；medium＝建议看；low＝仅提示。
 
 ### 维度 1：核心一致度
 检查：关键冲突、关键行动、人物动机是否前后一致。
@@ -108,7 +109,6 @@
 | 问题 | 严重度 | 修复 |
 |------|--------|------|
 | 段落长度差异过大 | medium | 调整段落划分 |
-| 章节字数偏离目标 | **high** | 写作/大纲修复时先回到细纲补足计划内情节点，再展开；去AI味已有正文时不得新增剧情 |
 | 格式混乱（对话/描写不统一）| low | 统一格式 |
 
 ### 维度 4：可读性
@@ -195,7 +195,7 @@
 
 > **本表评估的是源文**（拆解对象写得好不好），毒点判断必须引用源文证据，不替源文改写。
 > **不要把本表用来评估拆文报告本身**：报告自身走「拆文报告表达自检」+ [analysis-report-style.md](analysis-report-style.md)。
-> **拆文管道完成度** 走 [output-templates.md「质量检查必填字段」](output-templates.md) 的 `[BLOCK]` / `[WARN]` 清单。
+> **拆文管道完成度** 走 [quality-checklist.md「质量检查必填字段」](quality-checklist.md) 的 `[BLOCK]` / `[WARN]` 清单。
 
 | 检查项 | 标准 |
 |--------|------|