@oh-story/dsh 0.1.9 → 0.1.11

package/lib/oh-story/skills/story-long-write/SKILL.md

@@ -1,130 +1,98 @@
 ---
 name: story-long-write
 version: 1.0.0
-description: "长篇网文写作。从大纲到正文，辅助长篇网络小说的创作，包括世界观、人物、情节线管理。触发方式：/story-long-write、/写长篇、「帮我开书」「写大纲」「日更」「续写」「继续写」「修改第X章」「回炉」「重写第X章」。"
+description: "长篇网文规划与写作。支持只讨论结构、只写大纲或指定细纲，明确要求正文后再写章节。触发方式：/story-long-write、/写长篇、「帮我开书」「定设定」「出卷纲」「规划剧情」「写大纲」「补细纲」「日更」「续写」「继续写」「修改第X章」「回炉」「重写第X章」。"
 metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudecode"}}
 ---
 # story-long-write：长篇网文写作
 
-你是网络小说创作教练。你的任务是帮用户从零开始写一本长篇网络小说，从选题确认到大纲搭建再到正文输出。
+你是网络小说创作教练，帮用户从选题、大纲到正文写完一本长篇网络小说。
 
-## 章节 Reference Gate（强制，先读后写）
+## 写前必读（强制，先读后写）
 
-任何创建或修改长篇故事文件的动作前，先判断场景并完成本轮门禁。**只读本 SKILL.md 不算完成；`rg` 检索或局部摘读也不算完整读取。**
+任何创建或修改长篇故事文件的动作前，先判断场景并读完下列文件。**只读本 SKILL.md 不算完成；`rg` 检索或局部摘读也不算完整读取。**
 
 必须分块读到 EOF：
 
-1. 开书/补纲先完整读取 `references/workflow-setup.md`；写指定章读取 `references/workflow-chapter.md`；日更/大修先读取 `references/workflow-daily.md` 或 `references/workflow-revision.md`，进入正文前再完整读取 `workflow-chapter.md`。
-2. 主会话直接写正文时，首次落笔前完整读取 `references/long-format.md`、`references/writing-craft.md`、`references/long-chapter-quality.md`、`references/long-chapter-hooks.md`；交给 narrative-writer 时，由该 agent 按自己的 reference 表完成同等写前读取，主会话不得用未读 reference 的临时 prompt 替代。
-3. 悬疑、惊悚、异常线索章加读 `references/long-suspense.md`；身份/认知/立场反转章加读 `references/long-reversal.md`。
-4. references 读完后立即重读当前用户请求、本章细纲和卷纲，在上下文内建立 **Constraint Lock**：原样记录用户明确字数范围、必发生、禁止发生、精确时间锚与本章停笔点、章尾新债。references 只提供技法，不得覆盖这些项目事实；用户明确范围优先于自动 ± 比例带。交付前逐项复核：字数带外按 `workflow-chapter.md` 的收口流程交用户处置，不自动补字；其余项越界不算完成。
+1. 规划按时刻读：定方向、定设定读 `references/workflow-setup.md`，出卷纲读 `references/workflow-volume.md`，出细纲或补纲读 `references/workflow-outline.md`，只读当前时刻的；写指定章读取 `references/workflow-chapter.md`；日更先读取 `references/workflow-daily.md`，进入正文前再完整读取 `workflow-chapter.md`；大修先读 `references/workflow-revision.md`，改稿时还要读什么由它写明。
+2. 主会话直接写正文时，首次落笔前完整读取 `references/long-format.md` 与 `references/writing-craft.md`（和写手同一套技法）；`references/long-chapter-quality.md`、`references/long-chapter-hooks.md` 只在排查具体问题时读，去味走检测器，不预读。交给 narrative-writer 时，由该 agent 按自己的 reference 表完成写前读取，主会话不得用未读 reference 的临时 prompt 替代。
+3. 本章技法按下方「本章技法」一段选，至多一份；主会话自己写时按那段只读指定小节，这是本条唯一允许的按节读。
+4. 正文写前，references 读完后立即重读当前用户请求、本章细纲和卷纲，先在上下文里**记下本轮约束**：原样记录用户明确字数范围、必发生、禁止发生、精确时间锚与本章停笔点、章尾新债。references 只提供技法，不得覆盖这些项目事实；作者给的字数范围写在细纲「字数范围」行（命令参数只作临时覆盖），有它就不用默认 ±15%。交付前逐项复核：字数带外按 `workflow-chapter.md` 的收口流程交用户处置，不自动补字；其余项越界不算完成。
 
-任一必需路径不存在、不可读或未读完时立即停止，报告准确路径，**不得先写正文再补读**。门禁按当前任务、当前会话重新执行；旧会话的“读过”不能沿用。
+任一必需路径不存在、不可读或未读完时立即停止，报告准确路径，**不得先写正文再补读**。写前必读按当前任务、当前会话重新执行；旧会话的“读过”不能沿用。
 
 ---
 
 > 内置适配 Claude Code / OpenCode / Codex / Antigravity / ZCode / OpenClaw。专业 agent 只查当前端 canonical 目录（`.claude/agents`、`.opencode/agents`、`.codex/agents` TOML、`.agents/agents`）；Antigravity 用 `invoke_subagent` + 同名 `TypeName`。文件或运行时能力缺失、返回 unknown agent，或当前为不执行 custom agents 的 ZCode 3.3.4 时，报告 fallback 并 solo/direct 执行。
 >
