@lemoncat7/dsh-partner 2.8.0 → 2.8.2

package/resources/skills/story-creation/upstream/skills/story-long-write/references/tracking-transaction.md

@@ -0,0 +1,146 @@
+# 追踪状态协议
+
+`追踪/` 使用“一个结构化权威状态 + 多个确定性派生视图”。模型只提交一份语义 JSON，不分别 `Write/Edit/echo >>` 多个追踪文件。
+
+## 权威层与派生层
+
+| 层级 | 文件 | 语义 |
+|---|---|---|
+| 唯一权威 | `_tracking-state.json` | schema、最后提交章、导入截止章、状态修订号、上下文结构、角色/伏笔/时间线，以及已提交章节的简短字数记录 |
+| 章节记录 | `逐章记录/第NNN章.md` | 本章对未来连续性有用的紧凑变化；目标 ≤1536 字节，硬上限 3072 字节；导入范围内修订写成覆盖记录 |
+| 派生视图 | `上下文.md`、`角色状态/{角色名}.md`、`伏笔.md`、`时间线/作者真相.md`、`时间线/读者已知.md` | 完全从 `_tracking-state.json` 生成；禁止手改，不作为程序输入 |
+
+Markdown 只负责给作者和 Agent 阅读，工具不再反向解析 Markdown。`check` 直接从 `_tracking-state.json` 重渲染并逐文件比较。未来“第几章揭示”的计划写在卷纲/细纲，不写成时间线既成事实。
+逐章记录只是便于人阅读的紧凑变化记录，不承诺单独无损重建全部当前状态；完整当前语义以 `_tracking-state.json` 为准。
+
+## 运行工具
+
+先按运行环境探测 Python 3 解释器（依次尝试 `python3`、`python`、`py -3`）。追踪事务脚本使用当前 skill 根目录；字数与章节闭环统一使用 `story-long-write` skill 根目录：
+
+```text
+{PYTHON} {当前 skill 根}/scripts/tracking_commit.py init   --project {书项目根} --input {书项目根}/.story/work/init.json
+{PYTHON} {当前 skill 根}/scripts/tracking_commit.py check  --project {书项目根}
+{PYTHON} {当前 skill 根}/scripts/tracking_commit.py draft  --project {书项目根} --chapter {N}
+{PYTHON} {story-long-write skill 根}/scripts/storyctl.py chapter check   --project {书项目根} --chapter {N} [--min-chars {下限} --max-chars {上限}]
+{PYTHON} {story-long-write skill 根}/scripts/storyctl.py chapter commit  --project {书项目根} --chapter {N} --input {书项目根}/.story/work/第{NNN}章/tracking.json
+{PYTHON} {story-long-write skill 根}/scripts/storyctl.py chapter accept-current-length --project {书项目根} --chapter {N} --input {书项目根}/.story/work/第{NNN}章/tracking.json
+```
+
+- `init`：只在 `_tracking-state.json` 不存在时执行，绝不覆盖已初始化项目。
+- `draft`：按当前 state 把逐章事务预填到 `.story/work/第NNN章/tracking.json`（修订号、模式、章名、`context` 四项当前值），并输出各文本字段的字数上限与在场核心角色的当前快照。新章（append）调用方只填 `delta` 与有变化角色的快照；已提交章（revision）的 `delta` 与相关角色快照按该章现有逐章记录预填（伏笔、时间线取当前值），调用方在上面改成修订后的完整记录，不清空重写。
+- 作者字数范围：细纲可写一行 `字数范围：2000-2600`（作者明确给了上下限时）；本轮临时给的范围用 `--min-chars` / `--max-chars`（两者同给，优先于细纲）。`wordcount check` / `checkpoint` 与 `chapter check` / `commit` / `accept-current-length` 都认，给了就同时替代默认 ±12% 内部带与 ±15% 用户带，结果里 `band_source` 为 `author`，提交的字数记录多一项 `author_range`。
+- `wordcount measure` / `wordcount checkpoint`：纯测量入口；不写正文、不写 tracking、不做语义判断。长篇正文只在前组写完后由主会话带 `--project` 调用一次 `checkpoint`（目标与字数范围读细纲，见 workflow-chapter 步骤 6），整章长度由 `chapter check` 收口；`remaining_user_range` 按生效区间（作者区间或默认用户带）计算。
+- `chapter check`：重新读取当前正文与细纲目标，返回确定性长度状态、现有 blocking quality、`state_revision` 和当前可执行动作，不保存 approval。顶层 `status`：`ready`（可提交，exit 0）/ `needs_decision`（长度带外，按 `available_actions` 交作者，exit 0）/ `blocked`（有 blocking 正文问题，exit 1）/ `invalid`（正文为空等，exit 1）/ `tool_unavailable`（找不到 node 或检测脚本，见 `quality.tool_errors`，不是正文问题，exit 3）。参数错误或文件缺失输出 `story-chapter-error/v1`（`status: error`，exit 2）。`under` 不提供自动补写；`over` 额外返回一次净删型 `compress-once` 及回到生效区间所需的删除字数。`quality.semantic_advisories` 是语义类 advisory 条数（检测器标 `review: mechanical` 的不计）。
+- `chapter commit`：再次读取当前文件、重新计数并重跑 blocking quality；只接受生效区间内的章节，把简短字数记录与逐章事务一起原子提交。新章与修订都走它。
+- `chapter accept-current-length`：只接受带外但 quality pass 的章节；接受动作发生时重新读取、重新计数并立即原子提交，不保存可陈旧的历史决议。低于字数目标一半（`BELOW_ACCEPT_FLOOR`），或超长却还没做过那一次压缩（`COMPRESSION_REQUIRED`），都拒绝；作者明确拍板时加 `--force`。
+- `check`：严格验证 state schema、逐章记录连续性/规范名/体积、固定 7 栏、角色快照硬上限、派生文件集合，以及所有派生视图与 state 的逐字一致性。
+
+每本书由 `追踪/.tracking-commit.lock` 串行写事务，`expected_state_revision` 再拒绝基于旧状态构造的 stale transaction。两个不同事务并发时至多一个修订成功。字数记录也在锁内对当前正文和目标重新验证，正文或目标变化会让预先构造的记录直接失败。
+
+事务 JSON 是临时输入，不是项目产物：只写在书目录 `.story/work/` 下（逐章事务放 `.story/work/第NNN章/tracking.json`），不写系统 `/tmp`、书根、`大纲/` 或 `正文/`；成功前必须保留，提交成功后即可删除（`storyctl.py chapter commit` / `accept-current-length` 成功时自动删除该章目录；直接调用 `tracking_commit.py commit` 时由调用方删除。已有字数记录的章节正文或目标改过后，`tracking_commit.py commit` 拒绝修订事务，须走 `storyctl.py chapter commit`）——之后 `check` 失败按下文提交 `mode=revision` 新事务修复，不需要原事务。若文件写入失败，`_tracking-state.json` 尚未推进；修正环境后直接重跑**同一份** `commit`。append 重跑只接受内容完全相同的既有逐章记录，不维护 `dirty/pending/repair` 状态机。
+
+校验失败与写入失败处理方式不同：校验失败（字段非法、退役结构、容量超限）要按报错改事务本身，重跑同一份结果不变。派生视图被手改或外部改动导致 `check` 报 `derived view differs from _tracking-state.json` 时，重新提交**该章**的 `mode=revision` 事务让工具整份重建，`expected_state_revision` 取 `追踪/_tracking-state.json` 的 `state_revision` 字段——`check` 失败时只往 stderr 打 ERROR，不输出 JSON；不手改派生文件，也不删 `_tracking-state.json` 重来。手写出的逐章记录会让同章 `append` 永久报 `chapter delta N already exists with different content`——删掉那个手写文件后重跑原事务即可。
+
+本工具不解析旧 `_tracking-meta.json`、`时间线/事件库.json` 或更早追踪结构，不提供语义兼容层。`init` 遇到这类旧文件时，先把它们按原样整体移入 `追踪/_旧追踪存档/`，再在原地建当前协议：旧内容留给作者查阅，不参与解析，当前状态完全以 init 输入为准。校验失败的 `init` 不移动任何文件。`commit` 与 `check` 仍直接拒绝旧结构——它们只在已建协议的项目上运行。
+
+## 初始化事务
+
+仅新书或导入初始化时，执行 `init` 前必须完整读取 [tracking-initialization.md](tracking-initialization.md)，按其中原始 JSON 与导入边界构造事务。已有项目续写直接使用下方逐章事务，不重复读初始化示例。
+
+调用方的逐章 JSON 不写 `wordcount`；正式入口 `chapter commit` 或 `chapter accept-current-length` 在提交当下生成并注入。最终 state 只为已提交章节保留 `metric / target / actual / status / resolution / body_sha256`（生效了作者字数范围时另加 `author_range`），不保存 MEASURE/RESOLVE 事件、ID 链、policy fingerprint 或独立 chapter state。
+
+## 逐章事务
+
+```json
+{
+  "schema_version": 1,
+  "mode": "append",
+  "chapter": 10,
+  "chapter_title": "专业团队拍得还不如他拍的好？",
+  "expected_state_revision": 9,
+  "delta": {
+    "result": "专业团队重拍的高清版在高层看片会上被判定缺了灵魂，张耀祖拍板继续采用江晨的手机原版。",
+    "character_changes": [
+      {"name": "江晨", "change": "作品价值获军内高层确认，从爆款新人升为不可替代的军宣创作者"}
+    ],
+    "foreshadow_changes": [
+      {
+        "action": "upsert",
+        "id": "F027",
+        "summary": "专业团队仍拍不出江晨原版的灵魂，继续验证其创作能力不可复制",
+        "planted_chapter": 10,
+        "planned_resolution_chapter": null,
+        "status": "已埋",
+        "importance": "中"
+      }
+    ],
+    "timeline_events": [
+      {
+        "action": "upsert",
+        "id": "E010",
+        "story_time": "实弹训练两天后",
+        "objective_fact": "文工团高层否决专业重拍版，决定沿用江晨手机拍摄的原版视频",
+        "reader_knowledge": "读者已看到周薄森指出专业版缺了灵魂，张耀祖当场拍板用回原版",
+        "reveal_status": "已揭示",
+        "reveal_chapter": 10,
+        "characters": ["江晨", "周薄森", "张耀祖"]
+      }
+    ],
+    "constraints": ["后续继续用作品落地效果和围观反应放大江晨的高光，不能只写系统奖励数字"],
+    "next_chapter_commitments": ["结算五天百万粉任务，并承接老兵主题的新任务"]
+  },
+  "context": {
+    "position": {
+      "volume": "第一卷·军宣整顿",
+      "volume_start_chapter": 1,
+      "story_time": "实弹训练两天后",
+      "scene": "火箭军文工团高层看片会"
+    },
+    "long_term_constraints": ["军宣爽点要用作品效果和围观反应链兑现，不能只靠系统播报"],
+    "active_character_names": ["江晨"],
+    "continuity_risks": ["钟嘉嘉说江晨只猜对一半，未公开的培养安排不能被当成读者已知事实"]
+  },
+  "character_snapshots": {
+    "江晨": {
+      "identity": "火箭军文工团宣传兵；军宣爆款创作者",
+      "location": "火箭军文工团高层看片会",
+      "goal": "完成五天百万粉任务，持续做出真正能打的军宣内容",
+      "state": "专业团队反向验证原版价值，军内认可继续抬升",
+      "abilities_resources": ["前世MCN爆款运营经验", "《中国军魂》伴奏", "大师级导演能力"],
+      "relationships": ["钟嘉嘉持续提供军报资源", "周薄森和张耀祖已明确认可其创作能力"],
+      "knowledge": ["《军报》采访稿已经过审", "原版视频将继续作为正式军宣内容"],
+      "open_threads": ["五天百万粉任务尚未结算", "钟嘉嘉所谓只猜对一半仍未解释"]
+    }
+  }
+}
+```
+
+约束：
+
+- 构造事务前运行 `check`，把当前 `state_revision` 原样写入 `expected_state_revision`；若状态已经变化，重新读取 state 并重构事务。
+- `context` 的允许字段随子命令不同：`init` 收 `position`、`long_term_constraints`、`active_character_names`、`continuity_risks`、`recent_chapters`、`next_chapter_commitments` 六项；`commit` 只收前四项。`recent_chapters` 与 `next_chapter_commitments` 在 commit 时由工具从当前视图和本章 `delta` 派生，手填会在任何写入前被拒（`context contains unsupported fields: ...`，exit 2）。照 init 示例套 commit 事务是最容易踩的一处。
+- `character_snapshots` 中出现的角色视为核心复用角色，必须同时出现在 `character_changes`；已经建立快照的核心角色再次变化时必须提交新快照。
+- 角色快照的四个列表不限制条数，只限制单项长度和最终文件总字节：目标 ≤4096 字节，超过警告；硬上限 8192 字节，超过则在任何写入前拒绝。
+- 没有快照的角色变化视为临时角色，不建立状态文件；`context.active_character_names` 最多 6 人且必须已有当前快照。
+- `context.long_term_constraints` 最多 6 条：要加第 7 条先合并语义重叠项或请作者取舍，不自动删旧约束；永久生效的设定裁定进它，短期强承诺进 `next_chapter_commitments`，过程决策不进续写状态卡。
+- `context.long_term_constraints` 和 `context.continuity_risks` 是整份提交的当前值。凡是上一版有、本次没有的条目，必须逐条列进 `delta.retired_context_items`，否则工具在任何写入前拒绝——漏写不会被当成删除。实际退役的条目由工具写进本章逐章记录的 `## 本章退役登记`，随后仍可回查。
+- 不再复用的核心角色写进 `delta.retired_characters`：工具删除其当前快照与 `角色状态/{角色名}.md`，并在逐章记录留档。同一事务里不能既退役又提交快照，也不能退役仍列在 `context.active_character_names` 的角色。角色阵亡/退场这一章，把变化照写进 `character_changes` 即可，本章退役的角色不必再交一份马上要删的快照，逐章记录仍按核心角色标注。退役只表示不再进入热上下文，正文与逐章记录不受影响。
+- 两类退役都只能在 `mode=append` 提交。退役表示「从此刻起离开当前状态」，而修订事务的逐章记录属于被改写的旧章，落在那里会谎报退役发生的章节；`mode=revision` 必须原样重交当前全部上下文条目，需要退役就放到下一次 append。
+- `伏笔.md` 只呈现已经埋设过的当前状态。未来规划仍留在大纲。
+- `timeline_events.action` 可为 `upsert/delete`。`未揭示` 的 `reveal_chapter` 必须为 `null`；部分/完全揭示只能填写已经发生的实际章节。
+- `mode=revision` 时，逐章记录必须重算为修订后该章仍然成立的完整连续性记录（用 `draft` 预填的草稿改，漏写的项会从记录里消失，工具在 stderr 警告被清空的栏目；原有的退役登记原样保留）；当前角色、伏笔、时间线和上下文则提交受影响对象截至最新已写章的当前值。
+- 修订导入截止章内的正文时，会新增或覆盖该章的逐章记录；`imported_through_chapter` 不变。
+
+## 续写状态卡固定格式
+
+`上下文.md` ≤12288 字节，由 state 整份生成，只含以下 7 个顶层区块：
+
+1. `## 当前位置`
+2. `## 长期约束`
+3. `## 核心角色状态`
+4. `## 活跃伏笔`
+5. `## 近三章速记`
+6. `## 下一章承诺`
+7. `## 连贯性风险`
+
+其中活跃角色最多 6 人、活跃伏笔确定性选取最多 8 条、近章只保留 3 章。这些是下一章热上下文容量，不是完整角色状态的容量限制。

