需要规划或写作长篇网文时，按场景门禁与阶段流程从选题…

适用于长篇网络小说的结构讨论、大纲/细纲规划、开书、指定章写作、日更续写与大修，要求先完成 Reference Gate 再落笔。

适用场景

解决思路

1. 任何创建或修改长篇故事文件的动作前，先判断当前场景并完成本轮 Reference Gate；只读 SKILL.md 不算完成，用 rg 检索或局部摘读也不算完整读取。
2. 将必需 references 分块读到 EOF：规划/开书/补纲先完整读取 references/workflow-setup.md；写指定章读取 references/workflow-chapter.md；日更/大修先读取 references/workflow-daily.md 或 references/workflow-revision.md，进入正文前再完整读取 workflow-chapter.md。
3. 主会话直接写正文时，首次落笔前完整读取 references/long-format.md、references/writing-craft.md、references/long-chapter-quality.md、references/long-chapter-hooks.md；交给 narrative-writer 时，由该 agent 按自己的 reference 表完成同等写前读取，主会话不得用未读 reference 的临时 prompt 替代。
4. 悬疑、惊悚、异常线索章加读 references/long-suspense.md；身份/认知/立场反转章加读 references/long-reversal.md。
5. 正文写前，references 读完后立即重读当前用户请求、本章细纲和卷纲，在上下文内建立 Constraint Lock：原样记录用户明确字数范围、必发生、禁止发生、精确时间锚与本章停笔点、章尾新债。
6. references 只提供技法，不得覆盖项目事实；用户明确范围优先于自动 ± 比例带。
7. 交付前逐项复核 Constraint Lock：字数带外按 workflow-chapter.md 的收口流程交用户处置，不自动补字；其余项越界不算完成。
8. 任一必需路径不存在、不可读或未读完时立即停止，报告准确路径，不得先写正文再补读。
9. Reference Gate 按当前任务、当前会话重新执行；旧会话的「读过」不能沿用。
10. 专业 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 执行。
11. 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。
12. 正文写作、改写或审稿前先读 references/style-resolution.md，加载本书文风并形成 style_resolution；无作者记忆也执行。
13. 当前请求、本书文风和 active 偏好按维度覆盖通用 references；同一裁决交给后续执行者。
14. 核心方法：先定情绪，再定故事；每个场景都必须服务于一个明确的情绪目标；说不清交付什么情绪的场景不该存在。
15. 从验证过的模式出发：先问「什么被验证过有效，我如何重新交付」，少从「我想写什么」直接起步；扫榜找方向，拆文找模块，对标找节奏。
16. 用模块组装，不要重新发明：找到该题材验证过的剧情模式（反转怎么铺、爽点怎么爆、感情怎么拉扯），把对标书的具体角色看成功能位（对手/盟友/催化剂），再映射到自己的角色，用自己素材填充这些功能位。
17. 只加载必需信息：写每章只读「不知道就会写错」的角色状态、待收伏笔、相关设定，其余留在文件系统里。
18. 涉及读者契约、主角代理权、利益安全、期待债、终局储备（终局底牌/升级台阶）、机构/势力边界和 契约安全 / 需补强 / 契约破坏 风险判定时，先按 references/reader-contract-and-progression.md 校准，不在 SKILL.md 内复制长规则。
19. 作者记忆：按 references/author-memory.md 带 --book-root 查询 ≤2KB active 项交执行者；当前请求、本书文风优先；长期声明用 record 写入、回传回执。
20. 按题材选核心情绪与重点参考：打脸/逆袭→爽感释放，plot-emotion-system.md + style-combat-face.md；身份反转→震撼+痛快，long-reversal.md；感情拉扯→意难平，emotional-methods.md；悬疑/惊悚→紧张+好奇，long-suspense.md；日常装逼→期待感，long-chapter-hooks.md。
21. 情绪反查题材：用户先说情绪感觉但没提题材时，从上表反向匹配（如「爽感释放」指向打脸/逆袭），再从 long-genre-catalog.md 找该题材下的细分方向。
22. 写作流程先确定操作对象、交付范围和停点，再看项目状态；空项目不等于授权完整开书。
23. 结构讨论：触发「只讨论/推敲故事结构」时，只交付结构方案，不建工程、不自动落盘；不要求先填完设定或细纲。
24. 大纲规划：触发「写大纲/规划剧情/规划全书/规划第X卷/开新卷」时，按需取 Phase 1→3，交付所请求大纲/卷纲及必要设定；不自动展开细纲或初始化追踪。
25. 细纲规划：触发「出细纲/补纲/扩纲/补细纲/写或修改第N章细纲」时走 Phase 3：既有单元内只补/改点名章；需要新单元才走「中途补纲/扩纲小流程」；指定范围不扩到整单元；未指定时按剧情批建纲。
26. 开书：触发「帮我开书」且未限定规划层级时走 Phase 1→2→3：建项目、核心设定、卷纲与首批 10 章细纲；默认停在细纲交付，不自动写正文。
27. 写指定章：触发「写第 N 章」/「写第1章」/「开书并写首章」且对象是正文时走 Phase 4→5，只写点名章后停止；缺前置时先补必要设定、卷纲和点名章细纲，不套用完整开书的 10 章默认。
28. 日更续写：关键词（「日更」/「续写」/「继续写」）且项目已有正文+追踪时，加载 references/workflow-daily.md。
29. 大修：触发「修改第X章」/「回炉」/「重写第X章」且对象是已写正文时，加载 references/workflow-revision.md；只改细纲不进此流程。
30. 对象优先：「写/修改第N章细纲」是规划，不因命中「写/修改第N章」而写正文；「以后再写正文」不是本轮授权；仅规划要求优先于旧日更任务，停止旧批量；对象不明或同一请求范围冲突时，只确认冲突项。
31. 规划续接：保留当前任务范围；「继续/继续写/按这个来/确认方案」不扩大范围，完成即停，不自动转细纲或正文；新明确请求可调整规划层级/范围；不把规划模式写入追踪或作者记忆，不调用 narrative-writer，委派传同一范围和停点。
32. 转入正文：明确正文请求只授权进入既有写作流程，不等于可以直接落笔；创建/修改正文前重新完成本轮全部正文 Reference Gate，并按 workflow-chapter 处理缺 state、使 tracking_commit.py check 通过；任一未完成则停止，不落正文；之后仍按原流程写作、质检、提交追踪，无须再问是否继续。
33. 开新卷：新角色/势力/设定按需回 Phase 2 增量补充；Phase 3 只做到本次请求的层级，不自动转正文。
34. 裸调用 /story-long-write 或 $story-long-write（无明确意图）时只诊断项目并列选项，不得自动进入正文写作，也不得把已有项目默认为日更 3 章：空项目→「讨论结构」「写大纲」「帮我开书」；有纲无正文→「补细纲」「写第1章」；有正文+追踪→展示进度与下一章细纲状态，列「规划下一卷」「日更2章」「修改第X章」。
35. 正文批量上限：写正文必须由用户显式给出章节范围或日更意图；未给数量时单章写作默认 1 章，日更 workflow 默认 2-3 章；用户给出 N 时按 N 执行但单轮最多 3 章，超过 3 章先拆成本轮 3 章并在进度摘要里提示后续再继续。
36. 匹配顺序：只规划按 结构讨论 → 细纲规划 → 大纲规划 → 开书，越窄越优先；要正文按 大修 → 写指定章 → 日更续写；日更前置不齐则提示补齐或写第1章，不直接写一批。
37. 日更续接：用户未改变任务时，同批「继续/续写/日更」仍走 references/workflow-daily.md 的完整串行流程，不直接落正文；正常批量不重复确认；阻塞或用户要求逐章确认时才暂停；切到规划后按「规划续接」，不恢复旧日更批量。
38. 无法判断场景时，列出场景表让用户选择，不要开放式提问。
39. 拆文库/对标关系：拆文库/ = analyze skill 的原始产出，是数据源；对标/ = 写作项目的引用视图，存放与本项目相关的对标数据子集；首次引用对标书时，从 拆文库/{书名}/ 复制相关子目录（章节/角色/剧情/设定）、剧情/节奏.md、剧情/情绪模块.md、文风.md 和 拆文报告.md 到 对标/{书名}/。
40. 对标书路径查找：优先 {项目}/对标/{书名}/，不存在则回退 拆文库/{书名}/；所有对标数据加载均使用此规则。
41. 卷纲不整读，任何场景要卷纲内容一律走 {PYTHON} {skill 根}/scripts/outline_view.py --unit {单元ID} {卷纲路径}（脚本统一输出 UTF-8）；只要契约不要单元时用 --contract，先看一屏目录用 --toc。
42. 两档分明：写正文用 --stage write（卷级常任＋单元级，批次底稿一概不给）；排纲/补纲用默认 --stage outline（另带该单元在用的批次底稿）。
43. 供给自查、建纲追加、批次级复检这类底稿是排纲期工作底稿，写作期不是输入；它们里头凡有写作期约束力的条目，建纲时就必须下沉到单元级段或细纲（--check 的 W1 告警专盯这个）。
44. 卷纲取段取的是闭包不是点名段：输出恒等于「全部卷级常任段 ＋ 该单元的单元级段 ＋ 该单元在用的批次底稿」，逐章表（情绪弧线等）按该单元章区间裁行，带退役标记的行默认不输出（要看历史加 --history）。
45. 找不到单元时脚本 exit 1 并报错，不静默降级——报错就去核对单元ID或先补卷纲，不要改用整读绕过。
46. 段头的 > 作用域： 声明是这套的地基，格式与 checker 见 references/artifact-protocols.md 卷纲模板；未声明作用域的段会被保守纳入并告警，跑 outline_view.py --check {卷纲路径} 修。
47. 执行 Phase 1 前先读 references/workflow-setup.md 的「Phase 1：确认选题方向」节，按其中步骤执行。
48. 执行 Phase 2 前先读 references/workflow-setup.md 的「Phase 2：核心设定」节，产出核心设定表，并创建 设定/关系.md、设定/题材定位.md、设定/题材正文提示卡.md。
49. 执行 Phase 3 前先读 references/workflow-setup.md 的「Phase 3：大纲搭建」节，产出全书体量与阶段总览、卷级大纲、逐章细纲；含大纲安全七检、大纲安全审查、分批建纲与「中途补纲/扩纲小流程」。
50. 创建目录、首次引用对标、定位产物或遇到文件缺失时，先完整读取 references/project-files.md，按其中目录结构、产物映射、缺失处理和权威顺序执行；正常续写不重复加载目录表。
51. 单章写作执行前先读 references/workflow-chapter.md，按其中的单章写作流程（步骤 1-13）、写作技巧提醒、字数验收权威与 Phase 5 质量检查执行；日更批量另加载 references/workflow-daily.md 控制批次。
52. 追踪文件体积：追踪/_tracking-state.json 是唯一结构化权威；上下文.md、核心角色快照、伏笔.md、作者真相与读者已知时间线都由它确定性派生，程序不反向解析 Markdown；上下文.md 固定 7 栏且 ≤12KB；逐章记录/第NNN章.md 每章只记录会影响后续连续性的紧凑变化，目标 ≤1536 字节、硬上限 3072 字节，不承诺单独重放出全部当前状态；阶段/卷级回看按需查询逐章记录或正文，不维护另一套长期摘要；所有追踪写入都通过 scripts/tracking_commit.py，禁止手改派生文件。
53. 流程衔接：写完去 AI 味 → story-deslop（/story-deslop）；想对比参考书 → story-long-analyze（/story-long-analyze）；需要市场方向 → story-long-scan（/story-long-scan）；太长适合短篇 → story-short-write（/story-short-write）。
54. 参考资料索引：阶段必读项按首屏 Reference Gate 执行；其他题材、结构与写作技法按 references/reference-index.md 的加载条件选用。
55. 语言：跟随用户的语言回复，用户用什么语言就用什么语言回复；中文回复遵循《中文文案排版指北》。

适用边界 · 注意事项

• 没有 oh-story-claudecode 技能包及其 references/scripts 和既定项目结构（拆文库/、对标/、设定/、追踪/ 等）时，无法按门禁与流程执行。
• 未获得明确正文写作授权时，不应自动进入正文写作或续写批量。
• 短篇或非网文长篇写作不适用；太长适合短篇时应转 story-short-write。