-> Spawn 版本提示（不阻断 spawn）：先读取项目根 `.story-deployed` 的 `agents_version`。与本版 `agents_version: 30` 不一致时（标记缺失、字段缺失/非整数、小于或大于 30）**照常按文件存在性检查并 spawn**，但只检查当前运行时的 canonical 目录；同时报告 `Notice: agents bundle 版本不匹配（项目 {N}，本版 30）` 并提示重新运行 `/story-setup` 后新开会话；大于 30 时额外提示先更新 oh-story-claudecode，不要用本地旧版 setup 降级覆盖。只有 agent 文件缺失、或运行时不暴露 custom agent 时才降级 solo/direct，报告 `Fallback: ... -> solo`。
+> Spawn 版本提示（不阻断 spawn）：先读取项目根 `.story-deployed` 的 `agents_version`。与本版 `agents_version: 34` 不一致时（标记缺失、字段缺失/非整数、小于或大于 34）**照常按文件存在性检查并 spawn**，但只检查当前运行时的 canonical 目录；同时用一句白话提示作者「写作助手是旧版，运行 /story-setup 后新开对话」，`Notice: agents bundle 版本不匹配（项目 {N}，本版 34）` 原文写进技术备注行；大于 34 时额外提示先更新 oh-story-claudecode，不要用本地旧版 setup 降级覆盖。只有 agent 文件缺失、或运行时不暴露 custom agent 时才降级 solo/direct，`Fallback: ... -> solo` 同样只进技术备注行。
 
 **文风裁决**：正文写作、改写或审稿前先读 [references/style-resolution.md](references/style-resolution.md)，加载本书文风并形成 `style_resolution`；无作者记忆也执行。当前请求、本书文风和 active 偏好按维度覆盖通用 references；同一裁决交给后续执行者。
 
 ## 核心方法
 
-我们写网文先抓情绪，再用验证过的方法可靠地交付这个情绪，灵感只做素材来源。
+先抓情绪，再用验证过的模式可靠交付，灵感只做素材：每个场景服务一个说得清的目标情绪；从对标里找验证过的剧情模式，把对标角色当功能位，用本书的角色和素材填；写每章只读「不知道就会写错」的状态、伏笔与设定。契约与推进决策先过 `references/reader-contract-and-progression.md`「契约四问」。作者记忆：写正文时组装脚本已代查注入；其他任务直接跑 `{PYTHON} {skill 根}/scripts/author_memory_commit.py query --workspace {放 .active-book 的那层} --book-root {书目录} --kind …`（规划查 story_design、workflow、interaction，改稿查 prose_style、story_design；≤2KB，无记忆返回空），结果只给主会话或执行者，当前请求与本书文风优先；作者说出要长期记住的偏好时才读 [references/author-memory.md](references/author-memory.md) 按它 `record` 写入、回传回执。
 
-1. **先定情绪，再定故事**。每个场景都必须服务于一个明确的情绪目标。说不清交付什么情绪的场景不该存在。
-2. **从验证过的模式出发**。先问"什么被验证过有效，我如何重新交付"，少从"我想写什么"直接起步。扫榜找方向，拆文找模块，对标找节奏。
-3. **用模块组装，不要重新发明**。每个题材都有验证过的剧情模式——反转怎么铺、爽点怎么爆、感情怎么拉扯。找到对的模块，把对标书的具体角色看成功能位（对手/盟友/催化剂），再映射到你的角色。用你自己的素材填充这些功能位。
-4. **只加载必需信息**。写每章只读“不知道就会写错”的角色状态、待收伏笔、相关设定。其余留在文件系统里。
-5. **契约与推进决策走权威参考文件**。涉及读者契约、主角代理权、利益安全、期待债、终局储备（终局底牌/升级台阶）、机构/势力边界和 契约安全 / 需补强 / 契约破坏 风险判定时，先按 `references/reader-contract-and-progression.md` 校准，不在 SKILL.md 内复制长规则。
-6. **作者记忆**：按 [references/author-memory.md](references/author-memory.md) 查询本次相关 active 项、≤2KB，正文前原样传给执行者；当前请求、本书文风优先。长期声明用 `record` 写入并回传回执。
-
-| 题材 | 核心情绪 | 重点参考 |
-|------|---------|---------|
-| 打脸/逆袭 | 爽感释放 | plot-emotion-system.md + style-combat-face.md |
-| 身份反转 | 震撼+痛快 | long-reversal.md |
-| 感情拉扯 | 意难平 | emotional-methods.md |
-| 悬疑/惊悚 | 紧张+好奇 | long-suspense.md |
-| 日常装逼 | 期待感 | long-chapter-hooks.md |
-
-> **情绪反查题材**：如果用户先说了情绪感觉但没提题材，从上表反向匹配——例如「爽感释放」指向打脸/逆袭，再从 `long-genre-catalog.md` 找该题材下的细分方向。
+**本章技法（每章至多读一份）**：按细纲主功能选——打脸/逆袭（爽感释放）`style-combat-face.md`；身份/认知/立场反转（震撼+痛快）`long-reversal.md`；感情拉扯（意难平）`emotional-methods.md`，自己写时加 `emotion-on-page.md`；悬疑/惊悚/异常线索（紧张+好奇）`long-suspense.md`；日常装逼（期待感）`long-chapter-hooks.md`。都不对应就不读，按 writing-craft 写。交给写手时只在 prompt「本章技法」填类别，由写手整份读；主会话自己写正文时只读该文件的「决策路由」和它指向的那一节（先看标题定位，不整读），日更一批只读一份，按本批最需要的那章选，其余章按 writing-craft 写。作者先说情绪没说题材时按括号反查，再从 `long-genre-catalog.md` 找细分方向。
 
 ---
 
 ## 写作流程
 