package/resources/skills/story-creation/upstream/skills/story-long-write/references/workflow-chapter.md

@@ -0,0 +1,104 @@
+# workflow-chapter.md：单章正文工作流（Phase 4-5）
+
+每章正文走本文件（日更批次见 `workflow-daily.md`）。**缺文件就停下修，本轮不写**：`tracking_commit.py check` 不过、缺 `_tracking-state.json`、登记了对标却缺情绪模块／节奏时，读 [stop-and-fix.md](stop-and-fix.md) 照做（作者定了不对标不算缺，组装脚本会报「召回降档：成立，无对标」，照它走）；修好再从步骤 1 开始。
+
+**工作目录**：本章临时文件（前组.md、后组.md、writer_prompt.md、tracking.json）只放书目录下 `.story/work/第NNN章/`，不写系统 `/tmp`、`正文/`、`大纲/` 或书根；提交成功后脚本自动删除。
+
+---
+
+## 单章写作流程
+
+新书还没有 `_tracking-state.json` 时先按 [tracking-initialization.md](tracking-initialization.md) 初始化；已有正文却缺它，按 stop-and-fix 停下修。
+
+1. **检查细纲**：读 `大纲/细纲_第{N}章.md` 全文，取「单元ID/位置」，跑 `outline_view.py --unit {单元ID} {卷纲路径}` 取卷契约、全卷常任裁定、当前剧情单元与终局底牌边界（日更同单元本批复用，不重跑）——**不整读卷纲**。细纲缺失或缺九个必填字段时**先补建再写**：按 workflow-outline.md 细纲模板补齐九个必填字段和四个小节，无证据的写 `[待补充]`，补完跑 `check-outline-contract.js` 验收。
+2. **读取上下文**：`tracking_commit.py check`（取 `last_committed_chapter` / `state_revision`，完整 state 不进 prompt）→ `追踪/上下文.md` 全 7 栏 → 细纲点名的 `设定/势力/`、`设定/世界观/` 相关条目（为「必读设定」槽摘句）；角色卡交给写手时只在「涉及角色」列名字、由写手读，主会话自己写时才读。上一章结尾由脚本代读，承接存疑才自己读。久别角色读 `追踪/角色状态/{名}.md`；更旧的信息按 workflow-daily「旧信息查找步骤」定点查。
+3. **写前准备**：
+   - **先跑组装脚本**：`{PYTHON} {skill 根}/scripts/build_writer_prompt.py --project {项目根} --chapter {N} --out`。`====` 以上是 prompt、以下是核对报告；退出码 2 ＝数据问题，修完重跑，不手拼绕过。
+   - **状态筛选**：从续写状态卡取本章在场角色、要碰/要避的伏笔、必须履行的下一章承诺与相关长期约束，写成本节速记。
+   - **召回**：核对报告写「召回降档：成立」时直接用脚本给的情绪/节奏；不成立时才完整读取 [benchmark-recall.md](benchmark-recall.md) 执行全量召回。
+   - **意图确认**：一句话写清本章意图（例：「快节奏打脸——账单暴露→逼问→反证→公开代价」）。对照：细纲是唯一剧情蓝图，新增物按「新增物三级」；底牌不因章尾钩子提前泄露；细纲重复的同一要求只兑现一次；爽点前有可指认的铺垫，打脸/揭露章写在场配角的差异反应。
+   - **契约风险**：细纲或单元卡标了需补强，把单元卡写的补强办法（交换、铺垫或成本）写进本章意图；标了契约破坏，先按 workflow-outline 补纲流程修纲再写；标契约安全的写前不重问，写后在步骤 9 核。
+4. **资料研究**（按需）：需查证外部事实时 spawn story-researcher 输出到 `参考资料/`，不可用则主会话查。
+5. **标题预检**：看核对报告的重名结论；重名或明显重复才按核心事件改名，并同步细纲标题与正文文件名。
+6. **写作准备**：交给写手时按 [agent-calls.md](agent-calls.md)「写一章」分前后两组交付；主会话自己写时也分两组：前组写到 `前组.md` 后跑一次 `storyctl.py wordcount checkpoint --file {前组} --project {项目根} --chapter {N}`，后组按 `remaining_user_range` 收、原文拼接；作者要一次成文才写全章。批准内容写完即停，不为字数加剧情；实际长度由步骤 8 收口。
+7. **正文执行**：已部署 narrative-writer 时按 [agent-calls.md](agent-calls.md)「写一章」填槽交给它，交付后核对它只消费了批准情节点。未部署则主会话自己写：不填槽，按脚本输出与本节速记直接写，新增物自列申报表。写完逐段再看一遍检测器抓不住的三类 AI 腔：用工整对仗或金句替读者点题；叙述者跳出来总结情绪、解释动机、说出细纲的结论；章尾用感悟、升华或预告收。遇到就删，或改成人物的动作、对话、物件，让读者自己看出来。
+8. **核情节点落点，再一次检测收口**：
+   - 细纲每个情节点**至少出现一次**，漏即退回补写批准内容。不以字数为由。
+   - 运行 `{PYTHON} {skill 根}/scripts/storyctl.py chapter check --project {项目根} --chapter {N} --fix-punctuation`：一次整理标点并跑 AI 句式、`check-degeneration.js` 退化、细纲照搬与字数检测（去味管线：检测器 → 选 Gate → 一次定点改写 → 复扫）；文件改动后重跑，不再分别调各检测脚本。
+   - 按返回的 `status` 走：`ready` → 完成步骤 9-12 再提交。`blocked` / `invalid`（退出码 1）→ 就地修净再重跑。`needs_decision`（字数出带）→ 看 `available_actions`：欠字不补不重试，按字数问法请作者选；超字把删除区间随 `compress-once` 交 narrative-writer 一次净删、零新语义，复检仍带外也请作者选。`tool_unavailable`（退出码 3，见 `quality.tool_errors`）→ 不能提交、无绕过，用停下问法告诉作者要装 Node.js 18+ 才能做写后检查。退出码 2（`status: error`）按 `error_code` 修命令。
+9. **检查钩子、爽点与契约**：章尾有往下看的理由（低压/过场章留阶段目标即可）；高压/推进章爽点到位；对着成稿过契约四问——主角是否靠自己的选择挣到本章结果？收益是否被配角、机构或巧合无交换地拿走？有没有提前动用后面的底牌？旧期待付利息、留新期待了吗？任一问不过就按问改：没挣到→让结果落在他的选择或判断上；收益被拿走→补交换或让他拿回控制点；提前用了底牌→换成本卷已解锁的手段；没付利息→给旧期待一个小兑现再留新钩。不达标只修批准内容，修后重跑步骤 8；需补强、契约破坏都在本章汇报里告诉作者。
+10. **元信息扫描**：标题行以外清掉第X章、上一章、本章、前文、后文、伏笔、细纲、读者这类工程词，改成角色能感知的事件锚点（「比第一章那三秒开火更疼」→「比那三秒开火更疼」）；角色真实读到「第X章」或本身是作者/读者的除外。
+11. **检测结果处理**（选 Gate 与定点改写）：严重度读作必须修 / 建议看 / 仅提示——检测器 blocking 与 checker 的 S1/S2 必须修，advisory 与 S3 建议看，S4 仅提示。`quality.blocking_findings` 就地改到净；`advisories` 逐条读原文判断，确属问题才改，不为归零机械改写。`formulaic-parallelism` 连同台词一起复核；细纲照搬里判定保留的补进细纲「复沓锚句」（这是登记，不算改大纲，不用暂停问作者）。禁用词表不整读，拿不准的二级词才查 `references/banned-words.md` 对应条目。改完只重跑步骤 8 复扫，不另安排全篇去味。
+12. **更新追踪**：运行 `{PYTHON} {skill 根}/scripts/tracking_commit.py draft --project {项目根} --chapter {N}`，预填工作目录 `tracking.json`，并给出在场核心角色的当前快照和每类条目的样板（`shapes`）。只填 `delta` 与留空的本章结尾时间、场景：变化的核心角色（含本章首次进场的核心角色，草稿里没有就新建一份）把快照整份改好放进 `character_snapshots`；撤下的长期约束或风险从 `context` 删掉并把原文列进 `delta.retired_context_items`。不读脚本源码或 state 找格式；出错或 `mode=revision` 时才读 [tracking-transaction.md](tracking-transaction.md)。带内执行 `{PYTHON} {skill 根}/scripts/storyctl.py chapter commit --project {项目根} --chapter {N} --input {工作目录}/tracking.json`，作者接受当前长度把 `commit` 换成 `accept-current-length`。报错按提示改完重跑同一命令；体积超目标只是提醒，逐章记录写要点即可，不必为它删改。判为「登记」的申报项在这次事务里一并登记；有「先问作者」项时暂停提交与下一章。「本章没写成的」：细纲没给的追加进本单元排纲底稿「建纲追加」，先问作者的走下方处置表。
+13. **提交后核对**：返回 `tracking_committed: true` 即本章完成。
+
+## 向作者汇报
+
+按 SKILL.md「面向作者的汇报」，下列时机照模板说；`{}` 换成故事里的话，其余内部结论不说给作者。提交成功、本章完成后（日更批量改用 workflow-daily 批末汇报）：
+
+<!-- author-report -->
+```md
+第{N}章《{章名}》写好了，约 {字数} 字。
+这章：{两三句讲发生了什么，停在哪个钩子上}。
+{有需作者留意的新人物/新设定就一句话，如「加了个跑腿的小厮阿福，后面可能还会用」；没有就删掉此行}
+{这章主角的功劳被别人拿走、或提前用了后面的底牌时，一句话说哪里、怎么补或要不要改纲；没有就删掉此行}
+{自查结论一句话：「自查过设定和前文，没发现冲突」或「发现一处前后不一：{什么}，已按前文改正」}
+下一章：第{N+1}章《{章名}》，要接着写吗？
+```
+
+字数一次处理后仍不在范围内时，请作者选，不自行补写：
+
+<!-- author-report -->
+```md
+第{N}章《{章名}》写完了，比目标{少/多}了约 {差额} 字（目标约 {目标} 字，现在 {实际} 字）。{一句原因，如「细纲的事写完就到这儿了，硬凑会注水」}
+你想怎么处理？
+1. 就按现在的长度收下（推荐）
+2. 我改细纲或字数目标，再重写这章
+3. 这章不要了
+```
+
+不到目标一半时选项 1 不标推荐。作者选 1 → `chapter accept-current-length`；选 2 → 等作者改完细纲/目标后回步骤 8；选 3 → 删本章正文与工作目录，不提交。收下被拒时：`BELOW_ACCEPT_FLOOR` 告诉作者差多少字，问补写还是就要这个长度；`COMPRESSION_REQUIRED` 先按 `compress-once` 删一次。作者知道原因仍坚持才加 `--force`。新增内容需要作者拍板（下方处置表「先问作者」）时：
+
+<!-- author-report -->
+```md
+第{N}章{写的时候多出了一样东西 / 写到一半想加一样东西，还没写}，需要你定：{用故事话说是什么}。
+它会牵动{后面哪段剧情或哪个已定安排，如「原定第三卷才揭开的那封信」}。
+1. {留下 / 加上}，我把后面的大纲一起改过来
+2. {删掉 / 不加}，按原细纲写
+我建议选 {1/2}：{一句理由}。
+这章先不算写完，等你定了再往下。
+```
+
+写不下去、要停下时：
+
+<!-- author-report -->
+```md
+第{N}章还没法写：{白话说缺什么，如「这一章还没有细纲」}。
+建议{一个动作，如「我先按卷纲把这章细纲补出来给你看」}，可以吗？
+```
+
+## 质量检查
+
+字数范围按 SKILL.md 写前必读第 4 条。三个维度：**情绪交付**（交付了目标情绪吗）、**契约风险**（步骤 9 契约四问）、**技术质量**（一致性、格式、禁用词；排查具体问题时才读 [long-chapter-quality.md](long-chapter-quality.md)）。
+
+**写后同轮清零**：同一轮内完成步骤 8-11，blocking（含写后 hook 推回的毒句式）清零才算本章完成。**唯一豁免**：用户显式说"本章不去味/跳过检查"时，在该章标题行下加一行 `<!-- 去味:跳过 -->`（写后 hook 与下一章前的欠账拦截都认它）。退化类 blocking（复读、截断、拒绝语、工程词泄漏）只重写受影响段落，最多 2 次，仍失败按停下问法请作者定夺；故事内系统用语、弹幕、有功能的重复台词保留。
+
+### Agent 调用：consistency-checker
+
+**按需调用**：写手申报表非 `0`，或核对细纲时发现未申报的跨章事实（新证词、证据、承诺、关系变化）才在本章 spawn；否则日更批末核对时整批查一次（workflow-daily Step 3），非日更的单章写作在步骤 12 提交前对本章查一次。Prompt 见 [agent-calls.md](agent-calls.md)。不可用则主会话自己核：申报项与跨章事实是否与细纲、角色卡、已登记追踪冲突；承诺与伏笔有没有被遗忘或无推进；有没有突然塞进大量新设定。
+
+**新增物处置（主会话）**（正文定稿、追踪未提交时做）。checker 只给事实证据，归哪一栏由主会话判：
+
+| 处置 | 判据 | 出口 |
+|---|---|---|
+| **登记** | 无必须修的冲突，也不属先问作者项 | 角色/势力按 workflow-outline.md「细纲后设定补全」补建静态档案、可复用设定补进 `设定/世界观/{主题}.md`，由主会话直接改设定文件（追踪事务不写设定）；伏笔、关系、约束、下章承诺进步骤 12 事务的对应 delta 字段 |
+| **修复** | 有必须修的冲突 | 退回写手就地改正文或删掉该新增物，最多一次 |
+| **先问作者** | 先问作者项（SKILL.md「新增物三级」），或冲突要靠创作决策；「本章没写成的」里标先问作者的也走这行 | 按拍板问法问作者（已写的问留不留，没写的问「还没写，要不要加」）；本章暂停提交及下一章。作者接受则按授权改卷纲/设定（没写的补写）后提交，不接受则删改后提交 |
+
+申报为 `0` 仍做正文与细纲的正常核对，发现漏报照本表处置。
+
+### Agent 调用：narrative-writer（去AI味审查）
+
+**按需调用**：步骤 8 的 `quality.semantic_advisories`（语义类 advisory 条数）≥3，或 blocking 一次就地修改后仍未清零，才 spawn 一次；否则主会话按步骤 11 处理。Prompt 见 [agent-calls.md](agent-calls.md)。不可用（主会话自己写）时不读去味细则：逐条按检测器那条提示改，先判能否直接删（删后不丢伏笔、钩子、角色、情节和必要信息就删），会丢才改写；blocking 改到净，advisory 确属问题才改。语义提示仍多时照常收口，在汇报里建议作者之后另开对话用 `/story-deslop` 精修。
+
+审查在本章提交前改的连续性事实直接进步骤 12 的事务；提交后再改，按 workflow-revision：`draft --chapter {N}` 预填 → 改 → `chapter commit`。

