@oh-story/dsh 0.1.9 → 0.1.11

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

@@ -1,8 +1,8 @@
 # 短篇写作通用底座
 
 > 短篇网文正文写作的公共父类。服务番茄 / 七猫 / 黑岩 / 盐选通俗短篇（1-2 万字），不是传统文学。
-> 题材风格包（`genre-styles/`）在此基础上做覆盖加味；本文件管所有题材共通的原生写法。
-> **总原则：情绪宁烈不温。短篇是情绪产品，靠直白共鸣留人，不靠克制留白。**
+> 本文件是默认写法；题材包（`genre-styles/`）的腔调、开篇与情绪烈度覆盖这里（如悬疑冷静克制）。
+> **默认总原则：情绪宁烈不温。短篇是情绪产品，靠直白共鸣留人，不靠克制留白。**
 
 ---
 
@@ -57,11 +57,12 @@
 
 ## 4. 小节结构：超短章节制，一节一炸点
 
-按平台两套节奏：
+按平台三套节奏（定平台基调时一并定小节标记与引号，写进 设定.md「平台基调」）：
 
 | 平台 | 小节标记 | 段落 | 篇幅倾向 |
 |------|----------|------|----------|
 | 黑岩 | `###` + 数字（`###1.`） | 段落短、多换行留白 | 小节偏短，长度服从炸点或行动链是否完整 |
+| 知乎盐选 | `1.`（纯数字，对话用「」） | 短段与叙述交织 | 按认知翻转分节，不设单节硬线 |
 | 番茄 / 七猫 | `###第N章` 或 `###1.` | 短段为底色，允许多句回溯叙述段交织对话 | 可承载较完整场景，古言因礼制、空间与关系动作通常更展开；均不设单节硬线 |
 
 - 每个小节围绕一个主问题推进：背叛升级、态度反转、读者新获知信息、行动或后果至少发生一项真实变化；相关变化可由同一动作链同时完成，不强配狠话。
@@ -73,7 +74,7 @@
 
 ## 5. 钩子：极高密度，阶梯式背叛
 
-- 导语 50-300 字塞 3-5 个事件 / 反转；正文让爆料、态度、行动或后果持续变化。连续多个单元不变再查停滞，不为逐节达标塞障碍。
+- 导语约 150-220 字（口径见 submission-craft.md）塞 3-5 个事件 / 反转；正文让爆料、态度、行动或后果持续变化。连续多个单元不变再查停滞，不为逐节达标塞障碍。
 - **阶梯式升级**：道德踩踏 → 经济 → 生命，越揭越大。一页里敢叠多重雷（绝症骗局 + 当众拥吻 + 孩子药引…），别单点反复抒情。
 - **爽点持续前推**：连续若干叙事单元应能看到反打、行动、亮牌或后果，不要长期停在同一情绪闭环；章尾可用反杀预告、局部兑现、关系变化或明确的下一步制造追读缺口，不要求每章同一种炸点。
 - **当众围观放大羞辱**：把背叛 / 打脸放在有外人见证的场合（宴席、股东会、群聊截图、请安），用众人的起哄 / 鄙夷 / 沉默放大屈辱与出气感；独角戏起不来「丢脸感」。
@@ -121,50 +122,13 @@
 | 视角 | 深度限知、不剧透 | 第一人称在场、主动剧透火葬场 |
 | 情绪 | 不设固定译法，按场景落到选择/台词/后果，必要时直写 | 情绪可直给；不强接身体反应 |
 | 章尾 | 禁总结 / 升华 / 预告 | 审判金句 / 火葬场预告是卖点 |
-| 结构 | 贯穿道具三次 / 数字阶梯 | 偷听 / 底牌 / 回旋镖 / 次数累积 |
+| 结构 | 贯穿道具三次 / 数字阶梯 | 偷听 / 底牌 / 回旋镖 / 次数累积；贯穿道具可选，用就三次出现 |
 | 内心 | 独白 ≤ 2 段 | 成段宣泄独白 + 连环反问是主引擎 |
 | 排比 | 砍到一条 | 抒情堆苦难有功能则留 |
 
 ---
 
