需要深度初始化网文项目、避免先生成后返工时…

适用于使用 webnovel-init 深度模式从零初始化网文项目，并在生成前收集充分创作信息、确认创意约束与项目目录安全。

适用场景

解决思路

1. 以结构化交互收集足够信息，避免“先生成再返工”。
2. 产出可落地骨架：`.webnovel/state.json`、`设定集/*`、`大纲/总纲.md`、`.webnovel/idea_bank.json`、`.story-system/MASTER_SETTING.json`。
3. 保证后续 `/webnovel-plan` 与 `/webnovel-write` 可直接运行。
4. 先收集，再生成；未过充分性闸门，不执行 `webnovel.py init`。
5. 分波次提问，每轮只问“当前缺失且会阻塞下一步”的信息；用户已明确的不重复问，冲突让用户裁决。
6. 参考书拆解只返回结构化结果；用户确认前不得写入 `idea_bank.json`、`.story-system`、`设定集`、`大纲`、`正文`、`.webnovel/state.json` 或任何 canon/read model 文件。
7. 引用加载时，`references/` 指 `skills/webnovel-init/references/`；`../../references/` 指共享 references；详细采集字段见 `references/init-collection-schema.md`，按需区段读、逐项收集，必填项以“充分性闸门”为准。
8. Step 1 始终读取 `references/system-data-flow.md`、`references/genre-tropes.md`。
9. 题材/卖点采集时读取 `../../references/genre-profiles.md`，只读当前 genre 段。
10. 角色卡顿时读取 `references/worldbuilding/character-design.md`。
11. 世界观/力量按需读取 `references/worldbuilding/faction-systems.md`、`references/worldbuilding/power-systems.md`、`references/worldbuilding/world-rules.md`、`references/worldbuilding/setting-consistency.md`。
12. Step 6 创意约束读取 `references/creativity/creativity-constraints.md` 的 `## 一、创意包 Schema (Idea Package)`、`## 六、硬约束驱动创意 (Hard Constraints)`、`## 八、评分系统 (Scoring System)`，评分展示读 `### 8.1 五维评分`；读取 `references/creativity/selling-points.md` 的 `## 9. 核心卖点定位模板` 骨架，按需补 `### 1.3 核心卖点黄金公式`、`## 7. 实战检查清单`。
13. 复合题材读 `creative-combination.md`；卡顿读 `inspiration-collection.md`；题材命中读 `anti-trope-*.md`。
14. 开始命名时运行 `python -X utf8 ${SCRIPTS_DIR}/reference_search.py --skill init --table 命名规则 --query 命名对象 题材 --genre 题材`。
15. 按需读取长细则（创意约束、反套路库、世界观设计指南、卖点模板），不内联其条目。
16. 用 `Read/Grep` 读项目上下文与参考文件。
17. 用 `Bash` 执行 `webnovel.py init`、文件存在性检查、最小验证。
18. 用 `Agent` 拆分并行子任务；Step 1.5 用户选择参考书拆解作灵感来源时调用 `webnovel-writer:deconstruction-agent`。
19. 用 `AskUserQuestion` 做关键分歧裁决、候选选择、最终确认。
20. 仅在用户要求市场趋势/平台风向、创意约束需时间敏感依据、或题材信息明显不确定时使用 `WebSearch`/`WebFetch`，先 search 后 fetch 核验。
21. Step 1 设置环境：`export WORKSPACE_ROOT=${CLAUDE_PROJECT_DIR:-$PWD}`；检查 `CLAUDE_PLUGIN_ROOT` 与 `${CLAUDE_PLUGIN_ROOT}/scripts` 存在，否则报错退出；设置 `SCRIPTS_DIR=${CLAUDE_PLUGIN_ROOT}/scripts`。
22. Step 1 确认当前目录可写；确认入口脚本 `${SCRIPTS_DIR}/webnovel.py` 存在（仅支持插件目录）。
23. 初始化前不要用 `where` 把 `WORKSPACE_ROOT` 解析成书项目根；新项目尚不存在时 `where` 可能命中旧指针或旧项目。
24. 只打印工作区与脚本目录，确认生成目标将在工作区下的书名安全化子目录中。
25. 加载最小参考：`references/system-data-flow.md`、`references/genre-tropes.md`；`templates/genres/` 仅在选定题材后按需读取。
26. 输出进入 Deep 采集前的“已知信息清单”和“待收集清单”。
27. Step 1.5 进入故事核采集前，必须先用 `AskUserQuestion` 或直接提问确认用户是否提供灵感来源；不要默认拆书，也不要把参考作品当作必填项。
28. Step 1.5 使用建议询问文案：你这本书的灵感来源想从哪里开始？可以直接说原创想法，也可以提供参考作品做拆书提炼。若要拆书，请给参考书名+平台，并尽量提供章节摘录或文本路径；没有参考也可以直接跳过。
29. Step 1.5 可接受来源：原创想法、参考作品拆书（书名/平台/章节摘录/文本路径）、市场趋势、题材模板/反套路库/已有脑洞片段。
30. 当用户选择参考作品拆书且提供文本路径或章节摘录时，必须使用 `Agent` 工具调用 `webnovel-writer:deconstruction-agent`，不得由 init 主流程口头替代拆解结果。
31. 调用拆解 Agent 时传 Prompt：`reference_title={reference_title}; reference_source={reference_source}; reference_text_path={reference_text_path}; reference_text_excerpt={reference_text_excerpt}; analysis_mode={quick|deep|auto}; init_goal={当前初始化故事方向或空}; target_genre={题材或空}`；要求只返回 `init_reference_research` JSON 对象，不写任何文件，不创建目录，不写 `.story-system`、`.webnovel`、设定集、大纲、正文、`idea_bank.json`、`state.json` 或任何 canon/read model 文件。
32. 调用后主流程必须记录一份 `SubagentRun` 汇总（仅供最终报告使用，不写入 canon）：包含 `name`、`user_label`、`status`、`problems`、`auto_handled`、`needs_user_action`、`duration_ms`、`outputs`。
33. 当 `quality.passed=false`、`confidence < 0.85`、输入不足、文本不可读、降级 quick mode 或输出不完整时，必须写入 `problems`，并让最终报告进入“建议确认 / 必须处理”。
34. 处理参考拆解时，只有书名/平台、无文本或摘录时，先问能否提供摘录/路径；不能提供则把参考书仅作“方向线索”，不得编造其黄金三章、角色、设定或剧情事实。
35. 接收返回的 `init_reference_research` JSON 后，只使用 `reader_promise`、`opening_hook_patterns`、`cool_point_loops`、`protagonist_patterns`、`antagonist_pressure_patterns`、`pacing_notes`、`borrowable_structures`、`differentiation_requirements`、`init_candidates`、`quality`。
36. 先检查 `quality`：`quality.passed=false`、`confidence < 0.85` 或 `warnings` 非空时，不得把候选折叠进创意约束包，只能把风险和需补充材料展示给用户确认。
37. 将 `do_not_copy` 和 `canon_contamination_warnings` 进入已知信息清单，作为后续创意生成红线。
38. Step 2-6 只能使用用户确认过、并已变形为本书差异化表达的模式；禁止把参考书角色、设定、组织、地点、金手指、剧情事实原样写入生成项目文件。
39. Step 2 必收：书名、题材（支持 A+B 复合）、目标规模（总字数或总章数）、一句话故事、核心冲突、目标读者/平台。
40. Step 2 将 canonical 题材集合写入 `project_info.genre`：都市、玄幻、仙侠、奇幻、科幻、历史、悬疑、游戏、古言、现言、幻言、年代、种田、快穿、衍生。
41. Step 2 可自由输入细分 preset / 套路 / 形式，初始化脚本会映射到 canonical 并按 taxonomy 加载模板（示例：修仙、系统流、规则怪谈、宫斗宅斗、电竞、末世）；优先让用户自由描述再二次结构化确认；卡住时给 2-4 个候选方向。
42. Step 3 必收：主角姓名、主角欲望、主角缺陷（会害他付代价）、主角结构（单/多主角）、感情线配置（无/单女主/多女主）、反派分层（小/中/大）与镜像对抗一句话；可选主角原型标签、多主角分工。
43. Step 4 必收：金手指类型（可为“无金手指”）、名称/系统名（无则留空）、风格、可见度、不可逆代价（必须有代价或明确“无+理由”）、成长节奏。
44. Step 4 条件必收：系统流给系统性格+升级节奏；重生给重生时间点+记忆完整度；传承/器灵给辅助边界+出手限制。
45. Step 5 必收：世界规模（单城/多域/大陆/多界）、力量体系类型、势力格局、社会阶层与资源分配。
46. Step 5 题材相关收：货币体系与兑换规则、宗门/组织层级、境界链与小境界。
47. Step 6 流程 1：汇总 Step 1.5 已确认的灵感来源：原创想法、参考拆书结果、市场趋势、题材模板或反套路库。
48. Step 6 流程 2：基于题材映射加载反套路库（最多 2 个主相关库）。
49. Step 6 流程 3：生成 2-3 套创意包，每套含一句话卖点、反套路规则 1 条、硬约束 2-3 条、主角缺陷驱动一句话、反派镜像一句话、开篇钩子。
50. Step 6 流程 4：三问筛选：为什么这题材必须这么写？换常规主角会不会塌？卖点能否一句话讲清且不撞模板？
51. Step 6 流程 5：展示五维评分（详见 `references/creativity/creativity-constraints.md` 的 `8.1 五维评分`）辅助决策。
52. Step 6 流程 6：用户选择最终方案，或拒绝并给出原因。
53. Step 6 备注：若用户要求“贴近当下市场”，可触发外部检索并标注时间戳。
54. Step 6 备注：若使用了参考拆解，展示候选时必须标明参考来源、转换方式、不可复制项和差异化要求；用户未明确确认前，不写入 `idea_bank.json` 或任何生成项目文件。
55. Step 7 必须输出“初始化摘要草案”并让用户确认：故事核（题材/一句话故事/核心冲突）、主角核（欲望/缺陷）、金手指核（能力与代价）、世界核（规模/力量/势力）、创意约束核（反套路+硬约束）。
56. Step 7 确认规则：用户未明确确认，不执行生成；用户仅改局部，回到对应 Step 最小重采集。
57. 充分性闸门：未满足以下条件前，禁止执行 `webnovel.py init`：书名、题材（可复合）已确定。
58. 充分性闸门：目标规模可计算（字数或章数至少一个）。
59. 充分性闸门：主角姓名 + 欲望 + 缺陷完整。
60. 充分性闸门：世界规模 + 力量体系类型完整。
61. 充分性闸门：金手指类型已确定（允许“无金手指”）。
62. 充分性闸门：创意约束已确定：反套路规则 1 条 + 硬约束至少 2 条，或用户明确拒绝并记录原因。
63. 项目目录安全：`project_root` 必须由书名安全化生成：`PROJECT_ROOT=${WORKSPACE_ROOT}/${PROJECT_SLUG}`；安全化结果为空或以 `.` 开头时自动前缀 `proj-`。
64. 项目目录安全：禁止在插件目录（`${CLAUDE_PLUGIN_ROOT}`）下生成项目文件；禁止直接把 `WORKSPACE_ROOT` 当作 `PROJECT_ROOT`，除非用户明确指定当前目录就是书项目根。
65. 项目目录安全：初始化前必须展示并确认 `WORKSPACE_ROOT`、`PROJECT_SLUG`、`PROJECT_ROOT`。
66. 项目目录安全：运行书名安全化脚本生成 `PROJECT_SLUG`，再设置 `PROJECT_ROOT` 并打印 `WORKSPACE_ROOT`、`PROJECT_SLUG`、`PROJECT_ROOT`。
67. 执行生成 1：参数全部来自采集对象（书名/题材/主角/金手指/世界观/反派/创意约束等），逐字段映射为 `webnovel.py init` 的 `--*` 选项；完整字段清单见 `references/init-collection-schema.md`，可用 `python ${SCRIPTS_DIR}/webnovel.py init --help` 核对选项名。
68. 执行生成 1：运行 `webnovel.py init`，传入 `PROJECT_ROOT`、`title`、`genre`，并追加 `--protagonist-name`、`--target-words`、`--target-chapters`、`--protagonist-desire`、`--protagonist-flaw`、`--golden-finger-type`、`--gf-irreversible-cost`、`--world-scale`、`--power-system-type`、`--core-selling-points` 等采集字段对应选项。
69. 执行生成 2：写入 `.webnovel/idea_bank.json`，内容必须与最终选定方案一致；结构包含 `selected_idea`（`title`、`one_liner`、`anti_trope`、`hard_constraints`）和 `constraints_inherited`（`anti_trope`、`hard_constraints`、`protagonist_flaw`、`antagonist_mirror`、`opening_hook`）。
70. 执行生成 3：Patch `大纲/总纲.md`，必须补齐：故事一句话、核心主线/暗线、创意约束（反套路、硬约束、主角缺陷、反派镜像）、反派分层、关键爽点里程碑（2-3 条）。
71. 执行生成 4：init 完成后立即生成 MASTER_SETTING，让后续 plan 有调性/禁忌参照；此处不传 `--chapter`（只生成 `MASTER_SETTING.json` 和 `anti_patterns.json`），也不传 `--emit-runtime-contracts`（还没有卷/章级数据）；plan 拆到具体章节时再生成 volume/chapter/review 合同。
72. 执行生成 4：从 `.webnovel/state.json` 提取 `GENRE`，再运行 `webnovel.py --project-root ${PROJECT_ROOT} story-system ${GENRE} --genre ${GENRE} --persist --format json`。
73. 验证：运行 `test -f ${PROJECT_ROOT}/.webnovel/state.json`；`find ${PROJECT_ROOT}/设定集 -maxdepth 1 -type f -name *.md`；`test -f ${PROJECT_ROOT}/大纲/总纲.md`；`test -f ${PROJECT_ROOT}/.webnovel/idea_bank.json`；`test -f ${PROJECT_ROOT}/.story-system/MASTER_SETTING.json`；`test $(basename ${PROJECT_ROOT}) = ${PROJECT_SLUG}`。
74. 成功标准：`state.json` 存在且 title/genre/target_words/target_chapters 不为空。
75. 成功标准：设定集核心文件存在：`世界观.md`、`力量体系.md`、`主角卡.md`；单主角不生成 `主角组.md`，`heroine_config=无女主` 不生成 `女主卡.md`。
76. 成功标准：默认不生成 `金手指设计.md`、`复合题材-融合逻辑.md`、`爽点规划.md` 或空目录；这些以主角卡、世界观、卷纲为事实源。
77. 成功标准：`总纲.md` 已填核心主线与约束字段；`idea_bank.json` 已写入且与最终选定方案一致。
78. 成功标准：`.story-system/MASTER_SETTING.json` 存在且 `route.primary_genre` 非空。
79. 失败处理触发：关键文件缺失；总纲关键字段缺失；约束启用但 `idea_bank.json` 缺失或不一致。
80. 失败处理恢复：只补缺失字段，不全量重问；只重跑最小步骤（文件缺失→重跑 `webnovel.py init`；总纲缺字段→只 patch 总纲；idea_bank 不一致→只重写该文件）；重新验证，全部通过后结束。
81. 作者友好过程提示：初始化开始前先说明本次会经历：收集故事核心 -> 确认创意约束 -> 生成项目骨架 -> 写入初始故事档案 -> 验证能否进入规划；过程提示用作者语言，不直接输出原始 JSON、traceback 或长命令日志；技术详情写入 `.webnovel/logs/run_last.log`。
82. 过程日志：运行 `webnovel.py --project-root ${PROJECT_ROOT} run-log --event init-progress --payload-json {stage:init} --format text`。
83. 过程提示每次不超过两行，只说当前动作和影响，例如“正在生成项目骨架：会创建设定集、总纲和初始故事档案”；少打扰确认策略：默认继续收集和生成；只有核心设定、参考拆解采用、项目目录安全、写入 canon 前的最终方案需要用户拍板。
84. 需要用户裁决时使用有限选项，并说明每个选项影响；例如保留当前设定 / 修改局部 / 暂停初始化；卡住时必须说明卡点、已完成内容和恢复建议，例如“设定集已生成，Story System 初始档案缺失；重新运行 `/webnovel-init` 会只补缺失文件”。
85. 不可恢复故障才在最终报告提示 `.webnovel/logs/run_last.log`；平时只保留日志，不打扰作者；收尾必须调用 `webnovel.py --project-root ${PROJECT_ROOT} user-report --stage init --format text`。
86. 作者友好最终报告：最终回复必须面向作者，不输出原始 JSON、traceback 或长命令日志；使用固定三段式，并以一句总状态开头：总状态：已完成 / 部分完成 / 需要你处理 / 未完成；一、产生的文件与完成情况；二、过程中遇到的问题与异常耗时（已自动处理/建议确认/必须处理）；三、下一步建议。
87. 最终报告必须汇报：项目目录、`.webnovel/state.json`、`.webnovel/idea_bank.json`；`设定集/世界观.md`、`设定集/力量体系.md`、`设定集/主角卡.md`、`设定集/反派设计.md`；`大纲/总纲.md`、`.story-system/MASTER_SETTING.json`；是否使用参考作品拆解；用户确认前未写入 canon 的情况；缺失信息是否影响后续 `/webnovel-plan`。
88. 异常分类：已自动处理=脚本补齐目录、重跑最小初始化步骤、重新生成缺失的非内容文件等；建议确认=参考拆解质量略低、候选创意需用户再看一眼；必须处理=核心设定未确认、项目目录不安全、关键文件仍缺失。
89. 下一步建议必须使用任务化语言 + 可复制命令，例如“接下来可以规划第一卷：`/webnovel-plan 1`”；不写 token 统计；如需排查故障，只给日志路径或建议运行 `/webnovel-doctor`。

适用边界 · 注意事项

• 不适用于没有 webnovel 插件、CLAUDE_PLUGIN_ROOT、SCRIPTS_DIR 或 webnovel.py 脚本的环境，因为初始化与后续生成依赖这些工具。
• 不适用于只想一次性快速生成、不愿分阶段交互确认核心设定和创意约束的项目。
• 不适用于非网文项目，或不需要 .webnovel、设定集、大纲、.story-system 等 canon/read model 文件体系的创作流程。