package/resources/skills/story-creation/upstream/skills/story-long-write/references/workflow-daily.md

@@ -0,0 +1,75 @@
+# workflow-daily.md：日更续写工作流
+
+SKILL.md 路由到「日更续写」后按本文件控制批次；每章正文走 [workflow-chapter.md](workflow-chapter.md)，缺文件按它开头停下修，召回降档不成立才读 [benchmark-recall.md](benchmark-recall.md)。适用于已有正文与追踪、作者明确要日更/续写/写第 N-M 章的项目；裸调用、只规划或只改细纲不进本流程。
+
+---
+
+## Step 1：快速上下文加载
+
+运行 `tracking_commit.py check`，取 `last_committed_chapter + 1` 作本批首章 N、`state_revision` 作修订号，并核对 `追踪/上下文.md` 的当前位置；章号不一致先修，不扫描正文猜编号。每章要读的上下文按 workflow-chapter 步骤 2；`追踪/伏笔.md`、`时间线/`、`逐章记录/` 默认不整读，缺旧信息按下方「旧信息查找步骤」定点查。
+
+`追踪/上下文.md` 是续写状态卡（7 栏，由 `tracking_commit.py` 派生，禁止手改）；schema、修订与修复见 [tracking-transaction.md](tracking-transaction.md)，出错时才读。
+
+**缺 state 或视图不一致**：停下，按 [stop-and-fix.md](stop-and-fix.md) 修好再开始。
+
+确定范围后直接进 Step 2，不问"是否继续"；K 默认 2-3 章，作者另给按作者（单轮最多 3 章）。只在章号冲突、细纲缺失、范围超出已有细纲、要改大纲/追踪时暂停确认。
+
+---
+
+## Step 2：串行批量写作
+
+**必须在主会话内串行逐章写**，不把多章并发交给多个子代理（追踪会互相覆盖）。"继续/续写/日更"不逐章重复确认；到达本轮 K（最多 3 章）后必须进入 Step 3/4 收尾并停止，不因还有细纲续写下一批。
+
+1. **读取写作计划**：按 卷契约 → 当前剧情单元 → 章节细纲 确定；`outline_view.py --unit {单元ID}` 取一次卷级与单元级内容，本批复用，不整读卷纲。写前明确本批推进目标、可释放与严禁提前释放的信息、章尾钩子不能越过的边界，别动用本阶段还不该解锁的终局底牌。批写完检查是否超前、拖慢或偏离阶段节奏（细节适配不算；已改变卷契约、单元承诺、推进线或兑现归属的，修正文或重规划后续细纲）：下一章要补偿的进 `next_chapter_commitments`，跨章风险进 `continuity_risks`，不靠提前泄露后期信息提速。
+2. **逐章执行**：每章按 workflow-chapter「单章写作流程」步骤 1-13 走完，叠加：
+   - **上一章欠账**：写本章前上一章不得有未清 blocking 毒句式（写前 hook 会拦；hook 不可用时对上一章跑一次 `chapter check`），标了 `<!-- 去味:跳过 -->` 的除外。
+   - **状态来源**：不把完整 `_tracking-state.json` 读进上下文，缺的信息定点查，不用来源不明的聊天记忆替代。久别核心角色读 `追踪/角色状态/{名}.md`，重新活跃后放进本章事务的 `context.active_character_names`。
+   - **本章技法**：主会话自己写时一批只读一份（选法见 SKILL.md「本章技法」），交给写手时每章照填类别。
+   - **用 story-explorer 召回时**：`gaps` 按 [agent-calls.md](agent-calls.md)「story-explorer：写前对标召回」分流。
+   - **写后清零不拖到批末**：hook 推回的命中当轮清零。
+   - **每章写完立即提交追踪**：按 workflow-chapter 步骤 12，提交成功才进下一章；只记会影响后续章节的变化，过程日志、质检计数、去味统计不进事务。narrative-writer 不写 `追踪/`。
+3. **不中断但不并发**：追踪已提交即进下一章；字数出带（欠字，或一次压缩后仍超），按 workflow-chapter 的字数问法请作者选，不静默推进。
+
+### 旧信息查找步骤
+
+续写状态卡没有、但本章确实需要的旧信息，由近到远查，查到就停：
+
+1. **定点读追踪**：伏笔 `grep -n "F007" 追踪/伏笔.md`；角色读 `追踪/角色状态/{名}.md`；读者认知读 `时间线/读者已知.md`，作者真相读 `时间线/作者真相.md`。
+2. **查变化原因或历史**：调 story-explorer 的 `foreshadow_status / character_status / timeline`（不可用则 `grep -R -n --include='第*.md' "F007" 追踪/逐章记录/ | tail -5`，只取最近 5 条）。
+3. **读一个原文件**：对应逐章记录或埋设章正文，只读 1 个。全量读属 `/story-review` 或作者要求的全面审计，日更不做。
+
+单章第 2 级超过 3 次，说明细纲没写清要消费哪些旧信息：一次性让 story-explorer 查多项，并在日更批末汇报里提示细纲需补清回收项。
+
+---
+
+## Step 3：日更批末核对
+
+逐章检查已在 Step 2 完成，这里只做**跨章**核对：
+
+1. **标题去重**：本轮新写章与既有标题同名或明显重复时，统一改细纲与正文文件名。
+2. **契约与细纲双向核对**：逐章已在 workflow-chapter 步骤 9 过契约四问，这里只看跨章：几章连起来，主角的功劳、底牌和旧期待有没有累积失衡（有问题按 workflow-chapter 步骤 9 的改法修；需补强、契约破坏写进批末汇报）；正文是否消费了细纲的内容概括、情节安排、人物关系变化与收益归属；爽点前有可指认的铺垫、打脸/揭露章写了在场配角差异反应、详略按目的分配而非均匀注水。不达标回 Step 2 修批准内容。
+3. **伏笔盘点（仅本轮增量）**：本批新增/推进/回收的每个 ID 在 `追踪/伏笔.md` 恰好一行当前状态，并能在对应逐章记录找到本次变化；不做全量伏笔审计。
+4. **一致性检查（整批一次）**：各章都没单独查过时，这里查一次本批全部章节（prompt 见 agent-calls.md，申报栏写各章申报汇总；无 agent 时主会话按 workflow-chapter 同节自己核），冲突照「新增物处置」表处理。
+
+只对本步改过的章重跑 `chapter check --fix-punctuation`；改动影响后续事实、状态、伏笔或承诺的，进 Step 4 前按 workflow-revision 为该章提交修订（`draft` 预填 → 改 → `chapter commit`），纯措辞调整不重复提交。
+
+---
+
+## Step 4：批末收尾
+
+**本步不再写追踪内容**，只做：
+
+1. `tracking_commit.py check` 通过，本批每章都有逐章记录；缺失或超限回到该章事务修正重跑，不手补文件。
+2. **「本章没写成的」汇集**：各章申报表末行只分两路——「细纲没给」追加进排纲底稿「建纲追加」，涉及既有设定的先查设定、有既定值补进下一章 prompt；「先问作者」并入 workflow-chapter「新增物处置（主会话）」表的「先问作者」一行。连同排纲底稿里「先问作者」尚未裁定的条目，一并随批末汇报给出；全部为 `0` 记「无」。
+
+然后按 SKILL.md「面向作者的汇报」口头汇报，不另存文件；内部核对翻成故事话再说：
+
+<!-- author-report -->
+```md
+这次写了 {K} 章，共约 {总字数} 字：
+- 第{N}章《{章名}》：{一句发生了什么}
+- 第{N+1}章《{章名}》：{一句发生了什么}
+{偏离原计划的就一句话说偏在哪、打算怎么接，如「阿福比计划早露面一章，后面照常」；主角功劳被人拿走、提前用了后面的底牌也在这里说；没有就删掉此行}
+{要作者定的事：一句问题＋白话选项＋推荐，如「沈栀要不要在下一章就知道信的下落？1. 先瞒着（推荐）2. 这章就告诉她」；没有就删掉此行}
+下一批：第{M}到第{M+2}章，{细纲已备好 / 需要先补细纲}。接着写吗？{写到卷末时改问：「这一卷写完了，要开新卷吗？」}
+```