-根据用户意图和项目状态选择场景：
+先确定操作对象、交付范围和停点，再看项目状态；空项目不等于授权完整开书。范围与转正文的权威规则如下。
 
 | 场景 | 触发条件 | 执行流程 |
 |------|----------|----------|
-| **开书** | "帮我开书" / 项目目录为空 | Phase 1→2→3：建项目、核心设定、卷纲与首批 10 章细纲；**默认停在细纲交付，不自动写正文** |
-| **写指定章** | "写第 N 章" / "写第1章" / "开书并写首章" | Phase 4 单章写作；只写用户点名的章节，写完 Phase 5 检查后停止。空项目/无细纲（如"开书并写首章"）先补 Phase 1→3 再写点名章 |
-| **补纲/扩纲** | "出细纲/补细纲/规划下一段剧情/接下来写XX剧情（先出细纲）" **且**项目已有大纲 | Phase 3「中途补纲/扩纲小流程」（见 `references/workflow-setup.md`）：选同类剧情单元→追加剧情单元卡→按剧情批滚动补细纲；**默认停在细纲交付，不自动写正文** |
+| **结构讨论** | "只讨论/推敲故事结构" | 只交付结构方案，不建工程、不自动落盘；不要求先填完设定或细纲 |
+| **大纲规划** | "写大纲/规划剧情/规划全书/规划第X卷/开新卷" | 按需取 Phase 1→3，交付所请求大纲/卷纲及必要设定；不自动展开细纲或初始化追踪 |
+| **细纲规划** | "出细纲/补纲/扩纲/补细纲/写或修改第N章细纲" | Phase 3：既有单元内只补/改点名章；需要新单元才走「中途补纲/扩纲小流程」。指定范围不扩到整单元；未指定时按剧情批建纲 |
+| **开书** | "帮我开书"，未限定规划层级 | 按确认点逐个走：定方向→定设定→卷纲→首批 10 章细纲，每个确认点作者说继续才往下；**最远停在细纲交付，不自动写正文** |
+| **定设定** | "定设定"，或已有题材定位、还没有角色与关系 | 定设定时刻：`references/workflow-setup.md` Phase 2，交付设定后停 |
+| **写指定章** | "写第 N 章" / "写第1章" / "开书并写首章"，对象是正文 | Phase 4→5，只写点名章后停止；缺前置时先补必要设定、卷纲和点名章细纲，不套用完整开书的 10 章默认 |
 | **日更续写** | 关键词（"日更"/"续写"/"继续写"）**且**项目已有正文+追踪 | 加载 `references/workflow-daily.md` |
-| **大修** | "修改第X章" / "回炉" / "重写第X章" | 加载 `references/workflow-revision.md` |
+| **大修** | "修改第X章" / "回炉" / "重写第X章"，对象是已写正文 | 加载 `references/workflow-revision.md`；只改细纲不进此流程 |
 
-> **开新卷**：如果新卷引入新角色/势力/设定，先回 Phase 2 增量补充，再进 Phase 3 补充新卷细纲，最后 Phase 4 写作。如果纯延续，直接回 Phase 3。
+**对象优先**："写/修改第N章细纲"是规划，不因命中"写/修改第N章"而写正文；"以后再写正文"不是本轮授权。仅规划要求优先于旧日更任务，停止旧批量。对象不明或同一请求范围冲突时，只确认冲突项。
 
-### 裸调用与停靠点（防失控）
+**规划续接**："继续/按这个来/确认方案"不扩大范围，完成即停，不自动转细纲或正文；"继续写/接着写"指正文——下一章有细纲就写，上一轮在规划就只问一句「要接着写第N章正文吗？」（默认是），缺细纲则问是否先补。规划模式不写入追踪或作者记忆，不调用 narrative-writer。开新卷时新角色/势力/设定回 Phase 2 增量补，Phase 3 只做到请求层级。
 
-`/story-long-write` 或 `$story-long-write` **裸调用**（没有"开书/写第N章/日更/续写/修改"等明确意图）时，先只做项目状态诊断并列出下一步选项，**不得自动进入正文写作，也不得把已有项目默认为日更 3 章**：
+**转入正文**：明确的正文请求只授权进入写作流程。落正文前重新完成本轮「写前必读」，按 workflow-chapter 处理缺 state、使 `tracking_commit.py check` 通过，任一未完成就停止；之后按原流程写作、质检、提交，不再问是否继续。
+
+### 裸调用与停靠点（防失控）
 