-## 10. 场景写法：三维度揉进
-
-发生、感知、反应是可选信息维度，不是逐段配额。关键子事件只把确有新信息的维度**织进同一段连续正文，不按维度分段**；上下文已清楚时可以留空：
-
-| 维度 | 内容 | 要点 |
-|------|------|------|
-| 发生 | 事情出现了 | 1-2 句，含一个具体细节 |
-| 感知 | 主角注意到什么 | 只取会改变理解、判断或气氛的声音、物件、空间或身体感受，不按感官凑数 |
-| 反应 | 角色接下来怎么办 | 选择、台词、策略、任务动作、明确感受或有后果的身体变化；不默认补手/眼/呼吸微动作 |
-
-任务卡点也按需取三维：发生 = 事情办不下去；感知 = 主角看到、摸到或听到卡住的具体证据；反应 = 当场判断、选择或下一步反击。不要把流程单独写成说明段，也不要在场景末尾补动作尾巴解释意义。
-
-反模式（绝对禁止）：把三维度拆成三段依次写完，同一件事掰开写三遍。
-
-- 正确（揉进式，《闻笙有两意》原文）：我以为陆池是真心跟我道歉，但摸到那碗凉掉的排骨汤时，我的心更冰冷了。上面还浮着凝固的油，根本喝不了。（摸汤、凝固的油、心冰冷揉在一段里）
-- 错误（把上面这段拆成三段堆叠）：我摸到那碗排骨汤。／ 汤是凉的，浮着凝固的油。／ 我的心更冰冷了。（同一件事掰成三句，读者看三遍）
-
-**画面分段**：揉进不等于一段到底。按新动作 / 新物件 / 新信息 / 新对话 / 视线转移断段，不按维度断段。一段承载一个镜头拍点或一条连续推理 / 氛围 / 情绪链。
-
----
-
-## 11. 疏密分配 + 动静起伏
-
-**疏密**：不要每个 beat 一样长一样细（平均用力是 AI 腔的根）。
-
-| beat 类型 | 笔墨 |
-|---|---|
-| 爽点 / 打脸 / 反转 / 情绪高潮 | 密（详写，感知动作对话铺满，慢镜头逐拍） |
-| 过场 / 赶路 / 信息交代 / 时间跳转 | 疏（1-2 句带过，不展开三维度） |
-| 铺垫 / 日常 / 关系升温 | 中（挑一两个有代入感的细节写实，其余略） |
-
-**动静有起伏**：整篇要有推进与停顿，但不要求动作冲击后固定接一段安静感知。停顿可以是信息悬置、对话空白、等待或环境压力，不用微动作填格。避免长时间全动造成疲劳，也避免长时间全静造成拖沓。
-
-**主语节奏**：段首 / 场景切换 / 多人同场用主角名建立主语；同一动作链内用代词 / 省略流动；关键转折再点名。避免连续多句都以同一主角名开头。
-
----
-
-## 12. 开头事件密度
+## 10. 开头事件密度
 
 前 100 字 ≥ 3 个事件。删掉所有背景介绍（「她是 XX 的女孩」「在古代 XX 年间」），第 1 句就是事件 / 对话 / 信息炸弹，不是描述。
 

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

@@ -108,7 +108,7 @@
 
 ```bash
 for PYBIN in python3 python py; do "$PYBIN" -c "" 2>/dev/null && break; done
-"$PYBIN" -c "from pathlib import Path; print(len(Path('正文.md').read_text(encoding='utf-8')))"
+"$PYBIN" -c "from pathlib import Path; print(len(''.join(Path('正文.md').read_text(encoding='utf-8').split())))"
 ```
 
 各节分布（按小节标记切开，逐节报非空白字符数）：
@@ -178,12 +178,12 @@ for name, body in out:
 
 | 平台 | 章节标记 | 对话格式 | 段落底色 | 特殊要求 |
 |------|----------|----------|----------|----------|
-| 知乎盐言 | `1.`（纯数字） | `「」` | 短段 + 叙述交织 | 导语需单独标注 |
+| 知乎盐言 | `1.`（纯数字） | `「」` | 短段 + 叙述交织 | 导语即正文开头几段，不另标 |
 | 番茄 | `###第N章` | `""` | 短段为底色，允许叙述交织对话 | 首段需有吸引力 |
 | 红果 | `###1.` | `""` | 短段为底色 | 无 |
 | 黑岩 | `###1.` | `""` | 一句一段，多换行留白 | 节尾按职责承接，不另造悬钩 |
 
-用户未指定平台时，默认短篇通用格式：`###1.` + `""` + 番茄系短段底色。
+`设定.md`「平台基调」已记小节标记与引号时以它为准；都没定用短篇通用格式：`###1.` + `""` + 番茄系短段底色。
 
 ---
 

package/lib/oh-story/skills/story-short-write/references/short-prose-quality.md

@@ -71,6 +71,7 @@
 ### 五维评分标准
 
 每个维度 0-100 分，根据评分结果选择精修策略。
+严重度：critical、high＝必须修；medium＝建议看；low＝仅提示。
 
 ### 维度 1：核心一致度
 检查：关键冲突、关键行动、人物动机是否前后一致。
@@ -98,7 +99,7 @@
 | 问题 | 严重度 | 修复 |
 |------|--------|------|
 | 机械按字数切段或主语过密 | medium | 按戏剧单元重排段落，段首点名、段中代词/省略、关键转折再点名 |
-| 章节字数偏离目标 | **high** | 写作/大纲修复时先回到细纲补足计划内情节点，再展开；去AI味已有正文时不得新增剧情 |
+| 整篇字数不在锁定范围 | **high** | 先核对批准情节点是否写完整，缺了才补回原计划内容，不为凑字新增冲突、对话或独立事件；超字删不推动剧情的内容；去AI味已有正文时不得新增剧情 |
 | 格式混乱（对话/描写不统一）| low | 统一格式 |
 
 ### 维度 4：可读性

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

@@ -279,7 +279,7 @@
 - [ ] 反转让读者想翻回开头重看
 
 ### 公平性
-- [ ] 读者有可能在反转前猜到（不是必须，但有可能）
+- [ ] 细心读者回看能推出真相，但正读时猜不到
 - [ ] 没有对读者撒谎——只是没说出全部真相
 - [ ] 揭示方式自然，不靠角色大段独白解释
 

package/lib/oh-story/skills/story-short-write/references/style-resolution.md

@@ -12,10 +12,10 @@
 
 ## 加载与传递
 