package/resources/skills/story-creation/upstream/skills/story-long-write/references/workflow-outline.md

@@ -0,0 +1,157 @@
+# workflow-outline.md：出细纲（按剧情批出细纲、补纲）
+
+作者要看一批章节怎么走、或要补/改细纲时读本文件。卷纲只用 `outline_view.py --unit {单元ID}` 取本单元闭包，设定从 `设定/` 定点读，不回翻对话；前 3 章细纲另读 [opening-design.md](opening-design.md)，建角色档案时读 character-basics.md。没有子代理时先给本批走向提案、作者确认后落盘；交付汇报最后一句建议新开对话说「写第N章」，技术备注在它后面。
+
+所请求范围内每章必须有 `大纲/细纲_第XXX章.md`，不跳章。
+
+细纲按剧情批构建（见文末「按剧情批出细纲」）；仅未限定范围的完整开书默认前 10 章，其他按 SKILL.md 的范围与停点交付：
+1. **批次边界**：未指定章数时，一批 ≈ 一个剧情单元（5-15 章）；>10 章拆两批。开书首批前 10 章封顶、可跨单元；每单元建卡时召回一次，后续批共享结论。用户指定章数/范围时，只建范围内细纲，不因单元未完或剩余 ≤2 章而扩批；单批仍建议 ≤10 章。日更缺纲按 workflow-daily 的补建流程处理。
+2. **批次定位与阶段约束**（每批补纲前先写）：当前章节区间属于哪个阶段与哪个剧情单元（单元ID）、本批推进目标、本批可释放信息、本批严禁提前释放信息、章尾钩子不能越过的边界。
+3. **供给自查**（排纲自查第 5 项）：每批出细纲前检查六项：①对手戏由谁承接？具名对手间隔超过 2 章是复核提示；对手可为盟友或亲人，环境、关系章不为凑间隔新增反派。②未来 3 章出场角色的设定卡是否齐全？③能力增量与既有库存是否接得上？④本批引用的数字、制度、规矩、距离与脚程是否确实存在？引用前 grep 核对文件里的具体条目，不能只猜文件存在。⑤本批使用的地点空间属性先落档；仅提名不强补底图。是否与上一单元同场景、同对手、同胜负手连排，需要调整？⑥本批有哪些故事线推进，是否有可调存量？结果以「供给自查」小节写进 `大纲/排纲底稿_{单元ID}.md`（模板见文末，不写进卷纲）：「写了要报」登记新增内容与设定路径，「先问作者」列候选及影响面交作者裁定；无缺口写「无缺口」。并检查上一批「本章没写成的」与「建纲追加」里的未解决缺口。
+4. **剧情单元消费**：建卡批读本批剧情单元卡「对标剧情参照」指向的剧情单元（≤3 个文件，含结构分布/情节点索引），按单元节拍→章映射铺章、情节点换素材；同一剧情单元的后续批共享剧情单元卡固化结论，不重读剧情单元。当前卷纲缺少必需剧情单元字段时先补齐卷纲，不带缺失字段进入日更。
+5. **建纲当场缺口**：按下方三级处置——直接写的写进细纲，写了要报的先落档再引用，先问作者的挂起受影响内容，其余部分继续。建纲批末把后两级汇入同一份排纲底稿的「建纲追加」小节：章号、缺口、级别、设定路径或提案；无追加写「无」。不重复记录直接写的现场材料。
+6. **建纲批末复核**（每批建完必做）：确认 `visible_chars_v1` 口径、九个必填字段、禁止提前释放和可执行情节点齐全。不得用“每个情节点固定等于多少字”预测容量或自动补事件；每章细纲落盘后必须跑 `node scripts/check-outline-contract.js --json --project {书目录} --chapter {N}`：exit 1 只按 `repair_scope` 补点名字段再复验，最多两轮；advisory 项逐条人工判断，不强制归零。建纲批末另跑一次 `node scripts/check-outline-contract.js --json --supply {卷纲路径} {单元ID}` 验证本批供给自查已写进排纲底稿（含「无缺口」情形）；脚本仅验供给小节存在，内容仍需人工判断。**旧章细纲缺字段是常态，不要照抄同目录既有文件的字段集**，以本节模板为准。语义仍不设 checker。
+
+不强行一次产出 30 章细纲；全书 ≤30 章且用户明确要全书细纲时，可分批连续交付。
+
+#### 细纲模板与验收
+
+细纲是正文写作的章节蓝图，而不是只列事件和钩子的清单。模板见下（唯一权威副本：九个必填字段、四个小节、不含逐点字数的四列情节点表，阶段位置、结构公式等在末尾「可选」块）。新建、补建、回填都按权威模板补齐，未知字段写 `[待补充]`，不为补齐字段杜撰副线或人物关系。
+
+`目标情绪` 与 `主角目标/关键选择` 要写实际内容，不能留 `[待补充]`：隔离实验里只补这两个字段就能复现补齐全部字段的正文收益，补满其余字段与只补这两个不可区分。其余字段未知时仍按上文写 `[待补充]`。
+
+落盘后运行 `node scripts/check-outline-contract.js --json --project {书目录} --chapter {N}` 做结构检查：它只判字段、四个小节、五段式、情节点表结构（默认四列 `# / 情节点 / 功能标签 / 执行边界（禁＋放）`；需要时可在功能标签后加「分辨率」列）和字数目标口径是否在场，不判内容好坏。exit 1 时只按 `repair_scope` 补报告点名的字段并复验，最多两轮；仍失败就报告检查 ID 停下，不改其他章。exit 2、脚本缺失或 node 不可用时如实报告验收未完成，不得声称细纲已合规。本检查只在新建/补建/回填时执行；既有项目的旧细纲不因此阻断写正文。
+
+```
+## 细纲（第 N 章）
+
+### 第 N 章：{章名}
+- 核心事件：{一句话；供日更与导入统一消费}
+- 字数目标：{X} 字
+- 字数口径：visible_chars_v1
+- 单元ID/位置：{卷纲剧情单元ID；单元内第几拍/承担功能}
+- 目标情绪：{具体情绪前状态→后状态；本章推进单元情绪引擎的哪一环；不得只写“热血/悲伤”等标签}
+- 主角目标/关键选择：{主角本章要什么；必须做出的判断或选择}
+- 章首钩子：{从章首7式中选择} — {具体内容；低压/过场章可写“弱钩子/仅情绪钩子，功能是…”}
+- 爽点：{本章爽点；低压/修炼/过场章可写“无显性爽点，功能是…”，但仍须给读者一个往下看的理由}
+- 本章禁止提前释放：{**只写本章特有的三五条**；卷级常任禁忌已在卷纲「本卷禁碰的终局底牌」，不逐章复读；没有就写“无”}
+
+#### 内容概括（五段式）
+- 起因：{本章事件为什么发生}
+- 发展：{冲突如何推进}
+- 转折：{信息/关系/局势哪里改变}
+- 高潮：{本章情绪或动作峰值}
+- 结尾：{本章最后落在谁的什么动作/画面/台词上——写具体落点，不写"尘埃落定""一切结束"式状态判词}
+
+#### 情节安排（多线）
+- 主线推进：{本章对主目标的推进}
+- 辅线推进：{指向卷纲「本卷故事线」的 L 编号（L01 式两位数，不是单元ID L1-03），写“L0X 从哪一步推到哪一步”；本章确无非主线在动时写“无”，不凭空制造。一批细纲不许每章都是“无”}
+- 事件线 / 任务线：{外部事件链；有“办事被卡住”时写清卡出什么变化，删掉无损的卡点不进细纲}
+- 感情线 / 关系线：{无显性感情线时写“无显性，但关系变化为…”}
+- 逻辑线：原因 → 行动 → 结果 → 后果/新问题
+
+#### 人物关系和出场顺序
+- 出场顺序：{角色/势力/关键物件按实际出现顺序列出}
+- 人物关系变化：{本章前 → 本章后}
+- 视角/信息差：{谁知道什么；读者知道什么；主角误判什么。取自 `追踪/时间线/读者已知.md`，不另起一套；还没有追踪的新书按设定与卷纲写}
+
+#### 情节细化
+| # | 情节点（谁做了什么） | 功能标签 | 执行边界（禁＋放） |
+|---|---|---|---|
+| 1 | {主角在账单上发现4800元转出} | {信息揭示} | {禁：不揭露幕后者。放：他当场算出这笔钱等于几个月房租，允许写出来} |
+
+- 功能标签＝目的词：铺垫/高潮/爽点/打脸/人物塑造/设定。点数由语义需要决定，不填写逐点字数，不用 `目标字数 / beat 数` 反推。
+- **执行边界写「禁＋放」两半**：禁＝本点不能提前释放或新增什么；放＝本点允许什么落地、到什么量级（谁可以出声、谁可以失态、允不允许当场标价）。**每章至少一个点写了「放」**；放行是解除限制，不是义务。
+- 复沓锚句：{须一字不差进正文的原话（誓言、面板、旧案原话），一行一条并注明落点，如"点3：立此为凭…"；没有写"无"}
+- 行动成本（可无）/收益归属：{可无行动成本；收益归谁、如何可见、是否留下后续账}
+
+#### 结尾设定和钩子
+- 结尾设定：{收束落到什么具体动作或画面（不写"就这样……""他终于明白……"式状态判词）；未解决问题；下一章推动力}
+- 章尾钩子：{从章尾13式中选择} — {具体内容，期待度：强/中/弱；低压/过场章可弱钩子或留阶段目标；与下一章如何承接}
+
+#### 可选：需要时再写（写了写手照样消费，不写不拦）
+- 字数范围：{作者给了上下限才写，如 2000-2600}
+- 阶段位置、章节定位（高压/推进/修炼试错/关系回收/低压生活/信息整理）、本章结构公式
+- 本章标价（得失折算成读者已知的什么）、闭环状态（获得/使用/见效/估值走到哪一拍）
+- 写手自由区（本章最值得放开、由写手发明的几处）、镜头准入（一场给谁台词位）、信息差触发点（在第几点提醒读者手里的牌）
+- 情节点表加「分辨率」列（密/中/疏，同类并列递减）
+- 契约风险：只在本章让单元卡「契约风险」变化时写
+```
+
+**大纲锁定**：已进入正文写作的前 10 章细纲锁定，未经用户确认不得修改；后续滚动细纲可随正文反馈微调。已进入正文的卷的卷纲锁定规则见 workflow-volume.md。
+
+**中途补纲/扩纲小流程**（项目已有大纲；只改细纲不进入正文大修）：
+1. 定位请求范围、已写进度和所属单元：读 `大纲/大纲.md`；卷纲先用 `outline_view.py --toc {卷纲路径}` 定位，再 `--unit {单元ID}` 取闭包，尚无单元用 `--contract` 取契约，不整读。另读 `设定/题材定位.md` 和已有 `追踪/上下文.md`；有正文却缺追踪时停止补纲，提示按 workflow-daily 修复/迁移，不猜进度；无正文也无追踪时以现有纲/设定规划，不为读取状态先初始化。
+2. 请求章已属于既有单元时复用单元卡，只补/改点名细纲，不另建单元；沿用上方锁定规则。确需新单元先按 workflow-volume.md 追加单元卡（含「对标节奏迁移」选同类单元），向卷尾**追加**卡及情绪弧线、故事线、伏笔规划，已锁定内容不动。用户补纲不等于授权修改其他章；超出本卷体量时先确认扩卷或开新卷。
+3. 追加单元时答 workflow-volume.md「排纲自查」1–4（按单元内 1/4·中点·3/4 口径）；进入细纲层时做本文件步骤 3 供给自查。
+4. 按本次交付层级停止：需要细纲时按上述批次边界只做请求范围，完成「细纲后设定补全」与建纲批末复核。
+5. 规划事件和未来揭示只落卷纲/细纲，不提前成为追踪事实。已有正文项目补纲不写 `追踪/`，不执行 init/commit；下一章必须履行的承诺在下一次正文事务里进入 `next_chapter_commitments`。
+
+**细纲质量要求**：每章细纲都要按当前章节蓝图直接指导正文（核心事件、字数目标、字数口径、单元ID/位置、目标情绪、主角目标/关键选择、章首钩子、爽点、本章禁止提前释放九个必填字段齐备），但**强度按章节定位分配、不是每章顶满**：高压/推进章配齐钩子+爽点+悬念；低压/关系/修炼/信息整理章允许无显性爽点、弱钩子或仅情绪钩子，重点是把功能（喘息、关系、铺垫、转场）写到位。底线是每章都给读者一个往下看的理由、相邻章不情绪趋同（见 workflow-volume.md「章节定位与张弛」）。字段不完整时先补齐；无法从材料确定的关系或副线写 `[待补充]`，不得杜撰。
+
+> **细纲钩子来源**：优先沿本批剧情单元卡「对标剧情参照」的单元节拍与兑现方式设计钩子链；对标登记 ≥2 本时读 `references/cross-book-recall.md`，副对标同基调 `章节/*_摘要.md` 仍可作单章钩子灵感（可选）；有 `灵感库/` 时可按「适用阶段=细纲」召回 active CBA 辅助钩子设计，零命中不阻塞
+
+**章节标题规则**：只做轻量去重；发现同名或明显重复标题时，按本章核心事件改名，并保持细纲标题与正文文件名一致。
+
+**细纲后设定补全（每批细纲建完后执行）**：扫描本批细纲新出现的具名角色/势力/关键设定，对**会复用**的（按卷纲/细纲判断：后续多次出场或承担剧情功能）自动建档，不等用户确认：
+- 角色 → 建 `设定/角色/{名}.md`（填空模板见 character-basics.md 主角卡/配角卡）；核心复用角色真正进入正文后，由追踪事务建立 `追踪/角色状态/{名}.md` 动态快照；
+- 势力/组织 → 建 `设定/势力/{名}.md`（名称、定位、核心目标、关键人物、与主角关系）；
+- 影响多章的世界观规则 → 建/补 `设定/世界观/{主题}.md`（规则、适用范围）。
+- **刻度与名目** → 建/补 `设定/世界观/{主题}.md` 里的对照表。凡是正文要拿来**比大小、算价钱、报名次、定档位**的东西都算：资质/评级档位、职级与待遇、货币与物价、等级与进度格、名次与席位、赏罚名目、时限与期限。写成**可数的序列**（几档、哪一档在哪、相邻两档差多少），不要只写一个孤立的值。
+
+**缺什么按新增物三级处置——不许硬写，也不许一律停摆。** 判据见 SKILL.md「新增物三级」（交给 story-architect 时任务包末尾已附原文）。排纲时需要一样东西（角色、能力、物价、规矩、刻度、场景）而设定里查不到时，先查再分级：
+
+0. **先查**：`设定/世界观/`、`设定/势力/`、`设定/题材定位.md`（升级台阶）里是不是已经有（同一件事在不同文件里可能叫不同名字，换个说法登记的也算）。查不到的按下面三级处置。
+1. **直接写**：写进细纲，不落档、不上报。
+2. **写了要报**（发明＋落档）：不与既有裁定冲突时直接补充。先增量落设定，再供细纲引用，并在排纲底稿的供给自查里登记。项目引用用书目录相对路径（如 `设定/角色/张三.md`）；`./`、`../` 相对细纲目录，裸文件名不校验。地点只补本批用到的分区、进出口、相对位置或脚程。补纲授权下的新故事线先在卷纲故事线表分配 L 编号并写清主线对接口，再供细纲引用；日更不自动扩纲。
+3. **先问作者**（提案裁定）：不自行决定。在排纲底稿的供给自查里列具体缺口、1-2 个候选及关联设定影响，建纲批末按下方汇报模板用故事话问作者；裁定先落设定再引用，不以占位或临时编数代替。设定互相冲突时列出出处供作者判断。
+
+已存在的设定文件按细纲新信息**增量补充、不覆盖**。一次性路人、后文无戏份的配角不建静态档案或动态快照。建档只填细纲已确定的信息，未定字段留占位符，不提前杜撰。
+
+**规划交付后向作者汇报**（细纲、补纲、改细纲用；按 SKILL.md「面向作者的汇报」）：供给自查、建纲批末复核是内部核对，只把结论翻成故事话；「先问作者」的缺口和两个设定互相冲突都作为「要你定的事」问。
+
+<!-- author-report -->
+```md
+{做了什么，如「第二卷卷纲定好了」「补好了第22-26章细纲」「按你说的改了第23章细纲」}：
+- {故事层要点，一行一件：这卷/这几章主要发生什么，主角得到或失去什么，停在哪个悬念上}
+- {改细纲时：原来是什么，现在改成什么，会不会牵动别的章}
+{某段剧情主角的功劳被别人拿走、或提前用掉了后面的底牌时一句话说清，如「第三段剧情里功劳落到了师父身上，我先把纲改成沈栀自己拿主意」；没有就删掉此行}
+{前面吊起的期待还没兑现时说清哪章兑现；没有就删掉此行}
+{要你定的事：一句问题＋白话选项＋推荐，如「沈栀的金手指每天能用几次？1. 一次（推荐，后面好加码）2. 不限次」；没有就删掉此行}
+下一步：{如「要接着写第22章正文吗？」「要继续出第27-31章细纲吗？」}
+```
+
+#### Agent 调用：story-architect
+
+已部署时，每批细纲在 story-architect 的新上下文里出，调用见 [agent-calls.md](agent-calls.md)；主会话拿到后对每章跑 `check-outline-contract.js`，按建纲批末复核汇报。
+
+---
+
+## 附：按剧情批出细纲与排纲底稿模板
+
+### 按剧情批出细纲（细纲分批边界）
+
+一批细纲 = 卷纲里的一个剧情单元（约 5-15 章）。体量换算：剧情单元字数 ÷ 单章目标字数 → 章数，单章目标字数取本书既有细纲惯例，无惯例按题材节奏档取默认（快节奏/短平快约 2000，均衡约 3000）；剧情单元超过 1.5 万字且单元节拍含两个以上独立高潮时拆成多个剧情单元，否则单个剧情单元。剧情单元 >10 章拆两批建纲，两批共享同一次召回；首批 = 前 10 章封顶、可跨单元（跨入的剧情单元建卡时召回一次，余章由后续滚动批共享剧情单元卡结论），停靠规则见上文批次步骤 1。
+
+建卡时做一次**剧情批召回**：读剧情单元卡「对标剧情参照」指向的剧情单元（≤3 个文件）的「结构分布」「情节点索引」，回查该书 `剧情/节奏.md` 同章节区间的爽点循环 / 触动点与被引情绪模块卡，提炼 5-8 拍共性节拍写入剧情单元卡「单元节拍/章功能分配」，单元情绪引擎字段对照主对标 `剧情/情绪模块.md` 的可复现模块校准。若主产物存在但被引的单个情绪模块卡未命中，只跳过该卡；`剧情/情绪模块.md` 或 `剧情/节奏.md` 文件缺失按 workflow-volume.md「对标节奏迁移」的 fail-fast 先修复。换素材与修硬伤纪律同该节步骤 3/4——保留情绪链和功能位，对象、场景、事件全换，对标弱处理就地修正。结论固化进剧情单元卡后，逐章细纲只消费剧情单元卡，不重读剧情单元。
+
+**「只消费剧情单元卡」管的是不重读对标，不冻结逐章建纲。** 排纲当场发现的缺口（某拍无对手、数值没验过、地点无底图、角色既定规矩挡场之类）按新增物三级处置（直接写／写了要报：先落档再引用／先问作者：挂起提案，见上文「缺什么按新增物三级处置」），处置完记一行，批末汇进排纲底稿的「**建纲追加**」小节（见上文批次步骤 5）；下一批供给自查以该小节为固定输入（按当场缺口类别加问批前盘点项）。
+
+日更中途发现卷纲缺少「对标剧情参照」等当前协议必需字段时，先补齐卷纲再建细纲；锁定卷纲不得自动回写，必须停在补纲边界。单元节拍分析过程不写进追踪文件，只有最终影响未来连续性的约束或下一章承诺才进入本章追踪事务。
+
+## 排纲底稿模板（`大纲/排纲底稿_{单元ID}.md`）
+
+排纲期的工作底稿，每个剧情单元一份，只在排纲/补纲时读，写正文不读。
+
+```markdown
+# {单元ID} 排纲底稿
+
+## 批次定位
+{每批补纲前先写，见步骤 2：阶段与单元、本批推进目标、可释放与严禁提前释放的信息、章尾钩子的边界；多批时一批一段}
+
+## 供给自查
+{本单元出细纲前产出，见本文件步骤 3。六行：对手供给 / 角色供给 / 能力与金手指供给 / 刻度供给 / 场景与底图供给 / 故事线供给。「写了要报」的发明各列一行「发明了什么＋落在哪个设定文件」；「先问作者」的提案列候选＋影响面待作者裁定；无缺口写「无缺口」。建纲批末 `check-outline-contract.js --supply {卷纲路径} {单元ID}` 验证本小节存在}
+
+## 建纲追加
+{本批建完后回填，见步骤 5；写正文时申报表「本章没写成的」里「细纲没给」的也追加在这里。逐章落笔时才发现的缺口，一条一行，不与上面六行混写。格式：`第 N 章排到哪一步发现缺什么 ／ 级别 ／ 落在哪个设定文件或提案编号`。一条也没有写「无追加」。下一批供给自查以本小节为固定输入}
+```