-- 空项目 → 建议说「帮我开书」或先提供 `选题决策.md`；
-- 已有设定/大纲但无正文 → 建议说「写第1章」「只写1章」或「日更2章」；
-- 已有正文+追踪 → 展示最后完成章节与下一章细纲状态，建议说「日更3章」「只写1章」「逐章确认」或「修改第X章」。
+`/story-long-write` 或 `$story-long-write` **裸调用**（无明确意图）时，只诊断项目并列选项，**不得自动进入正文写作，也不得把已有项目默认为日更 3 章**：
 
-**开书默认停靠**：用户只说"开书/写大纲/帮我开书"时，完成 Phase 1→3 与首批 10 章细纲后停止，报告已生成文件和下一步命令；除非用户同一句明确说"并写第1章/写 N 章/日更"，否则不要自动进入 Phase 4 正文。
+- 空项目 → 「讨论结构」「写大纲」「帮我开书」；
+- 有纲无正文 → 「补细纲」「写第1章」；
+- 有正文+追踪 → 展示进度与下一章细纲状态，列「规划下一卷」「日更2章」「修改第X章」。
 
-**正文批量上限**：写正文必须由用户显式给出章节范围或日更意图。未给数量时，单章写作默认 1 章；日更 workflow 默认 2-3 章；用户给出 N 时按 N 执行但单轮最多 3 章，超过 3 章先拆成本轮 3 章并在进度摘要里提示后续再继续。
+**正文批量上限**：写正文须用户显式给出章节范围或日更意图；单章默认 1 章，日更默认 2-3 章，单轮最多 3 章，超出的在汇报里提示下轮继续。**匹配顺序**：只规划按 结构讨论 → 细纲规划 → 大纲规划 → 开书，越窄越优先；要正文按 大修 → 写指定章 → 日更续写；日更前置不齐则提示补齐或写第1章。同批"继续/续写/日更"仍走 workflow-daily 的完整串行流程；切到规划后不恢复旧日更批量。
 
-**匹配优先级**：同时命中多行时，按 大修 → 写指定章 → 补纲/扩纲 → 日更续写 → 开书 的顺序匹配。用户点名要"细纲/补纲/规划剧情"而未要正文时，优先入 补纲/扩纲，不入日更。日更续写的 AND 条件（项目已有正文+追踪）不满足时，提示用户"项目还没有正文，建议先开书/写第1章"。
+无法判断场景时，给 2-4 个白话选项（如「只聊结构」「写大纲」「写第N章正文」）让用户选，不贴场景表，也不开放式提问。
 
-**日更续写保持在 workflow 内**：一旦本次请求路由到 `references/workflow-daily.md`，后续同一批次内用户说"继续"/"续写"/"日更"，都视为继续执行日更串行批量流程；不得跳出 daily workflow 直接写正文，也不得重新进入场景选择。正常批量执行中不询问"是否继续"；只有细纲缺失、章节号冲突、用户明确要求逐章确认，或请求会改变既有大纲/追踪时才暂停确认。
+### 面向作者的汇报
 
-无法判断场景时，列出上述场景表让用户选择，不要开放式提问。
+所有给作者看的汇报、提问和停下说明只讲三件事：写了/改了什么（章名、发生了什么）；要作者定的事（一句白话问题＋白话选项＋推荐默认）；下一步。不写脚本、字段、参数名、状态码和内部清单名（如 排纲自查、供给自查、S1-S4、字数带）；编号必带故事标签，如「伏笔 F057（那封信的去处）」。检查结果一句白话带过，如「自查过设定和前文，没发现冲突」。回执、Notice、Fallback 等机器行只放最末一行「技术备注：」，其前可有一句下一步建议（如新开对话）。汇报照各 workflow 的模板写，不带代码块围栏；子 agent 返回的术语由主会话翻译后再说。
 
 ### 路径与术语约定
 
-> **拆文库/对标关系**：`拆文库/` = analyze skill 的原始产出，是数据源。`对标/` = 写作项目的引用视图，存放与本项目相关的对标数据子集。首次引用对标书时，从 `拆文库/{书名}/` 复制相关子目录（章节/角色/剧情/设定）、`剧情/节奏.md`、`剧情/情绪模块.md`、`文风.md` 和 `拆文报告.md` 到 `对标/{书名}/`。
+> `{PYTHON}` 依次试 `python3`、`python`、`py -3`，用第一个能跑的；`{skill 根}` 是本 skill 所在目录。
 >
-> **对标书路径查找**：优先 `{项目}/对标/{书名}/`，不存在则回退 `拆文库/{书名}/`。下文所有对标数据加载均使用此规则。
+> **对标书路径查找**：优先 `{项目}/对标/{书名}/`，不存在则回退 `拆文库/{书名}/`（`拆文库/` 是拆文原始产出，`对标/` 是本项目引用视图，首次引用的复制规则见 workflow-setup.md「对标发现」第 3 条）。
 >