-1. 从本次正文路径确定书目录（长篇为 `正文/` 的父目录，短篇为 `正文.md` 所在目录）。读该书 `设定/文风.md`；短篇同时读 `设定.md` 的文风约定。无文件就继续，不创建占位文件、不猜其他书。文风无最低字数限制，一句可执行的偏好也有效；空白、纯标题、待补充不算。
-2. `_文风摘要.md` 只能辅助定位，不能独立替代全文。当前会话已读全文时无需反复读；摘要与全文不一致用全文，不让旧摘要压过作者的新修改。
-3. 作者记忆 query 显式传当前书名、已知题材和流程以及需要的 kind，避免只取到 global。只用 active；同一维度窄范围覆盖宽范围，不拼成同时满足的清单。无法判定的同范围冲突才问作者，已能按优先级解决的不询问。
-4. 在现有 prompt 填 `style_resolution`：本次生效的表达要求及来源、被覆盖的默认条款、必须保留的事实/信息边界；只列与任务有关的冲突，无冲突可写“按本书文风”。原样传给正文、去味和文字 reviewer，并传文风全文路径。同一批次复用，当前请求或文风变动时更新。单独调用去味/审稿也执行本步骤，不能靠上一次会话的记忆。
+1. 从本次正文路径确定书目录（长篇为 `正文/` 的父目录，短篇为 `正文.md` 所在目录）。读该书 `设定/文风.md`；短篇同时读 `设定.md` 的文风约定。无文件就继续，不建占位文件、不猜其他书。文风无最低字数限制，一句可执行的偏好也有效；空白、纯标题、待补充不算。
+2. `_文风摘要.md` 只辅助定位，不替代全文。当前会话已读全文时无需反复读；摘要与全文不一致用全文，不让旧摘要压过作者的新修改。
+3. 有作者记忆时 query，显式传当前书名、已知题材和流程以及需要的 kind，避免只取到 global；没有就跳过。只用 active；同一维度窄范围覆盖宽范围，不拼成同时满足的清单。无法判定的同范围冲突才问作者，已能按优先级解决的不询问。
+4. 在现有 prompt 填 `style_resolution`：本次生效的表达要求及来源、被覆盖的默认条款、必须保留的事实/信息边界；只列与任务有关的冲突，无冲突可写“按本书文风”。原样传给正文、去味和文字 reviewer，并传文风全文路径。同批复用，当前请求或文风变动时更新。单独调用去味/审稿也执行本步骤，不靠上次会话的记忆。
 
 ## 检测器如何服从裁决
 

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

@@ -13,7 +13,7 @@
 | 番茄短篇 | 流畅第一/第三人称，目标清晰、金手指直白 | 顺滑无毒点，反派挑衅一两节内转成主角升级/发财的垫脚石 | 开新地图 / 拿到新底牌 / 新人物带资源登场 | 圆满畅快，事业感情双收，坏人受罚 |
 
 - 小程序收稿量最大，打脸爽文是主力盘；同一个脑洞可以分别按知乎/小程序/番茄各跑一版，挑最顺的投。
-- 基调只调"声音和落点"，不覆盖题材招式和本篇情绪目标。基调是投放渠道的声音，与 `short-format.md` 的排版模板是两个轴——小程序基调的稿，排版仍按 short-format 选一套 app 模板。
+- 基调只调"声音和落点"，不覆盖题材招式和本篇目标情绪。基调是投放渠道的声音，与 `short-format.md` 的排版模板是两个轴——小程序基调的稿，排版仍按 short-format 选一套 app 模板。
 - **调基调不松去 AI 底线**：强情绪靠具体动作和对白落地，别把话硬拆成三字碎句成片排列；前情背景靠场景带出，别整段插叙成"来龙去脉"说明书；对仗句式（"上辈子…这辈子…"）别高频复用。去 AI 味仍按本套件既有规则。
 
 ## 二、导语（投稿门面，单独打磨）

package/lib/oh-story/skills/story-short-write/references/villain-and-reveal.md

@@ -14,10 +14,10 @@
 
 ### 人设模板
 