package/resources/skills/story-creation/upstream/skills/story-long-write/references/workflow-revision.md

@@ -0,0 +1,89 @@
+# workflow-revision.md：大修工作流
+
+作者说「修改／回炉／重写第X章」时用本文件；只改细纲不进本流程（走 workflow-outline.md）。作者要先说清是哪一章，推断不出就问。
+
+---
+
+## Step 1：定位与改动范围
+
+1. 找文件：`正文/第{X}章_*.md`；作者给的是章名就按关键词找，找不到让作者确认。
+2. **先定范围再读东西**：从作者的话判断改多大——点到了段落或场面（「那场打斗」「结尾那段对话」）就是局部修改；说「重写」「回炉」就是整章重写。判断不了才问，给选项：
+
+<!-- author-report -->
+```md
+第{X}章《{章名}》想怎么改？
+1. 只改你点到的地方，其他不动（推荐）
+2. 按原细纲整章重写
+3. 先改这章的细纲，再按新细纲重写
+{你想改掉的是什么，一句话说说也行，比如「打脸不够狠」「他俩对话太客气」}
+```
+
+选 3 → 先按 workflow-outline.md 改细纲，改完回到本流程按整章重写。
+
+---
+
+## Step 2：按范围加载
+
+- 都要：待改章全文、`大纲/细纲_第{X}章.md`、`tracking_commit.py check`（取 `state_revision`）与 `追踪/上下文.md`；缺 state 时停止，已有正文的项目先经 `story-import` 生成标准追踪。
+- 局部修改：前一章只看最后几段（第 1 章没有就不看）、后一章只看开头几段，确认衔接；涉及的角色读 `设定/角色/{名}.md` 与 `追踪/角色状态/{名}.md`。
+- 整章重写：前后两章全文，加上细纲点名的角色与设定；第 1 章没有前一章时看 `设定/题材定位.md`。
+
+---
+
+## Step 3：改写与提交前检查
+
+1. **备份**：原文复制为 `正文/第{X}章_章名_原稿_{YYYYMMDD}.md`；用 `{PYTHON} {skill 根}/scripts/storyctl.py wordcount measure --file {正文文件}` 记下原字数。
+2. **改写**：已部署 narrative-writer 时按 [agent-calls.md](agent-calls.md)「改写一章」交给它；否则主会话自己改，读 `references/writing-craft.md` 与 `references/long-format.md`；改的是情绪对抗、打脸这类戏时，按 SKILL.md「本章技法」只读对应那一节。局部修改只动点到的段落，其余一字不改；不借改稿新增细纲外的剧情。
+3. **检测**：`{PYTHON} {skill 根}/scripts/storyctl.py chapter check --project {项目根} --chapter {X} --fix-punctuation`，按返回的 `status` 走：
+
+| 状态 | 处理 |
+|---|---|
+| `ready` | 往下走 |
+| `blocked` / `invalid` | 改到净再重跑（工程词泄漏也在报告里） |
+| `needs_decision`（字数出带） | 欠字不补；超字把删除区间交写手按 agent-calls「超字一次净删」删一次（自己改就同样只删不加），复检仍带外用下面的字数问法请作者选 |
+| `tool_unavailable`（退出码 3） | 停下，不提交，告诉作者「要装 Node.js 18 或更新版本，才能做改后检查」 |
+| 退出码 2 | 按 `error_code` 修命令重跑 |
+4. **人物与节奏**：改后的角色行为与设定、前后章一致；改动没把这章的节奏打散。
+5. **篇幅**：与原文差异超过 30% 或 800 字（取较大）时告诉作者「改后约 X 字，比原来多/少 Y 字，比目标多/少 Z 字」；字数本身不触发再改一遍。
+6. 需要查证外部事实时 spawn `story-researcher`。
+
+---
+
+## Step 4：级联更新与提交
+
+用一次 `mode=revision` 追踪事务更新；下面几条是修订的要点，[tracking-transaction.md](tracking-transaction.md) 只在报错时读：
+
+1. **重算修订章记录**：先跑 `{PYTHON} {skill 根}/scripts/tracking_commit.py draft --project {项目根} --chapter {X}`，草稿已按本章现有记录预填；对照新正文，仍有效的保留，被推翻的改写或删掉，不清空重写。工具整份重写 `追踪/逐章记录/第{X}章.md`。
+2. **伏笔当前值**：对受影响 ID 从第 X 章检查到最后已写章 M，提交修订后的**截至 M 章当前状态**。若修订删除了埋设，但后文仍引用该 ID，先列为正文冲突，不能简单删除；确定整条线不存在时才用 `action=delete`。
+3. **时间与读者认知**：为受影响事件提交客观事实、读者截至 M 章的当前认知、实际揭示状态/章节；删掉的事件用 `action=delete`。未来揭示计划仍留大纲。工具重建作者/读者视图，禁止手改。
+4. **角色当前快照**：对受影响核心角色从 X 检查到 M，按身份、位置、目标、能力资源、关系对象、已知信息、未结事项分别重算，提交一份截至 M 的完整快照；不得用最后一条单维度变化覆盖其它维度。
+5. **导入截止范围**：若 X ≤ `_tracking-state.json.imported_through_chapter`，事务为第 X 章新增覆盖记录；导入截止章不变，当前结构化状态按修订结果更新。
+6. **提交与重试**：跑 `{PYTHON} {skill 根}/scripts/storyctl.py chapter commit --project {项目根} --chapter {X} --input {项目根}/.story/work/第{XXX}章/tracking.json`，它重新计数并清理本章工作目录。带外时先问作者：
+
+<!-- author-report -->
+```md
+第{X}章改完约 {实际} 字，比目标{少/多}了约 {差额} 字（目标约 {目标} 字）。{一句原因，如「按你说的删掉了那场追逐」}
+你想怎么处理？
+1. 就按现在的长度收下（推荐）
+2. 我再调整这章，往目标靠
+3. 退回原稿
+```
+
+不到目标一半时选项 1 不标推荐。选 1 → 改用 `chapter accept-current-length`，不到目标一半、或超字还没压缩过一次会被拒，把差多少字告诉作者，作者明确坚持才加 `--force`；选 2 → 回 Step 3；选 3 → 用备份原稿覆盖回去，不提交。失败时保留草稿，修正后重跑同一命令；通过 `check` 前不修下一章、不写新章。
+7. **收口**：`{PYTHON} {skill 根}/scripts/tracking_commit.py check --project {项目根}` 验证 state 与派生视图一致。改变了角色状态、关系或世界观设定的，扫一遍后续章正文，把受影响的列进汇报。
+
+---
+
+## Step 5：向作者汇报
+
+按 SKILL.md「面向作者的汇报」；追踪修订与各项扫描只作内部核对。
+
+<!-- author-report -->
+```md
+第{X}章《{章名}》改好了，原稿留着，想退回随时说：
+- {改了什么，用故事话：原来怎样 → 现在怎样}
+- 篇幅：{差异超过步骤 3 第 5 条的阈值才写：约 X 字，比原来多/少约 Y 字；没超就删掉这行}
+{后面受影响的章：「第{X+1}章《{章名}》里{谁/什么}还按旧说法写，要一起改吗？1. 一起改（推荐）2. 先不动」；没有就写「后面的章不受影响」}
+```
+
+连续改多章时逐章走 Step 1-5；改完发现后续不一致，列出受影响的章由作者决定是否现在改。