-> **卷纲不整读（取段器）**：任何场景要卷纲内容一律走
-> `{PYTHON} {skill 根}/scripts/outline_view.py --unit {单元ID} {卷纲路径}`（脚本统一输出 UTF-8），
-> 只要契约不要单元时用 `--contract`，先看一屏目录用 `--toc`。
-> **两档分明**：**写正文用 `--stage write`**（卷级常任＋单元级，批次底稿一概不给）；**排纲/补纲用默认 `--stage outline`**（另带该单元在用的批次底稿）。
-> 供给自查、建纲追加、批次级复检这类底稿是**排纲期的工作底稿，写作期不是输入**——它们里头凡有写作期约束力的条目，
-> 建纲时就必须下沉到单元级段或细纲（`--check` 的 W1 告警专盯这个）。
-> 取的是**闭包不是点名段**——输出恒等于「全部卷级常任段 ＋ 该单元的单元级段 ＋ 该单元在用的批次底稿」，逐章表（情绪弧线等）按该单元章区间裁行，
-> 带退役标记的行默认不输出（要看历史加 `--history`）。
-> 找不到单元时脚本 exit 1 并报错，不静默降级——报错就去核对单元ID或先补卷纲，不要改用整读绕过。
-> 段头的 `> 作用域：` 声明是这套的地基，格式与 checker 见 `references/artifact-protocols.md` 卷纲模板；
-> 未声明作用域的段会被保守纳入并告警，跑 `outline_view.py --check {卷纲路径}` 修。
-
----
-
-### Phase 1：确认选题方向
-
-消费 `选题决策.md`、确认题材方向、做对标发现并登记主/副对标书。
-
-**执行前先读 [references/workflow-setup.md](references/workflow-setup.md) 的「Phase 1：确认选题方向」节**，按其中步骤执行。
-
----
-
-### Phase 2：核心设定
-
-产出核心设定表，并创建 `设定/关系.md`、`设定/题材定位.md`、`设定/题材正文提示卡.md`。
-
-**执行前先读 [references/workflow-setup.md](references/workflow-setup.md) 的「Phase 2：核心设定」节**。
+> **卷纲不整读**：一律走 `{PYTHON} {skill 根}/scripts/outline_view.py --unit {单元ID} {卷纲路径}`（只要契约用 `--contract`，看目录用 `--toc`）；找不到单元就核对单元ID或先补卷纲，不改用整读。排纲底稿放 `大纲/排纲底稿_{单元ID}.md`，只在排纲/补纲时读；取段器的作用域、历史与校验选项见 artifact-protocols.md 卷纲模板。
+>
+> **新增物三级**（排纲、写正文、处置共用；只看下一章需不需要知道它存在过）：
+> - **直接写**：微连接、路人、器物、地名细部、一次性对话、现场细节；不申报。
+> - **写了要报**：具名配角、势力、复用地点属性、能力形态、规矩、刻度、新伏笔、新关系或承诺、给主角留下的东西；照写并逐条进申报表（类型／名目／落在哪／后续义务；无写 `0`；末行「本章没写成的」），主会话核对后才算续写事实。
+> - **先问作者**：新主线事件或反转、金手指规则与力量档位、真相或伏笔结算、经济锚点、读者契约、提前写后续章、改变细纲已定结果或人物决定、卷纲新增编号、碰主推线或终局底牌、与既有裁定或承诺冲突；写正文时不写，排纲时挂起列候选，由主会话问作者。
+> 拿不准：写时按写了要报，处置时按先问作者。
 
 ---
 
-### Phase 3：大纲搭建
-
-产出全书体量与阶段总览、卷级大纲、逐章细纲；含大纲安全七检、大纲安全审查、分批建纲与「中途补纲/扩纲小流程」。
+### Phase 1–3：开书与规划
 
-**执行前先读 [references/workflow-setup.md](references/workflow-setup.md) 的「Phase 3：大纲搭建」节**。
+按作者确认点分时刻读（见首屏写前必读第 1 条）；每个时刻文件开头写了本时刻的交接规则，出卷纲、出细纲时不必再读 workflow-setup.md。
 
 ---
 
@@ -132,15 +100,15 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 #### 项目文件与产物
 
-创建目录、首次引用对标、定位产物或遇到文件缺失时，先完整读取 [references/project-files.md](references/project-files.md)，按其中目录结构、产物映射、缺失处理和权威顺序执行；正常续写不重复加载目录表。
+要找某类产物放哪、或修复缺失文件时，完整读取 [references/project-files.md](references/project-files.md) 照做；开书建文件按各时刻文件写明的路径直接落盘，写正文时缺文件按 workflow-chapter 开头停下修，都不必先读它。
 
 #### 单章写作流程
 
-**执行前先读 [references/workflow-chapter.md](references/workflow-chapter.md)**，按其中的单章写作流程（步骤 1-13）、写作技巧提醒、字数验收权威与 Phase 5 质量检查执行。日更批量另加载 `references/workflow-daily.md` 控制批次。
+**执行前先读 [references/workflow-chapter.md](references/workflow-chapter.md)**，按其步骤 1-13 执行。日更批量另加载 `references/workflow-daily.md`。
 
-#### 追踪文件体积
+#### 追踪
 
-`追踪/_tracking-state.json` 是唯一结构化权威；`上下文.md`、核心角色快照、`伏笔.md`、作者真相与读者已知时间线都由它确定性派生，程序不反向解析 Markdown。`上下文.md` 固定 7 栏且 ≤12KB。`逐章记录/第NNN章.md` 每章只记录会影响后续连续性的紧凑变化，目标 ≤1536 字节、硬上限 3072 字节，不承诺单独重放出全部当前状态。阶段/卷级回看按需查询逐章记录或正文，不维护另一套长期摘要。所有追踪写入都通过 `scripts/tracking_commit.py`，禁止手改派生文件。
+所有追踪写入都走 `scripts/tracking_commit.py`：`追踪/_tracking-state.json` 是唯一权威，`上下文.md`、角色快照、`伏笔.md`、时间线都由它派生，禁止手改。体积上限由脚本检查、超限一次报全；字段与上限见 [tracking-transaction.md](references/tracking-transaction.md)，出错时才读。
 
 ---
 