-填写以下模板，写入设定.md：
+填写以下模板，写进 设定.md「Phase 2 设计校验」块，替换“反派设计：不适用”那一行（一字段一行）：
 
 ```
-反派：
+反派设计：
 - 身份：{与主角的关系}
 - 动机：{自洽的作恶逻辑：贪婪/嫉妒/控制欲/报复/自保}
 - 作恶方式：{具体手段：言语打压/经济控制/社交孤立/人身伤害/法律构陷}
@@ -146,13 +146,8 @@
 
 ## 4. 反转有效性自检（Phase 2 使用）
 
-写完 outline 后，用这个自检确认反转真的能反转读者：
-
-| 检查项 | 通过标准 | 不通过 = 需要 |
-|--------|---------|-------------|
-| 读者知道真相的时机 | >60% 合理；50-60% 灰区需审视反转力度；<50% 不算反转（三档口径详见 writing-workflow.md「反转信息差验证」） | 调整线索释放节奏，延后真相揭露 |
-| 是否有误导假线索 | ≥ 1 条读者会信的假线索 | 加入红鲱鱼或选择性叙述误导 |
-| 真相线索隐蔽度 | 回看能找到但正读时会忽略 | 线索藏在日常细节中，不用强调语气 |
-| 角色知道 vs 读者知道 | 反转前读者和角色至少有一方不知道真相 | 制造信息差：读者不知道 / 角色不知道 / 双方都不知道 |
+写完 outline 后按 writing-workflow.md「反转信息差验证」逐项过：揭示时机按功能定（误判先参与至少一次重要决定），百分比只记录、不当阈值。本文件只补两条：
+- 反转前读者和角色至少有一方不知道真相；没有就制造信息差（读者不知道 / 角色不知道 / 双方都不知道）。
+- 假线索用红鲱鱼或选择性叙述；真相线索藏在日常细节里，回看能找到、正读会忽略，不用强调语气。
 
 **失败模式**：「延迟揭露」不算反转。读者在第 2 节就知道真相，后面 10 节只等角色追上来 = 延迟揭露，读者会无聊。真正的反转发生在揭示那一刻，让读者和角色一起震惊。

package/lib/oh-story/skills/story-short-write/references/workflow-design.md

@@ -2,7 +2,7 @@
 
 #### Agent 调用：story-architect
 
-构思阶段，如果项目已部署 story-architect agent（查找顺序见 [SKILL.md](../SKILL.md)），可 spawn `Agent(subagent_type: "story-architect", prompt: "项目目录：{dir}\n任务类型：短篇构思\n查询参数：{情绪目标+题材方向}")` 辅助框架设计。如 agent 不可用，由主线程直接执行。
+已部署 story-architect 时可 spawn `Agent(subagent_type: "story-architect", prompt: "项目目录：{dir}\n任务类型：短篇构思\n查询参数：{目标情绪+题材方向}")` 辅助框架设计；不可用由主会话直接执行。
 
 帮用户确定短篇的核心框架：
 
@@ -13,7 +13,8 @@
 - 标题（暂定）：{}
 - 目标字数：{} 字（短篇通常 8000-20000 字）
 - 目标平台：{知乎盐选 / 小程序 / 番茄短篇}（三选一）
-- 情绪目标：{读者读完的感受}
+- 平台基调：{按 submission-craft.md 平台表记下视角、矛盾烈度、章末钩子、结局质感；小节标记与引号按 short-craft.md 第 4 节}
+- 目标情绪：{读者读完的感受}
 
 ### 一句话梗概
 {主角 + 困境 + 反转 + 情绪落点}
@@ -31,9 +32,15 @@
 - 反转高潮不要骤降：反转前 1 节开始升温，反转节达到峰值，反转后 1 节维持峰值不骤降
 
 ### 人设速写
-- 主角：{一句话人设}
-- 关键角色：{一句话人设}
+- {角色}：{一句话人设}；声线：{}；口头禅：{}；禁忌：{}（每人一行）
 - 关系：{他们之间的关系}
+
+### 题材招式
+- {招式名}：{本篇怎么用、落在哪几节}（2-3 条，与校验区核心招式一致）
+- 冷门题材另记：{所用公式、情绪节拍、必选场景、规则要点}
+
+### 作者已定
+- {作者在对话里定下的人称、偏好、红线，一条一行；否掉的方案也记一行，写明为什么不要}
 ```
 
 框架确定后，完成设计任务，然后在工作目录下创建文件。
@@ -42,10 +49,10 @@
 
 详细步骤和模板见 `references/writing-workflow.md`。构思时从目标情绪反推剧情，不是从灵感正向构建。按顺序完成：
 
-1. 定平台基调 + 加载题材风格包 → 先读 `references/submission-craft.md` 定投稿平台（知乎/小程序/番茄），正文视角、矛盾烈度、章末落点随之切换；再读 `references/genre-styles/{题材}.md`（核心 10 题材）+ 通用底座 `references/short-craft.md`，从招式库选 2-3 个核心招式（如追妻的白月光触发链 / 信物翻转 / 火葬场预告），写入 设定.md「题材招式」区，全程照此招式与腔调写
+1. 定平台基调 + 加载题材风格包 → 先读 `references/submission-craft.md` 定投稿平台（知乎/小程序/番茄），正文视角、矛盾烈度、章末落点随之切换；再读 `references/genre-styles/{题材}.md`（核心 10 题材）+ 通用底座 `references/short-craft.md`，从招式库选 2-3 个核心招式（如追妻的白月光触发链 / 信物翻转 / 火葬场预告），写入 设定.md「题材招式」区，全程照此招式与腔调写；冷门题材把所用公式要点按模板一并写进该区，写正文与精修不再重读公式全文
 2. 设计反派（如有）→ 加载 `villain-and-reveal.md`
 3. 确定揭露方式 → 同上
-4. 编写 小节大纲.md（格式见 writing-workflow.md）：短篇只做轻量蓝图，每节包含结构段/五段功能、人物/关系或其他状态变化、因果/逻辑链、结尾承接/钩子，不套长篇完整章节蓝图。**标出付费点卡在哪一节末**（见 `submission-craft.md`「付费点」：用未完成动作、身份/证据变化或两难选择形成真实断点）；用反推法先想透付费点那一节，再倒排前后。每节可选一个任务卡点，但必须服务情绪升级、证据推进、关系撕裂、反转铺垫或反击动作；没有就不强补
+4. 编写 小节大纲.md（12 列表格见 writing-workflow.md，只做轻量蓝图）。**标出付费点卡在哪一节末**（见 `submission-craft.md`「付费点」：用未完成动作、身份/证据变化或两难选择形成真实断点）；用反推法先想透付费点那一节，再倒排前后。每节可选一个任务卡点，但必须服务情绪升级、证据推进、关系撕裂、反转铺垫或反击动作；没有就不强补
 5. 反转信息差验证（公式见 writing-workflow.md）
 6. 伏笔回查清单（标准见 writing-workflow.md）
 
