Project Initialization (Deep Mode)

目标

通过结构化交互收集足够信息，避免“先生成再返工”。
产出可落地项目骨架：.webnovel/state.json、设定集/*、大纲/总纲.md、.webnovel/idea_bank.json。
保证后续 /webnovel-plan 与 /webnovel-write 可直接运行。

执行原则

先收集，再生成；未过充分性闸门，不执行 init_project.py。
分波次提问，每轮只问“当前缺失且会阻塞下一步”的信息。
允许调用 Read/Grep/Bash/Task/AskUserQuestion/WebSearch/WebFetch 辅助收集。
用户已明确的信息不重复问；冲突信息优先让用户裁决。
Deep 模式优先完整性，允许慢一点，但禁止漏关键字段。

引用加载等级（strict, lazy）

采用分级加载，避免一次性灌入全部资料：

L0：未确认任务前，不预加载参考。
L1：每个阶段仅加载该阶段“必读”文件。
L2：仅在题材、金手指、创意约束触发条件满足时加载扩展参考。
L3：市场趋势类、时效类资料仅在用户明确要求时加载。

路径约定：

references/... 相对当前 skill 目录（${CLAUDE_PLUGIN_ROOT}/skills/webnovel-init/references/...）。
templates/... 相对插件根目录（${CLAUDE_PLUGIN_ROOT}/templates/...）。

默认加载清单：

L1（启动前）：references/genre-tropes.md
L2（按需）：
- 题材模板：templates/genres/{genre}.md
- 金手指：../../templates/golden-finger-templates.md
- 世界观：references/worldbuilding/faction-systems.md
- 创意约束：按下方“逐文件引用清单”触发加载
L3（显式请求）：
- references/creativity/market-trends-2026.md

References（逐文件引用清单）

根目录

references/genre-tropes.md
- 用途：Step 1 题材归一化、题材特征提示。
- 触发：所有项目必读。
references/system-data-flow.md
- 用途：初始化产物与后续 /plan、/write 的数据流一致性检查。
- 触发：Step 0 预检必读。

worldbuilding

references/worldbuilding/character-design.md
- 用途：Step 2 角色维度补问（目标、缺陷、动机、反差）。
- 触发：用户人物信息抽象或扁平时加载。
references/worldbuilding/faction-systems.md
- 用途：Step 4 势力格局与组织层级设计。
- 触发：Step 4 默认加载。
references/worldbuilding/power-systems.md
- 用途：Step 4 力量体系类型与边界定义。
- 触发：涉及修仙/玄幻/高武/异能时加载。
references/worldbuilding/setting-consistency.md
- 用途：Step 6 一致性复述前做设定冲突检查。
- 触发：Step 6 默认加载。
references/worldbuilding/world-rules.md
- 用途：Step 4 世界规则与禁忌项收束。
- 触发：Step 4 默认加载。

creativity

references/creativity/creativity-constraints.md
- 用途：Step 5 创意约束包主 schema。
- 触发：Step 5 必读。
references/creativity/category-constraint-packs.md
- 用途：Step 5 按平台/题材选择约束包模板。
- 触发：Step 5 必读。
references/creativity/creative-combination.md
- 用途：复合题材（A+B）融合规则。
- 触发：用户选择复合题材时加载。
references/creativity/inspiration-collection.md
- 用途：用户卡住时提供卖点/钩子候选。
- 触发：Step 1 或 Step 5 卡顿时加载。
references/creativity/selling-points.md
- 用途：Step 5 卖点生成与筛选。
- 触发：Step 5 必读。
references/creativity/market-positioning.md
- 用途：目标读者/平台定位与商业化语义统一。
- 触发：Step 1 用户提及平台或商业目标时加载。
references/creativity/market-trends-2026.md
- 用途：时间敏感市场趋势参考。
- 触发：仅用户明确要求“参考当下趋势”时加载。
references/creativity/anti-trope-xianxia.md
- 用途：反套路库（修仙/玄幻/高武/西幻）。
- 触发：题材命中对应映射时加载。
references/creativity/anti-trope-urban.md
- 用途：反套路库（都市/历史）。
- 触发：题材命中对应映射时加载。
references/creativity/anti-trope-game.md
- 用途：反套路库（游戏/科幻/末世）。
- 触发：题材命中对应映射时加载。
references/creativity/anti-trope-rules-mystery.md
- 用途：反套路库（规则/悬疑/灵异/克苏鲁）。
- 触发：题材命中对应映射时加载。

工具策略（按需）

Read/Grep：读取项目上下文与参考文件（README.md、CLAUDE.md、templates/genres/*、references/*）。
Bash：执行 init_project.py、文件存在性检查、最小验证命令。
Task：拆分并行子任务（如题材映射、约束包候选生成、文件验证）。
AskUserQuestion：用于关键分歧裁决、候选方案选择、最终确认。
WebSearch：用于检索最新市场趋势、平台风向、题材数据（可带域名过滤）。
WebFetch：用于抓取已确定来源页面内容并做事实核验。
外部检索触发条件：
- 用户明确要求参考市场趋势或平台风向；
- 创意约束需要“时间敏感依据”；
- 对题材信息存在明显不确定。

交互流程（Deep）

Step 0：预检与上下文加载

环境设置（bash 命令执行前）：

export WORKSPACE_ROOT="${CLAUDE_PROJECT_DIR:-$PWD}"

if [ -z "${CLAUDE_PLUGIN_ROOT}" ] || [ ! -d "${CLAUDE_PLUGIN_ROOT}/scripts" ]; then
  echo "ERROR: 未设置 CLAUDE_PLUGIN_ROOT 或缺少目录: ${CLAUDE_PLUGIN_ROOT}/scripts" >&2
  exit 1
fi
export SCRIPTS_DIR="${CLAUDE_PLUGIN_ROOT}/scripts"

必须做：

确认当前目录可写。
解析脚本目录并确认入口存在（仅支持插件目录）：
- 固定路径：${CLAUDE_PLUGIN_ROOT}/scripts
- 入口脚本：${SCRIPTS_DIR}/webnovel.py
建议先打印解析结果，避免写到错误目录：
- python "${SCRIPTS_DIR}/webnovel.py" --project-root "${WORKSPACE_ROOT}" where
加载最小参考：
- references/system-data-flow.md（用于校对 init 产物与 plan/write 输入链路）
- references/genre-tropes.md
- templates/genres/（仅在用户选定题材后按需读取）

输出：

进入 Deep 采集前的“已知信息清单”和“待收集清单”。

Step 1：故事核与商业定位

收集项（必收）：

书名（可先给工作名）
题材（支持 A+B 复合题材）
目标规模（总字数或总章数）
一句话故事
核心冲突
目标读者/平台

题材集合（用于归一化与映射）：

玄幻修仙类：修仙 | 系统流 | 高武 | 西幻 | 无限流 | 末世 | 科幻
都市现代类：都市异能 | 都市日常 | 都市脑洞 | 现实题材 | 黑暗题材 | 电竞 | 直播文
言情类：古言 | 宫斗宅斗 | 青春甜宠 | 豪门总裁 | 职场婚恋 | 民国言情 | 幻想言情 | 现言脑洞 | 女频悬疑 | 狗血言情 | 替身文 | 多子多福 | 种田 | 年代
特殊题材：规则怪谈 | 悬疑脑洞 | 悬疑灵异 | 历史古代 | 历史脑洞 | 游戏体育 | 抗战谍战 | 知乎短篇 | 克苏鲁

交互方式：

优先让用户自由描述，再二次结构化确认。
若用户卡住，给 2-4 个候选方向供选。

Step 2：角色骨架与关系冲突

收集项（必收）：

主角姓名
主角欲望（想要什么）
主角缺陷（会害他付代价的缺陷）
主角结构（单主角/多主角）
感情线配置（无/单女主/多女主）
反派分层（小/中/大）与镜像对抗一句话

收集项（可选）：

主角原型标签（成长型/复仇型/天才流等）
多主角分工

Step 3：金手指与兑现机制

收集项（必收）：

金手指类型（可为“无金手指”）
名称/系统名（无则留空）
风格（硬核/诙谐/黑暗/克制等）
可见度（谁知道）
不可逆代价（必须有代价或明确“无+理由”）
成长节奏（慢热/中速/快节奏）

收集项（条件必收）：

若为系统流：系统性格、升级节奏
若为重生：重生时间点、记忆完整度
若为传承/器灵：辅助边界与出手限制

Step 4：世界观与力量规则

收集项（必收）：

世界规模（单城/多域/大陆/多界）
力量体系类型
势力格局
社会阶层与资源分配

收集项（题材相关）：

货币体系与兑换规则
宗门/组织层级
境界链与小境界

Step 5：创意约束包（差异化核心）

流程：

基于题材映射加载反套路库（最多 2 个主相关库）。
生成 2-3 套创意包，每套包含：
- 一句话卖点
- 反套路规则 1 条
- 硬约束 2-3 条
- 主角缺陷驱动一句话
- 反派镜像一句话
- 开篇钩子
三问筛选：
- 为什么这题材必须这么写？
- 换成常规主角会不会塌？
- 卖点能否一句话讲清且不撞模板？
展示五维评分（详见 references/creativity/creativity-constraints.md 的 8.1 五维评分），辅助用户决策。
用户选择最终方案，或拒绝并给出原因。

备注：

若用户要求“贴近当下市场”，可触发外部检索并标注时间戳。

Step 6：一致性复述与最终确认

必须输出“初始化摘要草案”并让用户确认：

故事核（题材/一句话故事/核心冲突）
主角核（欲望/缺陷）
金手指核（能力与代价）
世界核（规模/力量/势力）
创意约束核（反套路 + 硬约束）

确认规则：

用户未明确确认，不执行生成。
若用户仅改局部，回到对应 Step 最小重采集。

内部数据模型（初始化收集对象）

{
  "project": {
    "title": "",
    "genre": "",
    "target_words": 0,
    "target_chapters": 0,
    "one_liner": "",
    "core_conflict": "",
    "target_reader": "",
    "platform": ""
  },
  "protagonist": {
    "name": "",
    "desire": "",
    "flaw": "",
    "archetype": "",
    "structure": "单主角"
  },
  "relationship": {
    "heroine_config": "",
    "heroine_names": [],
    "heroine_role": "",
    "co_protagonists": [],
    "co_protagonist_roles": [],
    "antagonist_tiers": {},
    "antagonist_level": "",
    "antagonist_mirror": ""
  },
  "golden_finger": {
    "type": "",
    "name": "",
    "style": "",
    "visibility": "",
    "irreversible_cost": "",
    "growth_rhythm": ""
  },
  "world": {
    "scale": "",
    "factions": "",
    "power_system_type": "",
    "social_class": "",
    "resource_distribution": "",
    "currency_system": "",
    "currency_exchange": "",
    "sect_hierarchy": "",
    "cultivation_chain": "",
    "cultivation_subtiers": ""
  },
  "constraints": {
    "anti_trope": "",
    "hard_constraints": [],
    "core_selling_points": [],
    "opening_hook": ""
  }
}

充分性闸门（必须通过）

未满足以下条件前，禁止执行 init_project.py：

书名、题材（可复合）已确定。
目标规模可计算（字数或章数至少一个）。
主角姓名 + 欲望 + 缺陷完整。
世界规模 + 力量体系类型完整。
金手指类型已确定（允许“无金手指”）。
创意约束已确定：
- 反套路规则 1 条
- 硬约束至少 2 条
- 或用户明确拒绝并记录原因。

项目目录安全规则（必须）

project_root 必须由书名安全化生成（去非法字符，空格转 -）。
若安全化结果为空或以 . 开头，自动前缀 proj-。
禁止在插件目录下生成项目文件（${CLAUDE_PLUGIN_ROOT}）。

执行生成

1) 运行初始化脚本

python "${SCRIPTS_DIR}/webnovel.py" init \
  "{project_root}" \
  "{title}" \
  "{genre}" \
  --protagonist-name "{protagonist_name}" \
  --target-words {target_words} \
  --target-chapters {target_chapters} \
  --golden-finger-name "{gf_name}" \
  --golden-finger-type "{gf_type}" \
  --golden-finger-style "{gf_style}" \
  --core-selling-points "{core_points}" \
  --protagonist-structure "{protagonist_structure}" \
  --heroine-config "{heroine_config}" \
  --heroine-names "{heroine_names}" \
  --heroine-role "{heroine_role}" \
  --co-protagonists "{co_protagonists}" \
  --co-protagonist-roles "{co_protagonist_roles}" \
  --antagonist-tiers "{antagonist_tiers}" \
  --world-scale "{world_scale}" \
  --factions "{factions}" \
  --power-system-type "{power_system_type}" \
  --social-class "{social_class}" \
  --resource-distribution "{resource_distribution}" \
  --gf-visibility "{gf_visibility}" \
  --gf-irreversible-cost "{gf_irreversible_cost}" \
  --currency-system "{currency_system}" \
  --currency-exchange "{currency_exchange}" \
  --sect-hierarchy "{sect_hierarchy}" \
  --cultivation-chain "{cultivation_chain}" \
  --cultivation-subtiers "{cultivation_subtiers}" \
  --protagonist-desire "{protagonist_desire}" \
  --protagonist-flaw "{protagonist_flaw}" \
  --protagonist-archetype "{protagonist_archetype}" \
  --antagonist-level "{antagonist_level}" \
  --target-reader "{target_reader}" \
  --platform "{platform}"

2) 写入 `idea_bank.json`

写入 .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": ""
  }
}

3) Patch 总纲

必须补齐：

故事一句话
核心主线 / 核心暗线
创意约束（反套路、硬约束、主角缺陷、反派镜像）
反派分层
关键爽点里程碑（2-3 条）

验证与交付

执行检查：

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"

成功标准：

state.json 存在且关键字段不为空（title/genre/target_words/target_chapters）。
设定集核心文件存在：世界观.md、力量体系.md、主角卡.md、金手指设计.md。
总纲.md 已填核心主线与约束字段。
idea_bank.json 已写入且与最终选定方案一致。

失败处理（最小回滚）

触发条件：

关键文件缺失；
总纲关键字段缺失；
约束启用但 idea_bank.json 缺失或内容不一致。

恢复流程：

仅补缺失字段，不全量重问。
仅重跑最小步骤：
- 文件缺失 -> 重跑 init_project.py；
- 总纲缺字段 -> 只 patch 总纲；
- idea_bank 不一致 -> 只重写该文件。
重新验证，全部通过后结束。

webnovel-init

Project Initialization (Deep Mode)

目标

执行原则

引用加载等级（strict, lazy）

References（逐文件引用清单）

根目录

worldbuilding

creativity

工具策略（按需）

交互流程（Deep）

Step 0：预检与上下文加载

Step 1：故事核与商业定位

Step 2：角色骨架与关系冲突

Step 3：金手指与兑现机制

Step 4：世界观与力量规则

Step 5：创意约束包（差异化核心）

Step 6：一致性复述与最终确认

内部数据模型（初始化收集对象）

充分性闸门（必须通过）

项目目录安全规则（必须）

执行生成

1) 运行初始化脚本

2) 写入 idea_bank.json

3) Patch 总纲

验证与交付

失败处理（最小回滚）

2) 写入 `idea_bank.json`