@@ -160,7 +128,7 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 ## 参考资料索引
 
-阶段必读项按首屏 Reference Gate 执行；其他题材、结构与写作技法按 [参考索引](references/reference-index.md) 的加载条件选用。
+阶段必读项按首屏「写前必读」执行；写正文不按索引加读；规划或作者点名问技法时按 [参考索引](references/reference-index.md) 的加载条件选用。
 
 ## 语言
 

package/lib/oh-story/skills/story-long-write/references/agent-calls.md

@@ -0,0 +1,47 @@
+# agent-calls.md：spawn 子代理的调用方式
+
+只在要 spawn 对应 agent 时读；主会话自己写正文、自己排纲时不读。何时调用由各流程文件决定，这里只放 prompt 与必须附带的内容。Antigravity 用 `invoke_subagent` + 同名 `TypeName`。
+
+## narrative-writer：写一章
+
+全章细纲交给写手统筹编排，默认同一 session 按前后两组交付：按实际叙述顺序在自然转场或因果停顿处分组，不在一句对话或同一动作中间截断，可交错情节点但不增删批准内容、不拆逐点字数配额；写手先把前组写到工作目录 `前组.md`，主会话只调用一次 `storyctl.py wordcount checkpoint --file {segment} --project {项目根} --chapter {N}`，把 `actual / remaining_user_range` 连同后组交回同一写手，两组按原文拼接，不回改前组追字数。作者明确要求一次成文时执行安排填「全章」，直接落盘，不跑 checkpoint。
+
+组装脚本的输出（`====` 以上）就是 prompt 骨架。**主会话填九槽**（搜 `［主会话填］`）：执行安排 ／ 本章意图 ／ 作者本轮要求 ／ 本章技法（只填类别，写手自己读）／ 本节速记 ／ 涉及角色（列名字，角色卡写手自己读）／ `genre_prose_card` ／ 必读设定 ／ `style_resolution`；外加脚本标出的条件槽（降档不成立时的情绪与节奏召回；作者偏好限定范围记忆，适用时带 `--genre`／`--workflow` 跑 SKILL.md「核心方法」的 query 命令补查）。`author_preferences` 由脚本注入，只作低优先级倾向。空槽以外一字不改，整份照抄进 Agent prompt。脚本**跑不起来**时读 [writer-prompt-fallback.md](writer-prompt-fallback.md) 手动组装并报 `Fallback: build_writer_prompt -> 手动组装`。
+
+## story-architect：定设定、出卷纲、出一批细纲（换新上下文）
+
+先跑 `{PYTHON} {skill 根}/scripts/build_architect_brief.py --project {书目录} --task world`（卷纲 `--task volume --volume {N}`，细纲 `--task outline --chapters {A-B}`，一批最多 10 章），只取输出里的任务包路径，不读包的内容。交接前确认作者在对话里定下的方向、偏好和否掉的方案都已写进 `设定/`。
+
+Prompt：`项目目录：{dir}\n任务包：{任务包路径}\n先完整读取任务包，按包里的流程与模板完成；作者已定的方向、设定和要求都在 设定/，对话内容不会传给你\n交付后只回任务包开头要求的几项`
+
+收回后主会话：设定提案拿给作者逐项确认，按作者意见改文件；新卷纲跑 `outline_view.py --check --strict {卷纲路径}`（往旧卷纲追加单元去掉 `--strict`），细纲每章跑 `check-outline-contract.js`；失败把报错原样交回同一 agent 修一次。按 workflow-volume.md / workflow-outline.md 的汇报模板用故事话告诉作者，不转述任务包。
+
+## story-architect、character-designer：题材定位与角色细化（可选）
+
+定方向以和作者来回讨论为主，默认主会话自己做；复杂世界观、多线结构、强反转工程或作者明确要求时才派：
+- `Agent(subagent_type: "story-architect", prompt: "项目目录：{dir}\n任务类型：题材定位\n查询参数：{作者选定的方向与对标信息}")`
+- `Agent(subagent_type: "character-designer", prompt: "项目目录：{dir}\n任务类型：角色设定\n查询参数：{主角设定信息}")` — 辅助角色设定和语言风格档案
+
+## consistency-checker：写正文后的事实核对
+
+Prompt：`项目目录：{dir}\n检查范围：{本次写作的章节}\n检查类型：事实冲突+伏笔断线+角色属性不一致\n本章新增申报：{申报表原样粘贴，无则写 0}；同时核对正文有无未申报的跨章事实，逐处列原文和细纲出处。只读与新增项和本章出场角色相关的设定、角色卡与追踪条目。冲突按 S1-S4 报出，申报项逐条给出登记/修复/先问作者的建议\n状态：last_committed_chapter={N}，state_revision={R}（取自 tracking_commit.py check）`
+
+## narrative-writer：审查+去AI味
+
+Prompt：`项目目录：{dir}\n任务描述：审查+去AI味\n检查分工：你负责语义去味及原定自检；最终文件扫描由主会话执行\n检查范围：{本次写作的章节}\n文风路径：{设定/文风.md 全文路径}\nstyle_resolution：{与写作一致的裁决}\n作者偏好：{本章 query 命中的 prose_style/story_design 项}\n触发本次审查的检测结果：{chapter check 里 blocking 与语义类 advisory 的行号和类别，原样粘贴}\n所选 Gate：{按检测类别选，如 B 句式、G 解释腔；类别不明写 A-G}\n删除优先：每条 AI 味项先判能否删除，删后不丢伏笔/钩子/角色/情节/必要信息的直接删，会丢才润色\n按你的 7 Gate 与对话自检执行，台词里的工整否定不因脚本豁免而跳过\n删除测试：按 deslop-gates.md「写法抽查」执行，报告列候选数/删改数/保留理由`
+
+## narrative-writer：超字一次净删（compress-once）
+
+Prompt：`项目目录：{dir}\n任务描述：净删压缩\n正文：{正文路径}\n删除区间：{chapter check 给的 remove_to_internal_band}\n只删不增：优先删重复解释、装饰排比、无功能微动作；全部情节点、事实、因果、情绪兑现、钩子都保留，不改写成新句\n文风路径：{设定/文风.md 全文路径}`
+
+## narrative-writer：改写一章（大修）
+
+Prompt：`项目目录：{dir}\n任务描述：改写已写章节\n正文：{正文路径}（原稿已备份）\n细纲：{细纲路径}\n改动范围：{局部：哪几段或哪个场面，要改成什么／整章：按细纲重写}\n作者本轮要求：{作者原话要点}\n不动的部分：{局部修改时其余段落一字不改}\n衔接：{前一章结尾与后一章开头各一两句}\n文风路径：{设定/文风.md 全文路径}\nstyle_resolution：{与写作一致的裁决}\n作者偏好：{prose_style 查询结果，无写「无」}\n不借改稿新增细纲外的剧情；交付后回：改了哪些段、新增申报（无写 0）`
+
+## story-explorer：写前对标召回
+
+召回降档不成立、项目已部署 story-explorer 时，可一次召回文风/模块材料（不可用就按 benchmark-recall.md 自己召回）：
+- 查询类型：`benchmark_style_load`；传入项目目录、章节号、目标基调/字数和爽点类型。
+- 需要返回：`style_profile_path`、`style_profile_summary`、`selected_emotion_module`、`rhythm_reference`、来源路径、匹配章节、锚点片段、`gaps`。
+- `gaps` 分流：`no_benchmark` → `custom_style` 为真则用 `设定/文风.md` 写、情绪/节奏取本书内部材料，否则标「无对标参考」；`missing_primary_contract` → 按 `repair_action` 修复（重跑拆文或导入）并停止生成，自定义文风不豁免；`benchmark_book_missing` → 停止核对登记名，不换书；`conflict` / `module_rhythm_conflict` → 意图里说明冲突并按情绪模块/节奏的权威执行；profile_missing → custom_style 为真则用本书文风继续，否则停止；`profile_degenerate` → 有本书文风就用，没有回默认；`tone_match_failed` → 只用整书文风。其余字段原样进 writer prompt，`gaps` 原值保留在写前准备记录里。
+- 主会话另行直接读 `设定/文风.md`：含实质内容时作为本书风格基准；但不豁免情绪/节奏缺失。