@@ -61,7 +68,11 @@
 - 付费点：第 {N} 节末
 ```
 
-有反派时用 `villain-and-reveal.md` 的身份、动机、作恶方式、致命弱点、报应五字段替换“不适用”。`short-reversal.md` 判断确属无反转题材时，写 `反转类型：无反转` 和 `反转位置：不适用（{报应兑现/甜度递进等原因}）`，不要硬编节号。`小节大纲.md` 必须使用 `writing-workflow.md` 规定的固定 12 列 Markdown 表格，并在对应节末明确标出“付费点”。
+有反派时按 `villain-and-reveal.md` 人设模板，在本块内把“不适用”换成身份、动机、作恶方式、致命弱点、报应五行（一字段一行）。`short-reversal.md` 判断确属无反转题材时，写 `反转类型：无反转` 和 `反转位置：不适用（{报应兑现/甜度递进等原因}）`，不要硬编节号。付费点写进 `小节大纲.md` 对应节的“结尾承接/钩子”单元格。
+
+#### Agent 调用：character-designer
+
+设计任务完成后、跑完成门禁前，已部署 character-designer 时可 spawn `Agent(subagent_type: "character-designer", prompt: "项目目录：{dir}\n任务类型：角色设定\n查询参数：{人设速写+关系}")` 辅助角色设定和语言风格档案；不可用由主会话直接执行。结果压成每人一行（声线、口头禅、禁忌）写进 设定.md「人设速写」，写正文只读这里。
 
 #### Phase 2 完成门禁
 
@@ -69,9 +80,6 @@
 
 - exit 0：Phase 2 机械契约通过，才可进入下一阶段；这不替代故事质量判断
 - exit 1：只把 `repair_scope` 中的检查 ID、证据、期望、reference 路径和修复范围交给本轮 writer；只改失败字段，再运行同一命令
-- 最多做 2 轮定向 repair；仍失败则停止并报告剩余检查 ID，不得声称 Phase 2 已完成
-- exit 2、脚本缺失或不可执行：报告 verifier 不可用，不得用泛化“自检”替代后继续
-
-#### Agent 调用：character-designer
-
-设计任务完成后，如果项目已部署 character-designer agent（查找顺序见 [SKILL.md](../SKILL.md)），可 spawn `Agent(subagent_type: "character-designer", prompt: "项目目录：{dir}\n任务类型：角色设定\n查询参数：{人设速写+关系}")` 辅助角色设定和语言风格档案。如 agent 不可用，由主线程直接执行。
+- 最多做 2 轮定向 repair；仍失败则停止，用中文告诉作者设计还缺什么，不得声称 Phase 2 已完成
+- exit 2、脚本缺失或不可执行：告诉作者自动检查没跑成，不得用泛化“自检”替代后继续
+- 向作者汇报构思只讲故事（梗概、反转、付费点在第几节）和待拍板的问题（附推荐默认），不提脚本、检查 ID、字段或表格列数；作者拍板的改动先写回两份文件并重跑本门禁，汇报末尾按 SKILL.md「写前必读」建议新开对话写正文

package/lib/oh-story/skills/story-short-write/references/workflow-draft.md

@@ -0,0 +1,116 @@
+# Phase 3：短篇逐场景写作
+
+本文件中的 `scripts/` 与 `references/` 路径均相对本 skill 根目录。
+
+**格式规范（最高优先级）**：正文只存 `正文.md`，主会话与写手同一套格式：段间只允许一个换行符、不留空行，小节标记与引号全篇统一，按 `设定.md`「平台基调」，没写才查 `short-format.md` 平台覆盖表；子代理输出不一致时按此重排。
+
+**构思收口先验**：写前先跑 `node {skill 根}/scripts/check-phase2-contract.js --json {短篇目录}`；不是 exit 0 就告诉作者构思还没收口、请回到构思补完，不自己重读构思方法论补写。
+
+**本时刻只靠落盘文件接上构思**：`设定.md`（核心框架、作者已定、平台基调、题材招式、反转铺垫、贯穿道具、反派与揭露方式、对标摘要）与 `小节大纲.md` 为 Phase 2 产出，`正文.md` 为本阶段产出。反转、反派、揭露、付费点与平台基调以两份设计文件为准，不重读构思方法论（workflow-design、writing-workflow、short-reversal、submission-craft、villain-and-reveal、冷门题材公式全文）；作者在对话里改过、设计文件还没写的，先写回 `设定.md` 再动笔。
+
+**导入项目续写基线**：`设定.md` 存在「本书续写基线」时先读取，作为已写内容的内部连续性与既有写法约束；它不是对标摘要，不参与主/副对标排序，也不复制到 `对标/`。
+
+> 术语说明：Phase 3 按「段」划分叙事结构（开头段/铺垫段/升级段/反转段/结尾段），每段包含若干「小节」（数字编号的 beat）。「场景」指写作时的具体画面。
+
+**写前加载**：`short-format.md`（正文格式）、`short-craft.md`（通用底座）、[scene-craft.md](scene-craft.md)（场景写法）、`设定.md` 题材参考里的那一个 `genre-styles/{题材}.md`（冷门题材不读公式，按「题材招式」区记下的要点写，腔调按 `short-craft.md`）；写羁绊铺设或余韵收尾时按需读 `emotional-methods.md` 对应一斧。`short-deslop.md` 到 Phase 4 去味时再读，写作中的 AI 腔由完成门槛的检测器兜底。
+
+**交付参数先锁定**：用户明确的字数范围优先，逐字取其最小值/最大值与节数；只给单一目标时用目标的 95%-105%；都未给时用 8000-20000 字和大纲节数。后文的默认字数不得覆盖用户范围。
+
+**写前参数验收（锁定后、写 `正文.md` 前必跑）**：`node {skill 根}/scripts/check-delivery-contract.js --json --check-contract --min-chars {MIN} --max-chars {MAX} --sections {N} [--min-section-chars {用户逐节下限}] {短篇目录}`。exit 0 只说明参数能同时满足，不算交付；exit 2 即冲突，停在写前，用中文告诉用户字数范围与节数哪里对不上，请其选择调整项，不代改用户约束。
+
+**写前准备**（每个场景写前执行 2 步，是核心方法的落地：确认目标情绪 → 召回技法模块）：
+- **步骤 1：记忆+召回**：① 本场景目标情绪词？② 借鉴哪个参考文件的哪个技法？③ 具体用在哪个段落？答不出 → 先回读本时刻已加载的参考再动笔。有对标时从 `设定.md`「对标摘要」召回 1-2 个与本场景相关的技法，要细看再查主对标 `对标/{书}/写作手法.md`（没有就用 `拆文库/{书}/`）的对应条目，写入“拆文召回摘要”
+  - **多对标书时**：副对标只用「对标摘要」里构思时已登记的条目（正文阶段不新增召回），作为“副对标召回摘要”；正文只传摘要，不传副书文风或原文
+- **步骤 2：指令确认**：用一句话概括本场景写作意图（情绪+技法+适配段落），并确认本场景是否有任务卡点、它卡出哪种情绪变化或新证据；没有就不强补。确认后开始写作
+
+**写作指令**：写法按 `short-craft.md`（情绪直写与上下文支撑第 2 节、在场叙述第 3 节）与 `scene-craft.md`（三维度揉进与画面分段、疏密与主语节奏），段落与标点按 `short-format.md`，不照搬大纲腔。情绪烈度按 `设定.md` 与题材包的腔调，没写时默认宁烈不温（冲突前置、爽点具体、台词带刺）；任务卡点必须直接加重羞辱、误会、背叛、证据、反击或心死节点，删掉无损就压缩。
+
+#### 分批写与子代理
+
+正文写作阶段默认由主会话按 2-3 节/批分批写正文；主会话输出是短篇正文的标准形态，不要求单次 agent spawn 完成 8000+ 字全文。
+
+- 每批写完后更新短篇目录下 `.story/work/已写小节摘要.md`（3-5 条：已揭示信息、情绪位置、未回收伏笔、下一批衔接句），换对话靠它接上，交付后可删。
+- 下一批先读该摘要和 `正文.md` 尾部 300-500 字再续写。
+- 只有用户明确要求子代理、主会话上下文不足，或需要隔离试写时，才检查 narrative-writer agent（查找顺序见顶部），可用时按 [agent-calls.md](agent-calls.md)「写正文」派出。
+- 无论谁写，写入 `正文.md` 前都按同一格式规范重排，保证主会话与子代理输出一致。
+
+⚠️ **硬约束只作用于整篇交付范围，不设统一逐节最低字数或行数**。
+写完每批后去掉 `--check-contract` 重跑上面命令，取其非空白字符数作整篇累计值（未写完 exit 1 属正常），各节分布按 `short-format.md`「字数统计」；不自写 Python 计数。某节明显短于相邻节时，先核对批准情节点、可见动作和后果是否已经完整；完整就保留，缺失才补回原计划内容。不得为拉齐节长新增冲突、对话、回忆、配角反应或独立事件。整篇以锁定的用户交付范围为准；未给范围时才使用 8000-20000 字默认值。
+**⚠️ 未进入锁定范围 = 正文未完成。禁止越界后结束；不足只扩已有情节点，超出只压重复解释，不借 repair 新增或删除关键剧情。**
+
+**节数守恒**：正文节数必须等于小节大纲规划节数。不得合并多节为一节。如果写作中发现某节不需要独立存在，应回到大纲阶段调整，而非在写作时偷减。
+
+按以下结构分段写（占比仅参考，以小节大纲为准）：
+
+#### 第一段：开头（前 300-500 字）
+
+**目标**：3 句话内抓住读者。**必须包含一个开篇钩子**（从下表或题材包「开篇范式」选类型）。
+
+**先写导语**：正文开头先写一条 150-220 字导语（投稿门面，编辑第一眼看它）——四维骨架（起因+核心冲突+人设底色+情绪反转）配黄金三角（具体物件+信息差+留白钩子），一句一段（黑岩/盐言导语形态；番茄导语按 short-format.md 短段叙织）——完整句各自独立成段，不是拆成三字碎句。它就是正文开头的头几段，写好顺势往下接、不重写，所以首句同样守下面的开头零环境和前 100 字事件密度≥3（首句是事件/动作/信息炸弹，不是背景或弧线概括），剧透钩子放导语后半；不平铺背景或抒情，底牌不全亮（留给正文兑现），不只写惨不写后手。
+
+**开头零环境规则**（默认适用；悬疑、惊悚、灾难、强氛围题材可例外）：
+- 前 3 句禁止出现无事件承载的环境描写（灯光、天气、气味、温度、装修）
+- 前 3 句必须是：事件 / 对话 / 动作 / 信息炸弹，四种之一
+- 任务卡点可以作为动作/事件钩子，但必须立刻带出赌注或矛盾，不能先写流程再解释意义
+- 环境细节只能揉进角色的动作和感知中自然带出，不能独立成句；例外题材中，环境也必须携带威胁、异常或信息差
+- 检查方法：标出前 3 句的主语，如果主语是环境物件（灯光/走廊/房间/天气），重写
+
+开头技巧：
+
+| 技巧 | 说明 | 示例 |
+|------|------|------|
+| 冲突前置 | 第一句就是矛盾 | 「离婚协议放在桌上，他已经签了。」 |
+| 信息差钩 | 给读者一个角色不知道的信息 | 「她不知道，对面那个男人已经在计划第三次了。」 |
+| 反常行为 | 用一个不合常理的行为引起好奇 | 「她把订婚戒指冲进了马桶。」 |
+| 重生反常 | 重生后做前世绝不会做的事 | 「沈栀心念成灰，支着一口气找到了媒婆:郭家的那个天阉，我来嫁。」 |
+| 超自然身份 | 开篇揭示非人类身份 | 「我是世上仅存的红衣厉鬼。我不知自己是怎么死的。」 |
+| 灵魂旁观 | 以灵魂视角描述死亡现场 | 「我的尸体躺在透明棺材里，三个哥哥在外面笑着说：她演得真像。」 |
+| 悬念句 | 抛出一个需要解释的事实 | 「我死后的第三天，老公发了一条朋友圈。」 |
+| 替嫁被弃 | 被迫接受不公正的命运 | 「三个月后，我代替皇后的嫡亲公主坐上了去漠北和亲的轿撵。」 |
+| 代入式提问 | 直接让读者产生共鸣 | 「你有没有在深夜接到过一个不该接的电话？」 |
+
+#### 第二段：铺垫（占全文 30-40%）
+
+- 用物件/数字/习惯建立羁绊（详见 emotional-methods.md「羁绊铺设」）
+- 埋入至少 3 个反转线索，分散在不同小节
+- 在会改变读者预期、行动方向或关系判断的位置埋钩；连续多个小节只有提问没有局部兑现时再调整，不按固定节数填格（按小节大纲「结尾承接/钩子」列落地）
+- 小节用数字分割，每小节推进一个情节点
+- 情绪强度逐节递增，不允许连续 2 节无情绪变化
+- **贯穿道具（设定.md 有才写）第 1 次出现必须在此段完成**
+- **反派作恶按阶梯递增**（小恶→中恶，按 `设定.md` 反派设计）
+
+#### 第三段：升级（占全文 20-30%）
+
+- 冲突必须比上一段升级（强度/范围/代价至少一个维度上升）
+- 插入倒计时钩子或代价钩子制造紧迫感
+- 随风险和选择升级提高牵引强度；用新证据、代价、误判修正或局部反击推动，不按固定节数另塞钩子（按题材包）
+- 埋入误导信息，让读者猜错反转方向
+- **数字/金额递增作为叙事工具**（具体数字替代模糊描述，见各 genre-styles 招式库「数字承重」）
+- **场景引擎有变化**：行动、对话、证据、任务、等待、空间压力与关系选择按因果需要切换；不为动静交替补无功能小动作
+
+#### 第四段：反转（占全文 10-15%）
+
+- 反转在一节内完成揭示，不拖延
+- 揭示后确保前面铺垫的线索可被回溯（读者能找到「原来如此」的伏笔）
+- 反转节的情绪冲击强度必须 > 前面所有节的最高值
+- **按 `设定.md` 选定的揭露方式揭露真相**（证物/证人/偷听/剥洋葱）
+- **贯穿道具第 2 次出现必须在此段完成**（意义被颠覆）
+
+#### 第五段：结尾（占全文 5-10%）
+
+- 章末必须有钩子（悬念或余韵）
+- 用安静细节收尾（一个物件、一个动作、一句短话），不写大段抒情
+- 结尾方式见下表，参考 emotional-methods.md「余韵钝痛」
+- **贯穿道具第 3 次出现（回扣暴击）**
+
+结尾类型：
+
+| 类型 | 效果 | 适合情绪 |
+|------|------|----------|
+| 余韵式 | 不说完，让读者自己想 | 意难平 |
+| 呼应式 | 首尾呼应，形成闭环 | 治愈、成长 |
+| 开放式 | 留下悬念 | 细思极恐 |
+| 反转再反转 | 结尾再来一个小反转 | 震惊 |
+| 金句式 | 一句话点题 | 共鸣 |
+
+写作中及进入精修前，执行 [SKILL.md](../SKILL.md) Phase 3 的「小节完整性流程」与「完成门槛」。

package/lib/oh-story/skills/story-short-write/references/workflow-revision.md

@@ -0,0 +1,99 @@
+# Phase 4：短篇精修打磨
+
+本文件中的 `scripts/` 与 `references/` 路径均相对本 skill 根目录。精修必读本文件与 `short-format.md`（格式快速检查、字数口径）；新对话里精修也先读它。
+
+Phase 3 写手只做内容覆盖与格式自检（该分工随写作 prompt 传入）。Phase 4 去味由一个执行者（下方 narrative-writer 或主会话）按 `references/short-deslop.md` 自检清单完成；一致性检查职责不变。S1/S2 与 blocking 必须修，S3 与 advisory 建议看，S4 仅提示。最终扫描与交付验收由主会话对落盘文件执行，修改后只复核改动、重跑受影响检查，不另开整轮去味。
+
+按文末「精修清单」完成检查。文件模式依次运行 `node scripts/check-ai-patterns.js --check --fail-on=blocking 正文.md`、`node scripts/check-outline-copy.js --outline 小节大纲.md 正文.md`、`node scripts/normalize-punctuation.js 正文.md`、`node scripts/check-degeneration.js --check 正文.md`，blocking 先改正文再复扫。照搬检测报出的誓词、关键原话等功能性台词保留，登记进 `小节大纲.md` 末尾「复沓锚句」再复检，其余现场重写。
+
+全部落盘后运行 `node scripts/check-delivery-contract.js --json --min-chars {MIN} --max-chars {MAX} --sections {N} {短篇目录}`。exit 0 才可交付；exit 1 只按 `repair_scope` 最小修复并重跑受影响的质量检查与本命令，最多 2 轮；仍失败则停止，按下方交付说明告诉作者哪项没达标、差多少。exit 2、脚本缺失或不可执行时不得声称交付契约通过。它只验字数、节数与排版。
+
+#### Agent 调用：narrative-writer（去AI味）+ consistency-checker
+
+已部署对应 agent 时可派出：narrative-writer 去味的 prompt 见 [agent-calls.md](agent-calls.md)「精修去味」；一致性检查派 `Agent(subagent_type: "consistency-checker", prompt: "项目目录：{dir}\n检查范围：{正文文件}\n检查类型：事实冲突+伏笔断线+角色属性不一致")`。agent 不可用时主会话直接执行。
+
+**正文洁净规则**：自检（字数、禁用词、格式）结果只在对话里说明，不落盘成文件，**绝对不能**附到正文末尾，正文不得出现 `<!-- 自检 -->` 等检查标记。
+
+**交付说明（给作者看）**：只用大白话，按三块写：
+1. 写了什么：标题、一句话核心钩子或反转、总字数、几节。
+2. 要作者拍板的事：每件写成一句问题并附推荐默认（如「结尾要不要再留个小反转？默认不留」）；没有就省略。
+3. 下一步可选：精修某段、去 AI 味、换平台改写等。
+
+自查结果只写一句（如「自查过字数、分节和常见 AI 腔，都过了」；没过就说哪项差多少）。不写脚本名、检查 ID、字段名、参数或大纲表格格式；助手降级、版本提示等执行细节只放最后一行「技术备注：」。
+
+## 精修清单与常见问题
+
+### 精修检查清单
+
+```
+## 精修清单
+
+### 开头
+- [ ] 前 3 句话能抓住人？
+- [ ] 没有无意义的背景介绍？
+- [ ] 包含一个开篇钩子？
+
+### 情绪
+- [ ] 情绪曲线是否有明确走向？
+- [ ] 反转前的情绪铺垫够不够？
+- [ ] 反转后的冲击够不够？
+
+### 反转
+- [ ] 反转是否出乎意料？
+- [ ] 反转是否合情合理（回看有铺垫）？
+- [ ] 反转时机是否合适？
+
+### 节奏
+- [ ] 有没有拖沓的部分？
+- [ ] 每句话是否都有存在价值？
+- [ ] 字数是否在目标范围内？
+
+### 格式
+- [ ] 按 short-format.md 文末「写完每段快速检查」逐项过；另查有无连续超长大段
+
+### 钩子
+- [ ] 钩子是否出现在读者预期、行动方向或关系判断发生变化的位置；有没有连续提问却不局部兑现？
+- [ ] 章末是否有未完成动作、新信息、局部兑现、关系变化、余韵或明确下一步之一？
+
+### AI 腔
+- [ ] 无禁止比喻：「命运的齿轮」「如潮水般」「仿佛春风」「心猛地一沉」「眼眶泛红」
+- [ ] 重复的身体/情绪描写按功能取舍：无新增信息就删，不换部位或同义动作凑数
+- [ ] 「像/好像/仿佛/如同」不成片堆叠；超过 10 处或检测器报比喻密度时逐处复核功能，有功能的留，不设硬上限、不机械全删
+- [ ] 完整 AI 腔黑名单见 short-deslop.md
+
+### 技法
+- [ ] 情绪落地：按 `short-craft.md` 第 2 节检查上下文支撑，保留准确直写，清理空泛与重复说明
+- [ ] 信物（若用）：意义翻转是否完整？（查设定.md追踪表，改了出现位置同步改表）
+- [ ] 场景引擎：每节是否通过行动、证据、任务、对话、物件、等待或关系选择改变了至少一项状态？
+- [ ] 开头密度：前 100 字事件 ≥ 3？
+
+### 结尾
+- [ ] 结尾是否有余韵？
+- [ ] 读者会不会想转发？
+```
+
+### 标点确定性收尾
+
+精修后对 `正文.md` 先运行 `node scripts/check-ai-patterns.js --check --fail-on=blocking 正文.md`。blocking 先改正文并复扫；advisory 只作读感提示，确属问题才改，功能性写法标 `[需复核]`。
+再运行 `node scripts/normalize-punctuation.js 正文.md`（默认 `--quote-mode keep`）清理无功能省略号、破折号、双连字符和独立分隔线；盐言「」不受影响。
+
+### 删减原则
+
+按 SKILL.md 执行规则 3 删掉不推动剧情、不铺垫反转、不推高情绪的对话、描写与心理活动；读者能猜到的缩短，重复表达的情绪合并。
+
+---
+
+## 常见问题与解决方案
+
+| 问题 | 原因 | 解决方案 |
+|------|------|----------|
+| 开头不抓人 | 在做背景铺垫 | 直接从冲突开始 |
+| 中间拖沓 | 信息密度太低 | 删减或合并场景 |
+| 反转没力度 | 铺垫不够或太明显 | 增加误导线索 |
+| 结尾无力 | 反转后还在补交代 | 篇幅按小节大纲；反转后只写兑现与余韵 |
+| 全篇平淡 | 情绪曲线太平 | 加大情绪落差 |
+| 感觉像流水账 | 缺乏情绪描写 | 加入人物内心感受 |
+
+### 冷门题材公式核对
+
+设定.md 的题材参考写的是 `genre-writing-formulas.md` 时，对照「题材招式」区记下的公式核对（不重读公式全文）：情绪节拍不跳不乱，必选场景都出现，规则都落实，没混用不相关公式。牵引与开头按上方清单。