@oh-story/dsh 0.1.9 → 0.1.10

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

@@ -0,0 +1,126 @@
+# Phase 3：短篇逐场景写作
+
+本文件中的 `scripts/` 与 `references/` 路径均相对本 skill 根目录。
+
+**项目文件结构**：文件结构见 Phase 2；设定.md/小节大纲.md 为 Phase 2 产出，正文.md 为 Phase 3 产出。
+
+**导入项目续写基线**：`设定.md` 存在「本书续写基线」时先读取，作为已写内容的内部连续性与既有写法约束；它不是对标摘要，不参与主/副对标排序，也不复制到 `对标/`。
+
+> 术语说明：Phase 3 按「段」划分叙事结构（开头段/铺垫段/升级段/反转段/结尾段），每段包含若干「小节」（数字编号的 beat）。「场景」指写作时的具体画面。
+
+**交付参数先锁定**：用户明确的字数范围优先，逐字取其最小值/最大值与节数；只给单一目标时用目标的 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：记忆+召回**：① 本场景目标情绪词？② 借鉴哪个参考文件的哪个技法？③ 具体用在哪个段落？答不出 → 先回读参考再动笔。如有 `对标/` 或 `拆文库/` 结构化产出，按 [references/benchmark-recall.md](benchmark-recall.md) 的对标上下文加载规则检索与当前场景最相关的结构/情绪/反转/写作手法模块作为参考，并写入“拆文召回摘要”
+  - **多对标书时**：参 `references/cross-book-recall.md`，副对标/参考对标按阶段预算进入"副对标召回摘要"；正文只传摘要，不传副书文风或原文
+- **步骤 2：指令确认**：用一句话概括本场景写作意图（情绪+技法+适配段落），并确认本场景是否有任务卡点、它卡出哪种情绪变化或新证据；没有就不强补。确认后开始写作
+
+**写作指令：按三维度揉进逐场景写作，不照搬大纲腔。**
+
+- 每个场景让读者和主角一起经历；发生、感知、反应揉在同一段连续正文里，不按维度分三段。
+- 段落按戏剧单元/画面自然断开：新动作、新线索、新对话、视线切换另起；完整推理、氛围或情绪链可稍长。
+- 高潮/打脸/反转压短，沉淀/推理/收束可长一点；爽点 beat 写密，过场 beat 写疏，避免通篇同长度。
+- 主语节奏：段首或主语重置时可点名；同一动作链内优先代词/省略；关键转折再点名。
+- 标点跟语气走：质问用问号，爆发处少量感叹；犹豫、未尽、打断用动作停顿、短句或换行处理，正文不使用 `……` / `——` / `—` / `--`。
+- 短篇默认第一人称在场：受虐段可直白宣泄，反击段可冷静审判；只删中立无情绪的作者讲解，不删带主角偏色的审判/预告。
+- 情绪可以直写，按 `references/short-craft.md` 第 2 节检查上下文支撑，不逐句补动作或物件。
+- 任务卡点也可以承接情绪，但必须直接加重羞辱、误会、背叛、证据、反击或心死节点；删掉后情绪/证据/关系无损就压缩。
+- 情绪宁烈不温，冲突前置、爽点具体、台词带刺；心死/余韵等以克制为爽感的桥段按题材包收敛。
+
+#### Agent 调用：narrative-writer
+
+正文写作阶段默认由主会话按 2-3 节/批分批写正文；主会话输出是短篇正文的标准形态，不要求单次 agent spawn 完成 8000+ 字全文。
+
+- 每批写完后更新“已写小节摘要”（3-5 条：已揭示信息、情绪位置、未回收伏笔、下一批衔接句）。
+- 下一批先读该摘要和 `正文.md` 尾部 300-500 字再续写。
+- 只有用户明确要求子代理、主会话上下文不足，或需要隔离试写时，才检查 narrative-writer agent（查找顺序见顶部）。
+- 如可用，spawn `Agent(subagent_type: "narrative-writer", prompt: ...)`，只传项目目录、输出文件、情绪目标、题材风格包、小节大纲、角色、主/副对标召回摘要、本书文风全文路径与 style_resolution、作者偏好 query 中的文风/故事设计项、格式硬约束和写作硬约束，并传入检查分工：本批只做内容覆盖与格式自检，完整语义去味由 Phase 4 负责，最终文件扫描由主会话负责。
+- 不把本 skill 整段规则塞进 prompt；细节以已加载的 `short-format.md`、题材包和 `short-craft.md` 为准。
+- 无论谁写，写入 `正文.md` 前都按同一格式规范重排，保证主会话与子代理输出一致。
+
+⚠️ **硬约束只作用于整篇交付范围，不设统一逐节最低字数或行数**。
+写完每批后去掉 `--check-contract` 重跑上面命令，取其非空白字符数作整篇累计值（未写完 exit 1 属正常），各节分布按 `short-format.md`「字数统计」；不自写 Python 计数。某节明显短于相邻节时，先核对批准情节点、可见动作和后果是否已经完整；完整就保留，缺失才补回原计划内容。不得为拉齐节长新增冲突、对话、回忆、配角反应或独立事件。整篇以锁定的用户交付范围为准；未给范围时才使用 8000-20000 字默认值。
+**⚠️ 未进入锁定范围 = 正文未完成。禁止越界后结束；不足只扩已有情节点，超出只压重复解释，不借 repair 新增或删除关键剧情。**
+
+**节数守恒**：正文节数必须等于小节大纲规划节数。不得合并多节为一节。如果写作中发现某节不需要独立存在，应回到大纲阶段调整，而非在写作时偷减。
+
+每个小节按「场景信息揉进」写作（详见 short-craft.md 第 10 节）：发生是主干，感知和反应只在提供新信息时加入；用到的维度揉进同一镜头。揉进不等于按维度分段——禁止"先写发生再补感知再补反应"的堆叠写法，也不要求三项齐全；同样不等于一段到底，按新动作、新物件、新信息或新对话断段。完整推理、氛围、手艺、等待或情绪链可以连续展开，不按固定字数切断。
+
+按以下结构分段写：
+
+#### 第一段：开头（前 300-500 字）
+
+**目标**：3 句话内抓住读者。**必须包含一个开篇钩子**（从 hooks-chapter.md 选择类型）。
+
+**先写导语**：正文开头前先按 `references/submission-craft.md`「导语」写一条 150-220 字导语——四维骨架（起因+核心冲突+人设底色+情绪反转）配黄金三角（具体物件+信息差+留白钩子），一句一段（黑岩/盐言导语形态；番茄导语按 short-format.md 短段叙织）——完整句各自独立成段，不是拆成三字碎句。它就是正文开头的头几段，写好顺势往下接、不重写，所以首句同样守下面的开头零环境和前 100 字事件密度≥3（首句是事件/动作/信息炸弹，不是背景或弧线概括），剧透钩子放导语后半。
+
+**技法指令**：前 100 字事件密度 ≥ 3，不做背景铺垫，直接上事件链。
+
+**开头零环境规则**（默认适用；悬疑、惊悚、灾难、强氛围题材可例外）：
+- 前 3 句禁止出现无事件承载的环境描写（灯光、天气、气味、温度、装修）
+- 前 3 句必须是：事件 / 对话 / 动作 / 信息炸弹，四种之一
+- 任务卡点可以作为动作/事件钩子，但必须立刻带出赌注或矛盾，不能先写流程再解释意义
+- 环境细节只能揉进角色的动作和感知中自然带出，不能独立成句；例外题材中，环境也必须携带威胁、异常或信息差
+- 检查方法：标出前 3 句的主语，如果主语是环境物件（灯光/走廊/房间/天气），重写
+
+开头技巧：
+
+| 技巧 | 说明 | 示例 |
+|------|------|------|
+| 冲突前置 | 第一句就是矛盾 | 「离婚协议放在桌上，他已经签了。」 |
+| 信息差钩 | 给读者一个角色不知道的信息 | 「她不知道，对面那个男人已经在计划第三次了。」 |
+| 反常行为 | 用一个不合常理的行为引起好奇 | 「她把订婚戒指冲进了马桶。」 |
+| 重生反常 | 重生后做前世绝不会做的事 | 「沈栀心念成灰，支着一口气找到了媒婆:郭家的那个天阉，我来嫁。」 |
+| 超自然身份 | 开篇揭示非人类身份 | 「我是世上仅存的红衣厉鬼。我不知自己是怎么死的。」 |
+| 灵魂旁观 | 以灵魂视角描述死亡现场 | 「我的尸体躺在透明棺材里，三个哥哥在外面笑着说：她演得真像。」 |
+| 悬念句 | 抛出一个需要解释的事实 | 「我死后的第三天，老公发了一条朋友圈。」 |
+| 替嫁被弃 | 被迫接受不公正的命运 | 「三个月后，我代替皇后的嫡亲公主坐上了去漠北和亲的轿撵。」 |
+| 代入式提问 | 直接让读者产生共鸣 | 「你有没有在深夜接到过一个不该接的电话？」 |
+
+#### 第二段：铺垫（占全文 30-40%）
+
+- 用物件/数字/习惯建立羁绊（详见 emotional-methods.md「羁绊铺设」）
+- 埋入至少 3 个反转线索，分散在不同小节
+- 在会改变读者预期、行动方向或关系判断的位置埋钩；连续多个小节只有提问没有局部兑现时再调整，不按固定节数填格（类型从 hooks-paragraph.md 选择）
+- 小节用数字分割，每小节推进一个情节点
+- 情绪强度逐节递增，不允许连续 2 节无情绪变化
+- **贯穿道具第 1 次出现必须在此段完成**
+- **反派作恶按阶梯递增**（小恶→中恶，见 villain-and-reveal.md）
+
+#### 第三段：升级（占全文 20-30%）
+
+- 冲突必须比上一段升级（强度/范围/代价至少一个维度上升）
+- 插入倒计时钩子或代价钩子制造紧迫感
+- 随风险和选择升级提高牵引强度；用新证据、代价、误判修正或局部反击推动，不按固定节数另塞钩子（按题材见 genre-writing-formulas.md）
+- 埋入误导信息，让读者猜错反转方向
+- **数字/金额递增作为叙事工具**（具体数字替代模糊描述，见各 genre-styles 招式库「数字承重」）
+- **场景引擎有变化**：行动、对话、证据、任务、等待、空间压力与关系选择按因果需要切换；不为动静交替补无功能小动作
+
+#### 第四段：反转（占全文 10-15%）
+
+- 反转在一节内完成揭示，不拖延
+- 揭示后确保前面铺垫的线索可被回溯（读者能找到「原来如此」的伏笔）
+- 反转节的情绪冲击强度必须 > 前面所有节的最高值
+- **用证物/证人/偷听/剥洋葱揭露真相**（4 种方式见 villain-and-reveal.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,32 @@
+# Phase 4：短篇精修打磨
+
+本文件中的 `scripts/` 与 `references/` 路径均相对本 skill 根目录。
+
+Phase 3 写手负责内容覆盖与格式自检，不提前执行完整语义去味；该分工须随写作 prompt 传入。Phase 4 的 Gate 检查由一个执行者完成（下方 narrative-writer 或主会话），保留原检查清单与所选 Gate 的改写顺序；一致性检查职责不变。最终扫描及 delivery 验收由主会话对最终落盘文件执行，修改后只复核改动和重跑受影响检查，不另开整轮去味。
+
+加载 `references/writing-workflow.md` 中的精修清单完成检查。
+重点：开头钩子、情绪曲线、反转铺垫、每句话价值、格式规范、AI 腔。文件模式依次运行 `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 或确属细纲照搬先改正文再复扫；其他提示仅作读感复核，功能性写法可保留。
+
+上述修改全部落盘后，运行 `node scripts/check-delivery-contract.js --json --min-chars {MIN} --max-chars {MAX} --sections {N} {短篇目录}`。exit 0 才可交付；exit 1 只按 `repair_scope` 最小修复并重跑受影响的质量检查与本命令，最多 2 轮；仍失败则停止，按下方交付说明告诉作者哪项没达标、差多少。exit 2、脚本缺失或不可执行时不得声称交付契约通过。本 verifier 只验用户字数、节数与排版形状，不替代正文质量判断。
+
+#### Agent 调用：narrative-writer（去AI味）+ consistency-checker
+
+精修阶段，如果项目已部署对应 agent，可 spawn：
+- `Agent(subagent_type: "narrative-writer", prompt: "项目目录：{dir}\n任务描述：去AI味+格式检查\n检查分工：你负责本次语义去味及原定自检；最终文件扫描由主会话执行，不在子代理内重复\n检查范围：{正文文件}\nstyle_resolution：{与写作一致的本次文风裁决，含全文路径}\n作者偏好：{query 命中的 prose_style/story_design 项}\n删除优先：每条 AI 味项先判能否删除——删后不丢伏笔/钩子/角色/情节/必要信息的直接删，会丢才润色（删除受比例上限与字数下限约束，跌破下限改降AI重写）\n必须检查：检查是否连续使用头皮发紧/眼皮一跳/心口一沉/胃里翻涌等精致戏剧反应，能写普通动作/普通感觉就写普通动作/普通感觉；已有手机/聊天记录/公告/账单/病历/证据截图等信息，保留为角色看到或处理的场内载体，不改成叙述者解释；任务卡点只在角色本来有要办的事且能加重情绪/证据/关系/反转时使用，不为自然感补流程")` — 执行去AI味（7 Gate）和格式合规检查
+- `Agent(subagent_type: "consistency-checker", prompt: "项目目录：{dir}\n检查范围：{正文文件}\n检查类型：事实冲突+伏笔断线+角色属性不一致")` — 执行一致性检查
+
+如 agent 不可用，由主线程直接执行。
+
+**正文洁净规则**：
+- 自检（字数统计、禁用词扫描、格式检查）是过程动作，结果直接在对话里说明，不落盘成文件
+- **绝对不能**把自检记录附加到正文文件末尾
+- 正文中不得出现任何 `<!-- 自检 -->` 或类似的检查标记注释
+
+不通过 → 回退补足。
+
+**交付说明（给作者看）**：只用大白话，按三块写：
+1. 写了什么：标题、一句话核心钩子或反转、总字数、几节。
+2. 要作者拍板的事：每件写成一句问题并附推荐默认（如「结尾要不要再留个小反转？默认不留」）；没有就省略。
+3. 下一步可选：精修某段、去 AI 味、换平台改写等。
+
+自查结果只写一句（如「自查过字数、分节和常见 AI 腔，都过了」；没过就说哪项差多少）。不写脚本名、检查 ID、字段名、参数或大纲表格格式。