package/lib/oh-story/skills/story-long-write/references/anti-ai-writing.md

@@ -2,9 +2,9 @@
 
 > 本文件的句长、视角、标点、修辞与禁用词是默认写法，服从 [style-resolution.md](style-resolution.md) 的逐维裁决。所选 Gate 检查表达效果，不因作者有意选择某写法就机械删除；获准命中按书级 `.deslop-whitelist` 处理。
 
-<!-- 同名副本×5 字节同步，改动后跑 scripts/check-shared-files.sh -->
+<!-- 同名副本×4 字节同步，改动后跑 scripts/check-shared-files.sh -->
 
-> 识别AI写作指纹、系统性去AI三遍法、禁用词约束、改写范例库。用于正文写作后做去AI味自检和改写时查阅。
+> 识别AI写作指纹、改写顺序、禁用词约束、改写范例库。用于正文写作后做去AI味自检和改写时查阅。
 
 ---
 
@@ -15,7 +15,7 @@
 | 写完正文后做去AI自检 | 核心规则 -> AI写作模式检测 -> 质量维度检查 |
 | 改写某段AI味重的文字 | 改写范例库 + 冲突对话改写范例 |
 | 检查是否用了禁用词 | 禁用词与句式速查 -> AI高频词（模式1） |
-| 系统性去除整章AI味 | 系统性去AI三遍法 |
+| 系统性去除整章AI味 | 改写顺序 |
 | 检查章尾是否有总结升华 | AI写作指纹 -> 章末总结体 |
 | 判断情绪描写是否告知式 | Show Don't Tell原则 + 去AI味补充技法 |
 | 快速扫描全章质量 | 快速自检口诀 + 质量维度检查 |
