已有小说反向导入为可续写写作工程：按篇幅拆解并迁移项目结构

当已有一部写完或写到一半的小说，想把它重建为可直接续写的长篇/短篇写作工程项目时使用。

适用场景

解决思路

1. 交付物是写作工程：把作者已有的书重建为可续写的写作工程（项目结构 + 拆文库分析资产）；`拆文库/{导入书名}/` 是重建工程的数据源，不能当成用完即弃的中间产物，也不能替代交付物本身——交付物应让作者能直接续写；执行时以「建工程」为可见目标，别把「拆文」当成终点或对外标签。
2. 先分析后迁移：先用拆解管道完整拆解小说到 `拆文库/{导入书名}/`，再将分析结果迁移为项目结构；该目录保存本书导入分析，保留不丢弃，但不属于外部对标视图。
3. 复用不重复：深度分析阶段调用现成拆解管道；长篇运行 `/story-long-analyze` 的完整拆解管道，短篇运行 `/story-short-analyze` 的拆解管道；story-import 不执行拆解方法论、不维护这些文件。
4. 名词与目录边界：`{导入书名}` 的分析源固定为 `拆文库/{导入书名}/`；`{对标书名}` 必须是独立拆解产物，来源固定为 `拆文库/{对标书名}/`，且不得指向本次导入源。
5. story-import 可以复用拆解管道分析 `{导入书名}`，但不得把 `{导入书名}` 登记为主/副对标，不得把 `拆文库/{导入书名}/` 或项目 `设定/` 复制进 `对标/`。
6. 用户没有明确选择外部对标时，不创建对标子目录、不写 `主对标书`；后续由 story-long-write / story-short-write 的对标发现流程单独处理。
7. Agent 兼容性检查：只检查当前运行时的 canonical 目录——Claude `.claude/agents/{agent}.md`、OpenCode `.opencode/agents/{agent}.md`、Codex `.codex/agents/{agent}.toml`、Antigravity `.agents/agents/agent-name/agent.md`（`agent-name` 为目标 agent 名）；不得因其他端文件存在而误判；Codex 使用同名 `agent_type`；Antigravity 使用 `invoke_subagent` + `TypeName`；对应运行时未暴露 custom-agent registry / `invoke_subagent` 或返回未知 agent 时，必须降级 solo/direct；检测到 `.zcode/` 时同样直接 solo/direct，因为 ZCode 3.3.4 不执行项目 custom agents；报告 `Fallback: project custom agents unavailable -> solo`；Claude/OpenCode 兼容面保留 `subagent_type`。
8. Spawn 版本提示（不阻断 spawn）：先读取项目根 `.story-deployed` 的 `agents_version`；与本版 `agents_version: 30` 不一致时（标记缺失、字段缺失/非整数、小于或大于 30）照常按文件存在性检查并 spawn，同时报告 `Notice: agents bundle 版本不匹配（项目 {N}，本版 30）` 并提示重新运行 `/story-setup` 后新开会话；大于 30 时额外提示先更新 oh-story-claudecode，不要用本地旧版 setup 降级覆盖；只有 agent 文件缺失、或运行时不暴露 custom agent 时才降级 solo/direct，报告 `Fallback: ... -> solo`。
9. 当用户问导入续写先走 story-setup 还是 story-import 等流程问题时，先直接给出结论再收集原文：推荐顺序为先 `/story-setup` 部署 hooks/agents/AGENTS，新开/刷新会话后运行 `/story-import`，最后用 `/story-long-write 日更/写第N章` 续写。
10. 也可以直接 `/story-import`：本 skill 会在进入深度分析前检测 `.story-deployed` 与专业 agent；未部署时给出「先去 setup」或「继续导入（串行降级）」两种选择。
11. 已导入过的当前协议项目（书名目录下有 `追踪/_tracking-state.json`）：不要重复跑完整导入；直接进入书名目录，确认 `.active-book` 指向正确书目，再用 `/story-long-write 日更` 或 `/story-long-write 写第N章`。
12. v0.7.2 及更早旧追踪项目（有 `追踪/` 和正文，但没有 `追踪/_tracking-state.json`）：日更会停下要求重新导入，但不需要重跑全书拆解，只重建追踪。
13. 旧追踪项目迁移步骤1：数清最后一个完整章号 N（`正文/第NNN章_*.md` 的最大值）。
14. 旧追踪项目迁移步骤2：从旧 `追踪/` 现有文件和最近 3-5 章正文，重建当前状态：核心角色快照、未回收伏笔、已揭示时间线事件、长期约束、下一章承诺；角色快照反推方法见 `references/character-state-reverse.md`。
15. 旧追踪项目迁移步骤3：完整读取 `references/tracking-initialization.md`，按其初始化事务格式构造 JSON，`last_chapter` 写 `N`，执行 `tracking_commit.py init`。
16. 旧追踪项目迁移步骤4：`init` 会把旧追踪结构按原样整体移入 `追踪/_旧追踪存档/` 再建当前协议；旧内容不删除、不参与解析，留给作者查阅。
17. 旧追踪项目迁移步骤5：跑 `tracking_commit.py check` 确认通过，再回 `/story-long-write 日更` 续写；重建结果以证据为准，拿不准的字段留空或写进 `continuity_risks`，不杜撰；用户明确要求重拆全书时才走完整 Phase 2。
18. 询问用户：「你要导入哪本书？请提供文件路径或直接贴文本。」
19. Step 2 确认意图：默认目标是完整写作工程（可续写）；若用户意图不明确，主动询问是要可续写的工程还是只要一份拆文库分析，不要默认。
20. 要可续写工程 → 走完整 story-import（Phase 2 拆 + Phase 3 迁移）。
21. 只要分析/拆文库 → 直接用 `/story-long-analyze`（短篇 `/story-short-analyze`），到拆文库为止，不进 Phase 3 迁移。
22. Step 3 输入方式识别：单文件路径（.txt/.md）→ 按章节分隔符自动切分；目录路径 → 按文件名排序，合并处理；无路径但用户直接贴文本 → 保存到临时文件后处理；否则提示用户提供源文件。
23. Step 4 基本信息确认：自动检测书名、总章数、总字数、章节格式。
24. Step 4 用户确认：导入书名、题材类型、目标平台（起点/番茄/晋江/其他）、是否完本、篇幅类型（长篇/短篇，按 `references/length-routing.md` 自动检测：用户显式声明 > 结构信号 > 字数兜底，并向用户复述检测结果请其确认；判定结果决定 Phase 3 走长篇还是短篇路径）、最后一章是否完整（完整章/残稿）。
25. 最后一章为残稿时：提示用户并把「残稿到第 N 章」记入上下文，让用户决定是「基于残章续写」还是「先补完再导入」；story-import 只记录用户决定，不替用户选。
26. 外部对标（可选、与导入源分离）：用户明确指定外部对标时，记录 `{对标书名}` 并确认 `拆文库/{对标书名}/` 是该参考作品的独立拆解产物；不得把 `{导入书名}` 或本次刚生成的拆文目录当候选；用户未指定时不追加提问，记为「未绑定」，后续交给写作 skill 的对标发现流程。
27. Step 4 输出确认：向用户展示检测到的章节范围、字数、判定的篇幅类型、最后一章状态，以及「外部对标：{对标书名/未绑定}」，确认后开始分析。
28. Step 5 环境检测前置：进入 Phase 2 前先检测项目是否已部署 story-setup 基础设施；先读取 `.story-deployed` 并执行顶部 Spawn 版本门禁；旧版 `chapter-extractor` 文件即使仍在磁盘上也不可复用。
29. 只有 `agents_version: 28` 通过后，才在当前运行时的 canonical 目录检查 Phase 2 `chapter-extractor`：Claude/OpenCode/Antigravity 为同名 Markdown，Codex 为同名 TOML。
30. 如果 `.story-deployed` 的 `target_cli` 包含 `zcode`，项目 agents 缺失是 ZCode 3.3.4 的预期状态：不要提示重复部署，直接以串行 solo/direct 进入分析并报告 fallback。
31. 部署标记缺失、版本无效/过期，或当前端 agent 不可用，且不是已部署 ZCode 项目时，提示用户先运行 `/story-setup` 再回来导入，否则深度分析阶段无法使用并行 chapter-extractor agent；给用户两个选择：先去 setup；继续导入（接受 Phase 2 降级为串行处理，长篇逐章摘要不并行，速度较慢，但产物完整）；用户选择记入上下文，Phase 2 据此决定是否走并行模式。
32. Step 6 原文备份：原文备份由 Phase 2 调用的 analyze 拆解管道负责（analyze 管道前置步骤会把原文复制/保存到 `拆文库/{导入书名}/原文/`）；Phase 1 只需确认源文件就绪（路径有效或文本已拿到），不在此处单独备份，避免与 analyze 管道重复备份逻辑。
33. 按 Phase 1 判定的篇幅类型，调用对应 analyze skill 的完整拆解管道；不要做「复用方法论」式的半流程，要驱动整条管道跑完，拿到全套结构化产物。
34. 长篇：调用 story-long-analyze 的完整管道（Stage 0-6），产物目录 `拆文库/{导入书名}/`。
35. 短篇：调用 story-short-analyze 的拆解管道（Stage 2-6），产物目录 `拆文库/{导入书名}/`。
36. 长篇调用契约：story-long-analyze 在 Stage 0+1（黄金三章）后会自动停靠并用 AskUserQuestion 询问是否继续全量拆解；导入场景需要 Stage 2-6 的全套产物（逐章摘要 / 聚合分析 / `剧情/节奏.md` / `剧情/情绪模块.md` / 设定关系 / 汇总报告 / 文风），缺一不可。
37. 当前拆文契约：`_progress.md` 必须是 `schema_version: 2`，且 `剧情/节奏.md` 与 `剧情/情绪模块.md` 是导入必备权威产物；任一缺失都先修复或重跑对应 Stage，不得用摘要文件拼出看似完整的导入工程。
38. 调用 story-long-analyze 时必须在一开始就以「完整拆解、一次跑完、不要停下询问」模式驱动管道，命中其「跳过询问」路径（用户开头明确说「完整拆解 / 一次跑完 / 系统拆解 / 别问」时不停靠），让管道自动从 Stage 2 续跑到 Stage 6。
39. 长篇措辞示例：启动深度分析时声明「以『完整拆解、一次跑完、不要停下询问』模式拆解本书，确保 Stage 2-6 全部产出」。
40. 长篇兜底：若运行环境实际仍停在 Stage 1 询问处，story-import 自动选择「继续全量拆解」，绝不把停靠询问甩给用户。
41. 长篇环境降级：环境检测发现未部署 chapter-extractor agent 且用户选择「继续导入」时，Stage 2 逐章摘要降级为串行处理，产物仍完整，仅速度变慢。
42. 短篇为单一全量管道：story-short-analyze 的拆解管道（Stage 2-6）本身无 Stage 1 停靠点，一次跑完即可；它的 Phase 1 四个 Step 都要跑，按下表导入场景取值执行，不整段跳过。
43. 短篇 Phase 1 Step 1：拿到原文——用 story-import Phase 1 已确认的源文件，不重新问。
44. 短篇 Phase 1 Step 2：字数检查（长短篇路由）——篇幅已在 story-import Phase 1 判定并经用户确认，直接答「按短篇继续」，不重新路由。
45. 短篇 Phase 1 Step 3：题材识别——照常跑，题材标尺必须加载；story-import Phase 1 Step 4 已确认的题材类型直接代入，不重复提问。
46. 短篇 Phase 1 Step 4：续跑检查（`拆文库/{导入书名}/_meta.json` 已存在时三选一）——先看旧产出是否可直接复用：`stages_completed` 已含 6 且 `拆文报告.md` / `情节节点.md` / `写作手法.md` / `原文/` 均非空、来源与本次导入源一致 → 直接进 Phase 3，不重跑也不归档；否则本轮首次进入 Phase 2 → 按 (a) 覆盖：先把旧产出归档到 `拆文库/{导入书名}/_archive_{时间戳}/`，再从 Stage 2 重跑；同一轮导入内重试同一本书 → 按 (b) 续跑；不把三选一甩给用户，也不跳过归档。
47. 短篇 `_meta.json` 的 `genre_detected` 由 Step 3 产出，是拆文契约的阻断级必填字段，下游 story-short-write 靠它选题材标尺——不要跳过 Step 3 直接从原文备份起跑。
48. 短篇措辞示例：启动深度分析时声明「《{导入书名}》篇幅已确认为短篇（题材 {题材类型}，全文约 {N} 字），Step 2 直接按短篇继续，Step 4 按覆盖并归档处理，题材识别照跑，确保 Stage 2-6 全部产出」。
49. 短篇兜底：若运行环境仍抛出「此文字数 {N} 偏长，建议改用 `/story-long-analyze`」或灰区提问「介于短/长之间，按短篇还是长篇拆？」，一律按 Phase 1 已锁定的判定逐字回「按短篇继续」，绝不把路由询问甩给用户。
50. 长篇输出目录：`拆文库/{导入书名}/` 下包含 `原文/原文.txt`（扩展名随源文件；对话直接贴入的文本存为 `原文.md`）、`概要.md`、`章节/`（每章同时有 `第N章_深度拆解.md` 和 `第N章_摘要.md`）、`快速预览.md`、`角色/{角色名}.md` 与 `角色/角色关系.md`、`剧情/{剧情标题}.md` / `故事线.md` / `节奏.md` / `情绪模块.md` / `散落情节.md`、`设定/世界观/`（背景设定.md / 力量体系.md / 地理.md / 金手指.md）与 `设定/势力/{势力名}.md`、`拆文报告.md`、`文风.md`、`_progress.md`。
51. 短篇输出目录：`拆文库/{导入书名}/` 下包含 `原文/原文.txt`（或 `原文.md`）、`拆文报告.md`、`情节节点.md`、`写作手法.md`、`_meta.json`。
52. 长篇完整管道 Stage 0：概要提取——输入原始文本，输出 `概要.md` + 章节索引，完成标志为章节结构识别完成。
53. 长篇完整管道 Stage 1：黄金三章——输入前 3 章原文，输出 `第1章_深度拆解.md` / `第2章_深度拆解.md` / `第3章_深度拆解.md` 和 `快速预览.md`（导入场景自动续跑，不停下询问），完成标志为 3 章拆解完成。
54. 长篇完整管道 Stage 2：逐章摘要——输入分块章节文本，输出章节摘要.md（含情节点+角色+关键信息与扩写技法），每章 10-40 情节点（密度 150-200 字/个，按字数动态调节），角色过滤（龙套不提取、别名归类），并行 chapter-extractor agent 模式（未部署 agent 时降级串行），计数验证：摘要数 == 章节数。
55. 长篇完整管道 Stage 3：聚合分析——输入全部章节摘要，输出 `剧情/*.md` + `剧情/README.md` + `剧情/故事线.md` + `剧情/节奏.md` + `剧情/情绪模块.md`；执行故事框架识别（前置），两步法剧情聚合（先从摘要识别剧情大纲，再按大纲分配情节点），关键信息推进索引，情绪触动点与爆发节奏，读者需求 / 情绪引擎 / 可复现模块，角色合并（跨章节去重+别名归一），角色分级（主角/反派/核心配角/功能角色），散落情节兜底（6步，含覆盖率验证），质量检查（置信度>=0.85/覆盖率85%-95%/重叠率<=35%）。
56. 长篇完整管道 Stage 4：设定+关系——输入阶段 3 合并后角色数据+情节点，输出 `设定/*.md` + `角色/*.md`；执行两阶段角色模型，别名解析（置信度≥0.85自动合并）。
57. 长篇完整管道 Stage 5：汇总报告——输入全部输出，输出 `拆文报告.md`（含「读者需求 / 情绪引擎」「关键信息与扩写技法总览」「节奏与情绪触动点」「可复现模块」，并指向 `剧情/节奏.md` / `剧情/情绪模块.md`）。
58. 长篇完整管道 Stage 6：文风——输入 `拆文报告.md` + `章节/第1-3章_深度拆解.md` + `章节/*_摘要.md` + `原文/原文.txt`，输出 `文风.md`（本书历史写法分析），落盘 `拆文库/{导入书名}/文风.md`，保留为导入分析，不复制到本书 `对标/`。
59. 短篇拆文管道：单一全量管道（Stage 2-6 严格串行），Stage 2 结构+情节节点 → Stage 3 情感线+爆点 → Stage 4 反转+写作手法 → Stage 5 人物+开头结尾 → Stage 6 综合评估，最终汇总为 `拆文报告.md`、`情节节点.md`、`写作手法.md`，另有 `_meta.json` 记管道元数据与结构计数。
60. 长篇分块沿用 story-long-analyze：Stage 2 用 chapter-extractor agent 并行，其余阶段按该 skill「分块策略」的章数阈值执行，story-import 不另定一套。
61. 恢复机制：中断时通过进度文件追踪进度；新会话读取进度文件定位断点；从断点所在块的起始章节恢复；长篇进度文件格式沿用 story-long-analyze 拆解管道的进度段落约定，包含当前阶段、最后处理章节、已完成阶段列表、更新时间。
62. 质量检查：长篇阶段 3-4 完成前执行质量检查（置信度 >= 0.85，覆盖率 85%-95%，重叠率 <= 35%），由 story-long-analyze 拆解管道自带的质量检查负责；短篇质量检查见 story-short-analyze 各阶段的完成标志。
63. 将 `拆文库/{导入书名}/` 的分析结果迁移为可被写作 skill 消费的项目结构；按 Phase 1 判定的篇幅类型分流：长篇走 3-L（映射规则 `references/structure-mapping-long.md`，续写接手 story-long-write 日更循环），短篇走 3-S（映射规则 `references/structure-mapping-short.md`，续写接手 story-short-write Phase 3 逐场景写作）。
64. Phase 3-L Step 1 创建项目骨架：`{导入书名}/` 下创建 `设定/世界观/`、`设定/角色/`、`设定/势力/`、`大纲/`、`正文/`、`追踪/逐章记录/`、`对标/`（可选；仅在显式绑定外部对标时创建子目录）、`参考资料/`。
65. Step 2 正文标准化：将原文迁移到 `正文/`，统一命名格式 `第XXX章_章名.md`；识别章节分隔符（第X章、Chapter X 等）；提取章节标题；补零对齐编号（第1章 → 第001章）；保留原文内容不变。
66. Step 3 角色文件迁移：将 `拆文库/{导入书名}/角色/{角色名}.md` 迁移到 `设定/角色/{角色名}.md`；迁移时按 `references/structure-mapping-long.md` 的「角色文件迁移模板」补齐 story-long-write 角色模板字段。
67. 角色分级迁移策略：主角（出现章节 ≥50% + 推动主线 + 完整成长轨迹）→ 完整迁移；反派（与主角对立 + 推动核心冲突 + 明确动机）→ 完整迁移；核心配角（出现章节 ≥20% 或推动重要支线）→ 完整迁移；功能角色（出现章节 <20% + 作用有限）→ 简化迁移。
68. Step 4 关系文件迁移：将 `拆文库/{导入书名}/角色/角色关系.md` 转换为 `设定/关系.md`，按 `structure-mapping-long.md`「关系文件转换规则」的目标格式模板输出。
69. Step 5 同步世界观设定：当前拆文契约已按主题输出 `拆文库/{导入书名}/设定/世界观/*.md` 与 `设定/势力/*.md`；导入时原样同步到项目；`世界观/` 必须包含 `背景设定.md`；`力量体系.md` 小于 200 字并已并入 `背景设定.md` 时可省略；否则缺失当前必需产物时停止并提示重跑 story-long-analyze Stage 4；不再现场拆分扁平文件。
70. Step 6 大纲生成——`大纲.md`（卷级结构）：从 `剧情/故事线.md`、`剧情/*.md` 和 `快速预览.md` 反推；卷划分采用用户确认制，规则见 `structure-mapping-long.md`「大纲反推规则」：原文有明确卷界（存在「第一卷」「卷一」等卷级标题）→ 按原文卷界直接划分，无需询问；原文无明确卷界 → 不机械按「每卷 20-40 章」硬切；根据故事线/场景切换/大型时间跳跃检测候选卷边界，向用户展示候选划分方案，等待用户确认后才写定卷纲；用户确认前 `大纲/大纲.md` 只记录候选方案。
71. 卷纲：卷划分确认后，从剧情文件聚合生成 `大纲/卷纲_第X卷.md`，按 `structure-mapping-long.md`「卷纲反推」模板格式。
72. 细纲：从章节摘要反推生成 `大纲/细纲_第XXX章.md`；每章先通过 story-long-write 的 Wordcount Core 运行 `wordcount measure`，将 JSON 的 `actual` 作为已写章节的历史长度快照；这里记录的是原文在 `visible_chars_v1` 下的实际长度，不是让模型重新决定创作目标。
73. 细纲字数测量命令：依次探测 `python3`、`python`、`py -3`；找不到 Python 3 或 CLI 时返回 `TOOL_UNAVAILABLE` 并停止导入，不得用模型估算或静默跳过；运行：`{PYTHON} {story-long-write skill 根}/scripts/storyctl.py wordcount measure --file "{原文章节文件}" --chapter {N}`。
74. 细纲模板：包含核心事件、字数目标（storyctl 返回的 actual）、字数口径 `visible_chars_v1`、目标情绪（未知写 `[待补充]`）、章首钩子 `[待补充]`、爽点（从情节点推断；无明确证据写 `[待补充]`）。
75. 细纲内容概括（五段式）：起因、发展、转折、高潮、结尾（原文最后落在什么动作/画面/台词上；未知写 `[待补充]`）。
76. 细纲情节安排（多线）：主线推进（从剧情单元索引/摘要反推）、辅线推进（无证据写「无」或 `[待补充]`）、事件线/任务线（外部事件链）、感情线/关系线（有证据才写；否则「无显性」或 `[待补充]`）、逻辑线（原因 → 行动 → 结果 → 后果/新问题）。
77. 细纲人物关系和出场顺序：出场顺序（摘要中角色/势力/关键物件出现顺序）、人物关系变化（本章前 → 本章后；未知写 `[待补充]`）、视角/信息差（谁知道什么；读者知道什么；主角误判什么；未知写 `[待补充]`）。
78. 细纲情节细化：情节点序列逐行填表（情节点（谁做了什么）、功能标签、执行边界；功能不明/未知写 `[待补充]`）；行动成本（可无）/收益归属（有证据才写；行动成本可无、不硬造；未知写 `[待补充]`）。
79. 细纲结尾设定和钩子：结尾设定（原文收束落在什么动作或画面；未解决问题；下一章推动力；未知写 `[待补充]`）、章尾钩子 `[待补充]`。
80. 细纲字段规范：钩子、人物关系变化、辅线/感情线、行动成本/收益归属等无法由原文摘要稳定判断的字段统一标 `[待补充]`；story-import 只反推有证据的蓝图，不为补齐字段编造关系或副线。
81. Step 7 追踪文件生成：导入项目必须通过本 skill 自带的 `scripts/tracking_commit.py init` 一次性生成追踪状态，禁止模型分别写最终文件；完整字段与命令见 `references/tracking-transaction.md`。
82. 追踪语义准备 1：导入截止章——把最后完整章 N 写入初始化事务的 `last_chapter`；工具在 meta 记录 `imported_through_chapter=N`；导入旧章没有日更事务，不得为第 1..N 章伪造逐章增量，也不额外生成一份重复当前状态的叙事基线。
83. 追踪语义准备 2：核心角色当前快照——从拆书产物反推主角、反派、核心配角的截至 N 章状态，按角色写入初始化 JSON 的 `character_snapshots`；输出由工具生成到 `追踪/角色状态/{角色名}.md`；算法见 `references/character-state-reverse.md`。
84. 追踪语义准备 3：伏笔当前行——从有正文证据的铺垫/回收事件生成 `foreshadow`；每个 ID 只保留当前状态一行；尚未实际埋设的未来设计留在大纲，不写 `伏笔.md`。
85. 追踪语义准备 4：事实与读者认知——把关键事件生成到 `timeline_events`；同一事件同时写客观事实、读者截至 N 章已知内容和实际揭示状态；未来计划揭示章不得伪装成已发生事实。
86. 追踪语义准备 5：续写状态卡输入——准备当前位置、长期约束、活跃核心角色、近三章速记、下一章承诺和连贯性风险；`上下文.md` 由工具生成固定 7 栏，不把文风、文件索引、普通待办或质检计数塞进续写状态卡。
87. 追踪语义准备 6：执行初始化——按当前平台探测 Python 3（`python3` → `python` → `py -3`），执行：`{PYTHON} {story-import skill 根}/scripts/tracking_commit.py init --project {项目根} --input {初始化事务.json}` 和 `{PYTHON} {story-import skill 根}/scripts/tracking_commit.py check --project {项目根}`。
88. 追踪初始化注意事项：项目 `追踪/` 里已有不属于当前协议的早期文件时不必手工清理；`init` 会先把它们按原样整体移入 `追踪/_旧追踪存档/`，再在原地建当前协议；旧内容保留供作者查阅，不参与解析，当前状态完全由本次导入输入决定；校验失败的 `init` 不移动任何文件。
89. 追踪初始化 demo 示例：以《让你管账号，你高燃混剪炸全网》导入至第 10 章为例，续写状态卡要写清江晨的手机原版《诸君，且听龙吟》被专业团队高清重拍，但高层看片后认为新版「缺了灵魂」，最终继续采用原版；江晨快照应体现其军宣创作价值已获周薄森、张耀祖确认；读者时间线只写读者已经看到的看片会结论，钟嘉嘉「只猜对了一半」背后的培养安排若尚未揭示，只能出现在作者真相，不能泄露到读者视图。
90. 追踪初始化成功后应得到：`追踪/_tracking-state.json`、`追踪/上下文.md`、`追踪/逐章记录/`（导入旧章不补造文件，续写从第 N+1 章开始）、`追踪/角色状态/{角色名}.md`、`追踪/伏笔.md`、`追踪/时间线/作者真相.md`、`追踪/时间线/读者已知.md`。
91. 半成品最后一章为残稿时：`last_chapter`、角色快照和其他当前语义检查点一律截至最后完整章；残稿处理策略写入连贯性风险，不把未完成动作登记成既成事实。
92. Step 8 题材定位生成：从拆文报告中提取核心发现，生成 `设定/题材定位.md`（按 `structure-mapping-long.md`「题材定位生成」模板格式）。
93. 题材定位规范：`设定/题材定位.md` 的本书题材、核心梗、情绪与节奏摘要来自 `拆文库/{导入书名}/`，但这些字段不是对标登记；只有 Phase 1 已明确绑定外部对标时，才追加「对标书清单 + 主对标书」段；主对标书最多 1 本，副对标/参考对标不限制数量；未绑定时省略整个对标登记段，不得用 `{导入书名}` 补位；该段格式见「题材定位生成」模板的「对标书清单」。
94. 题材定位派生概要：后续如需快速概览，可另写「对标分析（派生概要）」表；该表不是权威 registry，不得替代 `主对标书` 与完整 `对标书列表`；所有登记项必须能回溯到对应 `拆文库/{对标书名}/`，不得引用本书根 `设定/`。
95. Step 9 对标结构化资产同步：只处理 Phase 1 显式绑定的外部参考作品；把 `拆文库/{对标书名}/` 的结构化分析资产同步到项目引用视图 `{项目}/对标/{对标书名}/`，供 story-long-write 优先读取；没有绑定外部对标时跳过本步，不创建空目录；严禁使用 `拆文库/{导入书名}/` 或项目 `设定/` 作为复制源；源路径→目标路径的完整同步映射见 `structure-mapping-long.md`「对标引用视图同步规则」。
96. 对标同步缺失处理：已选外部对标缺 `剧情/节奏.md` 或 `剧情/情绪模块.md` → 不登记、不生成半套对标视图；报告 `module_or_rhythm_required_missing` 并提示对 `{对标书名}` 重跑 `/story-long-analyze` Stage 3+；本书核心工程迁移不因此回滚；其它结构化子目录缺失 → 按既有导入缺失项提示，不阻塞项目创建。
97. Step 10 文风同步：外部对标已通过 Step 9 校验时，把 `拆文库/{对标书名}/文风.md` 复制到 `{项目}/对标/{对标书名}/文风.md`；纯复制，不重新生成；未绑定外部对标时跳过。
98. 文风同步缺失处理：拆文库没有文风文件（analyze 未跑 Stage 6）→ 导入报告提示用户重跑 `/story-long-analyze` 后再同步；日更前文风缺失会被 fail-fast 拦截；项目对标已有旧文风文件 → 覆盖（最新拆文产物优先），在导入报告告知。
99. Phase 3-S：将 `拆文库/{导入书名}/` 的短篇拆文产物迁移为 `{短篇标题}/` 短篇工程结构，供 story-short-write Phase 3 逐场景写作无缝接手；迁移规则详见 `references/structure-mapping-short.md`。
100. 短篇目标工程结构：`{短篇标题}/` 下 `设定.md`（含核心框架 + 本书续写基线）、`小节大纲.md`（按段-小节结构反推）、`正文.md`（单文件全文正文）、`对标/{对标书名}/`（可选：仅外部对标引用视图，含 `拆文报告.md`、`情节节点.md`、`写作手法.md`）。
101. 短篇工程与长篇完全不同：短篇正文是单文件 `正文.md`（不切章），不产 `追踪/`、`大纲/`、`正文/` 等长篇目录；迁移时严禁误建这些长篇专属目录。
102. 短篇 Step 1 正文迁移：将 `拆文库/{导入书名}/原文/` 的全文迁移为单文件 `{标题}/正文.md`，按 `format-and-structure.md` 规范化格式（小节标记 `###1.`、段间仅单换行、对话引号按项目/平台约定统一）；原文已是成稿，不重写内容，只规范格式。
103. 短篇 Step 2 设定生成：从 `拆文报告.md`、`写作手法.md` 反推 `{标题}/设定.md`，含两个区块：核心框架（对齐 story-short-write 核心框架模板：基本信息、一句话梗概、核心反转、情绪设计、人设速写）；本书续写基线（把已写内容的故事结构、情绪节奏、核心反转机制、既有写作手法写入续写基线区；这是本书内部上下文，不是对标摘要）。
104. 短篇 Step 3 小节大纲生成：从 `情节节点.md` 的功能分段反推 `{标题}/小节大纲.md`，按开头段/铺垫段/升级段/反转段/结尾段映射；短篇只做轻量蓝图：每节写 `结构段/五段功能`、主事件、一个或多个真实推进、目标情绪、人物/关系变化、因果/逻辑链、结尾承接/小钩子；相关情节点可由同一动作链或对话同时兑现，不为凑数量拆成多个子事件；钩子或关系无法判断时标 `[待补充]`，不套用长篇完整章节蓝图。
105. 短篇 Step 4 外部对标引用视图（可选）：仅当 Phase 1 已显式绑定外部 `{对标书名}` 时，才把 `拆文库/{对标书名}/` 同步为 `{标题}/对标/{对标书名}/`；没有绑定则跳过；不得把 `拆文库/{导入书名}/` 整体复制进 `对标/`。
106. Phase 4 Step 1 质量检查：按篇幅对照对应的质量检查清单；长篇完整导入质量清单见 `references/structure-mapping-long.md` 末尾（含正文文件数对照、核心角色独立快照、作者/读者时间线隔离、`tracking_commit.py check` 通过、卷划分已经用户确认等）；短篇质量清单见 `references/structure-mapping-short.md` 末尾的质量检查清单（含 `正文.md` 单文件存在且格式合规、`设定.md` 含核心框架+本书续写基线、未误建长篇专属目录等）。
107. Phase 4 Step 2 缺失项提示：输出导入结果摘要和待补充项，按篇幅分支；长篇导入完成报告包含书名、源文件、项目目录、已生成文件（正文、角色文件、大纲、追踪、设定、外部对标）、待补充项（细纲钩子、题材定位核心梗三分法、伏笔复核、读者已知时间线未泄露作者真相、卷划分已确认、拆文库未被复制到对标、外部对标登记正确）和下一步操作（`/story-review lean`、`/story-long-write` + '日更'）。
108. 短篇导入完成报告包含标题、源文件、项目目录、已生成文件（正文.md、设定.md、小节大纲.md、外部对标）、待补充项（所有 `[待补充]` 标记复核、小节大纲钩子、核心反转铺垫线索）和下一步操作（`/story-short-write` Phase 3）。
109. Phase 4 Step 3 项目激活：设置 `.active-book` 指向导入的书名/标题目录；确认项目可以被对应写作 skill 识别（长篇 → story-long-write，短篇 → story-short-write）。
110. 可选验证：如果当前运行时的 canonical 目录已部署 story-explorer agent，可 spawn 交叉验证迁移数据完整性；Antigravity 检查 `.agents/agents/story-explorer/agent.md` 并用 `invoke_subagent` + `TypeName: "story-explorer"`；Prompt：`项目目录：{dir}\n查询类型：progress\n查询参数：导入验证`；setup 环境检测已在 Phase 1 完成，此处不再重复检测。
111. 大型作品处理（>200 章，仅适用于长篇导入）：拆解可以分批，追踪初始化必须一次覆盖全部已写章节。
112. 大型作品拆解分批：首期只深拆前 50 章 + 全书概要，后续按需补拆更多章节到 `拆文库/`。
113. 大型作品追踪一次到位：初始化事务的 `last_chapter` 写最后一个已写完的章号 N，不是首期拆解的 50；`imported_through_chapter` 由 `init` 一次写定、之后不再推进，逐章事务只接受 N+1 起的章号；第 1..N 章不伪造逐章记录，续写从 N+1 开始；若 init 时误写成 50，第 51..N 章仍可逐章 `append` 补上（一章一份事务，章号必须连续），只是要为已写好的旧章逐章构造事务；不要删 `追踪/` 重来——`_旧追踪存档/` 也在里面。
114. 大型作品上下文摘要：未深拆的章节生成简化摘要（200 字/章），供反推当前状态用。
115. 流程衔接：导入完想继续写（长篇）→ `/story-long-write` + '日更'；短篇 → `/story-short-write`；导入完想审查质量 → `/story-review`；想深入分析对标（长篇）→ `/story-long-analyze`；短篇 → `/story-short-analyze`；从零开新书（长篇）→ `/story-long-write` + '开书'；短篇 → `/story-short-write`；项目未部署环境 → `/story-setup`。
116. 语言：跟随用户的语言回复；中文回复遵循《中文文案排版指北》。

适用边界 · 注意事项

• 只想获得拆文库分析、不需要可续写写作工程时，不要走完整导入迁移，直接运行 `/story-long-analyze` 或 `/story-short-analyze`。
• 项目未部署 story-setup 基础设施且无法接受 Phase 2 串行降级时，应先运行 `/story-setup` 再导入。
• 短篇导入时不要误建 `追踪/`、`大纲/`、`正文/` 等长篇专属目录。