@lemoncat7/dsh-partner 2.8.1 → 2.8.3

package/resources/skills/story-creation/upstream/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/resources/skills/story-creation/upstream/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` 时，对照「题材招式」区记下的公式核对（不重读公式全文）：情绪节拍不跳不乱，必选场景都出现，规则都落实，没混用不相关公式。牵引与开头按上方清单。

package/resources/skills/story-creation/upstream/skills/story-short-write/references/writing-workflow.md

@@ -0,0 +1,50 @@
+# writing-workflow.md：短篇写作工作流详解
+
+Phase 2 设计任务的步骤与验收；Phase 4 精修清单在 workflow-revision.md。
+
+---
+
+## Phase 2 设计任务（框架确定后执行）
+
+### 设计步骤
+
+1. **设计信物 / 贯穿物**（可选，1-2 个）：见题材包招式库「信物翻转」（如追妻火葬场的信物意义翻转）
+   - 填写：`- 第1次出现（第X节）：{场景}（{含义}）` 重复三次，含节号定位
+2. **设计反派**（如有）：用 villain-and-reveal.md 反派模板
+   - 填写：`{身份} + {动机} + {作恶方式} + {致命弱点} + {报应}`
+3. **确定揭露方式**：从 villain-and-reveal.md 4 种真相揭露机制中选一种，写进 设定.md 反派设计区
+4. **编写 小节大纲.md**：使用固定 12 列 Markdown 表格，每节 1 行，表头如下（列名和顺序不可改）：
+
+   `| 结构段/五段功能 | 主事件 | 情节推进 | 情绪 | 人物/关系变化 | 因果/逻辑链 | 读者新获知什么 | 结尾承接/钩子 | 伏笔/物件 | 场景形态 | 对白作用 | 目标字数 |`
+
+   下一行写 Markdown 分隔行，再逐节填写数据行。
+   - `结构段/五段功能` 使用开头/铺垫/升级/反转/结尾（或起因/发展/转折/高潮/结尾），用于轻量对应长篇的内容概括，但不要套长篇完整章节蓝图
+   - `人物/关系变化` 写本节前后变化；没有人物或关系变化时，写 `无（本节改变：信息/风险/资源/决定/行动/读者理解中的具体一项）`，不为填表硬造关系波动
+   - `因果/逻辑链` 写 `原因 → 行动 → 结果 → 后果/新问题`，避免小节只是情绪堆叠
+   - `结尾承接/钩子` 写本节如何接下一节；最后一节写结尾落点
+   - `情节推进` 写本节一个或多个真实改变；不设数量下限，相关情节点允许由同一动作链或对话同时兑现，禁止为凑数量加入阻碍、配角反应、短回忆或意外
+   - 有先后关系的推进单元用 `->` 连接，每个单元包含具体情节点描述+功能标签：
+     `具体发生了什么{功能标签}` 如 `发现账单上多了一笔4800{发现}` / `把戒指冲进马桶{冲突}` / `他笑了{递进}`
+     功能标签：`对话` / `冲突` / `伏笔` / `回忆` / `发现` / `递进`
+     情节点描述要具体到"谁做了什么"，不能只写标签如`对话`或`冲突`
+   - `场景形态` 写主要推进引擎，如行动、对话权力、证据核验、手艺、等待、空间压力或关系回落；不要求动静交替
+   - `对白作用` 写对白实际改变的信息、策略、权力、关系或下一步行动；无对白时写明由哪种动作、证据、物件或任务推进，不设占比或话轮数量
+5. **反转信息差验证**（outline 写完后、写作前必须验证）：
+   - `short-reversal.md` 判为无反转 → 写明理由，改查报应因果或甜度期待是否经过铺垫并得到兑现；跳过以下揭示检查
+   - 记录：读者在第几节知道真相？用「揭穿节号 ÷ 全文总节数」计算位置百分比，供核对节次和篇幅分配；百分比本身不是通过阈值
+   - 揭示前：错误解释是否已影响至少一次重要决定？还没有 → 误判尚未参与剧情，应补行动后果或调整揭示位置
+   - 揭示后：是否留出新的行动、关系变化或代价结算？只剩口头解释 → 提前揭示或压缩说明
+   - 双层反转：第一层阶段答案后是否发生基于该答案的新行动？没有 → 两层只是连续口供，应拉开功能距离
+   - 检查：至少有 1 条读者被成功误导的假线索（不是读者猜到后等角色追上来）
+   - 检查：反转前是否铺垫了 ≥3 条指向真相的线索（线索要隐蔽，不是明示）
+   - 验证：找一个人（或自我模拟）只看 outline，能否在反转前猜到真相？猜到 = 失败；回看才推得出是公平，不算失败
+6. **伏笔回查清单**（outline 写完后、写作前检查）：
+   - 列出结尾所有关键元素（物件/信息/角色/关系变化）
+   - 每个结尾元素在前文有 ≥1 次铺垫？没有 = 天降，必须补铺垫
+   - 用了贯穿道具时，三次出现完整？（第 1 次出现在铺垫段，第 2 次出现在反转段，第 3 次出现在结尾段）
+   - 铺垫节号与揭穿节号的间距 ≥ 3 节（间距太短铺垫无效）
+
+### 设定.md 内容构成
+
+核心框架（含平台基调、人设速写）+ 作者已定 + 题材招式 + 反转铺垫（信息差验证与伏笔回查结果）+ 贯穿道具 + 反派设计与揭露方式 + 对标摘要；写正文只读它与小节大纲，所以构思里定下的都要写进来。贯穿道具追踪表：
+`| 物件 | 第1次出现(节号/含义) | 第2次出现(节号/含义) | 第3次出现(节号/含义) |`