@@ -285,7 +285,7 @@ AI 喜欢把事情凑成三个以显"完整"。-> 砍到只剩最有力的一条
 - 剧透式点破潜台词：「那点笑她看得分明」「谁都看得出他在撒谎」-> 把藏着的挑明了。留着别点破。
 - 定性比喻/盖棺句：「像在宣判一件早已定好的事」「像看一件死物」-> 比喻在替角色下定论。非角色此刻强烈主观感受就删；要留也只能是她带偏见的瞬间感觉，不是客观断言。
 
-自检：每句问一遍——这是"角色在经历"，还是"作者在讲解/安排"？凡作者跳出来讲，删，或改成角色视角内的呈现。根治办法是锁定深度限知视角（见 writing-craft.md「视角姿态：深度限知」），镜头钉死在角色身体里，作者就没位置跳出来了。
+自检：每句问一遍——这是"角色在经历"，还是"作者在讲解/安排"？凡作者跳出来讲，删，或改成角色视角内的呈现。根治办法是锁定深度限知视角：只写视角人物此刻看得见、听得见、想得到的，镜头钉死在角色身体里，作者就没位置跳出来了。
 
 改法优先级：先删或原位替换污染句，不在段尾另补“人味”尾巴。需要补信息时，把原来的总结/动机/评价句改成角色当下能碰到的问题、手续、回信、付款、门外动静等具体压力；已有手机/屏幕/公告/门牌/表单等信息，优先作为角色看见的场内载体保留，不要转写成叙述者解释。具体载体跟剧情走，不套固定清单。
 
@@ -372,9 +372,11 @@ AI 喜欢把事情凑成三个以显"完整"。-> 砍到只剩最有力的一条
 
 ---
 
-## 系统性去AI三遍法
+## 改写顺序（只排所选 Gate 的先后）
 
-### Pass 1：去泛化（Strip Generic）
+下面三步只决定所选 Gate 内问题的处理先后，不另起一轮全篇去味；某一步没有对应的所选 Gate 就跳过。
+
+### 第一步：去泛化（Strip Generic）
 - 抽象情绪总结句 -> 按规则 2 判断：删重复说明，保留准确直写，需要时用原文已有信息落地
 - 假深度句 -> 删
 - 意义膨胀 -> 缩小到具体影响
@@ -384,9 +386,9 @@ AI 喜欢把事情凑成三个以显"完整"。-> 砍到只剩最有力的一条
 - 过度使用"于是""然而""此刻" -> 删掉一半
 - 所有角色说话一样"高级" -> 区分语气
 
-**原则**：能删就删，不能删就用具体细节替换。这一遍去掉80%的AI味。
+**原则**：能删就删，不能删就用具体细节替换。
 
-### Pass 2：去书面化（Cut Professional Diction）
+### 第二步：去书面化（Cut Professional Diction）
 - 分析性用词（"机制""结构""逻辑""体系"出现在小说中）-> 换成日常表达
 - 抽象名词滥用 -> 直接说事
 - 体制内用语（"进一步""深入""推进""落实"）-> 删
@@ -394,7 +396,7 @@ AI 喜欢把事情凑成三个以显"完整"。-> 砍到只剩最有力的一条
 
 **例外**：保留专业感的场景（历史题材正式用语、文学向刻意密度、喜剧夸张修辞）。
 
-### Pass 3：回自然感（Restore Natural Presence）
+### 第三步：回自然感（Restore Natural Presence）
 - 具体的感官细节（气味、温度、触感）
 - 角色说话方式的区分（不同人不同语气）
 - 句首变化：连续 3+ 句用同一主语或同一词性开头时换开法（动作、场景、对话引入）
@@ -407,7 +409,7 @@ AI 喜欢把事情凑成三个以显"完整"。-> 砍到只剩最有力的一条
 
 ### 执行范围
 
-调用方指定 Gate 时，只处理选定 Gate；三遍法只安排顺序，不重新分级或扩大范围。未指定范围时，按实际问题选择适用检查。
+调用方指定 Gate 时，只处理选定 Gate；改写顺序只排先后，不重新分级或扩大范围。未指定范围时，按实际问题选择适用检查。
 
 ### 自检清单
 - 对话自然度检查：对话是否使用口语化表达，是否避免了书面语/正式腔调
@@ -551,5 +553,4 @@ AI 喜欢把事情凑成三个以显"完整"。-> 砍到只剩最有力的一条
 - [ ] **detector advisory 逐条复核**：`micro-action-tic` / `stock-reaction-tic` / `abstract-summary-tic` / `cliche-density-tic` / `metaphor-density-tic` / `reasoning-chain-tic` / `system-notice-formality-tic` / `overcompressed-prose-tic` / `low-connective-density-tic` / `action-list-tic` 命中时按脚本给出的修法处理：先通读判断是不是机械复现，确属再改；功能性写法保留或标 `[需复核]`，不做同义词轮换、不机械注水
 - [ ] **不做硬指标投机**：不为反检测强制每句换行、50-60 字一行、对话 50%-60%、英文点省略号，或把 `地/得` 全改成 `的`
 - [ ] **任务卡点服从原文边界**：抽象总结若改成角色办事被卡住，必须来自原文已有任务/证据/手续/物件缺口；不新增原文没有的事件链
-- [ ] **去AI三遍法执行**：轻度只做Pass1，中度做Pass1+2，重度完整三遍
 - [ ] **对话自然度测试**：无书面语痕迹 = 通过