Project Initialization (Deep Mode)

目标

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

执行原则

先收集，再生成；未过充分性闸门，不执行 init_project.py。
分波次提问，每轮只问"当前缺失且会阻塞下一步"的信息。
允许调用 Read/Grep/Bash/Agent/AskUserQuestion/WebSearch/WebFetch 辅助收集。
用户已明确的信息不重复问；冲突信息优先让用户裁决。
Deep 模式优先完整性，允许慢一点，但禁止漏关键字段。
参考书拆解只返回结构化结果给 init 主流程；用户确认前不得写入 idea_bank.json、.story-system、设定集、大纲、正文、.webnovel/state.json 或任何 canon/read model 文件。

引用加载策略

路径说明：references/ 指 skill 私有 skills/webnovel-init/references/；../../references/ 指共享 references。

md 必读

Step	Trigger	Reference	实际路径
Step 1	always	数据流规范	`${SKILL_ROOT}/references/system-data-flow.md`
Step 1	always	题材套路库	`${SKILL_ROOT}/references/genre-tropes.md`
卖点/题材采集	always	题材配置	`${SKILL_ROOT}/../../references/genre-profiles.md`

md 按需

Step	Trigger	Reference	实际路径
Step 2	用户人物扁平	角色设计	`${SKILL_ROOT}/references/worldbuilding/character-design.md`
Step 4	always	势力格局	`${SKILL_ROOT}/references/worldbuilding/faction-systems.md`
Step 4	涉及修仙/玄幻/高武/异能	力量体系	`${SKILL_ROOT}/references/worldbuilding/power-systems.md`
Step 4	always	世界规则	`${SKILL_ROOT}/references/worldbuilding/world-rules.md`
Step 5	always	创意约束	`${SKILL_ROOT}/references/creativity/creativity-constraints.md`
Step 5	always	卖点生成	`${SKILL_ROOT}/references/creativity/selling-points.md`
Step 5	复合题材	题材融合	`${SKILL_ROOT}/references/creativity/creative-combination.md`
Step 5	卡顿	灵感候选	`${SKILL_ROOT}/references/creativity/inspiration-collection.md`
Step 5	题材映射命中	反套路库	`${SKILL_ROOT}/references/creativity/anti-trope-*.md`
Step 6	always	设定一致性	`${SKILL_ROOT}/references/worldbuilding/setting-consistency.md`

CSV 检索

Step	Trigger	检索命令
角色/书名/势力设定	用户开始设定命名	`python -X utf8 "${SCRIPTS_DIR}/reference_search.py" --skill init --table 命名规则 --query "{命名对象} {题材}" --genre {题材}`

工具策略（按需）

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

交互流程（Deep）

Step 1：预检与上下文加载

环境设置（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
初始化前不要用 where 把 WORKSPACE_ROOT 解析成书项目根；新项目尚不存在时，where 可能命中旧指针或旧项目。
只打印工作区与脚本目录，确认生成目标将在工作区下的书名安全化子目录中。
加载最小参考：
- references/system-data-flow.md（用于校对 init 产物与 plan/write 输入链路）
- references/genre-tropes.md
- templates/genres/（仅在用户选定题材后按需读取）

输出：

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

Step 1.5：灵感来源询问（可选）

进入故事核采集前，必须先用 AskUserQuestion 或直接提问的方式确认用户是否要提供灵感来源。不要默认拆书，也不要把参考作品当作必填项。

建议询问：

你这本书的灵感来源想从哪里开始？可以直接说原创想法，也可以提供参考作品做拆书提炼。若要拆书，请给参考书名+平台，并尽量提供章节摘录或文本路径；没有参考也可以直接跳过。

可接受的灵感来源：

用户自由描述的原创想法；
参考作品拆书：书名、平台、章节摘录、完整文本路径；
市场趋势或平台风向；
题材模板、反套路库、已有脑洞片段。

当用户选择参考作品拆书且提供文本路径或章节摘录时，必须使用 Agent 工具调用 webnovel-writer:deconstruction-agent，不得由 init 主流程口头替代拆解结果。

Agent(
  subagent_type: "webnovel-writer:deconstruction-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 文件。"
)

处理规则：

如果用户只有书名/平台，没有文本或摘录，先询问是否能提供摘录/路径；若不能提供，则把参考书仅作为"方向线索"，不得编造该书黄金三章、角色、设定或剧情事实。
接收返回的 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。
先检查 quality：quality.passed=false、confidence < 0.85 或 warnings 非空时，不得把候选折叠进创意约束包；只能把风险和需补充材料展示给用户确认。
do_not_copy 和 canon_contamination_warnings 必须进入已知信息清单，作为后续创意生成红线。
Step 2-6 只能使用用户确认过、并已变形为本书差异化表达的模式。
禁止把参考书角色、设定、组织、地点、金手指、剧情事实原样写入生成项目文件。

Step 2：故事核与商业定位

收集项（必收）：

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

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

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

交互方式：

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

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

收集项（必收）：

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

收集项（可选）：

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

Step 4：金手指与兑现机制

收集项（必收）：

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

收集项（条件必收）：

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

Step 5：世界观与力量规则

收集项（必收）：

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

收集项（题材相关）：

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

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

流程：

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

备注：

若用户要求"贴近当下市场"，可触发外部检索并标注时间戳。
若使用了参考拆解，展示候选时必须标明参考来源、转换方式、不可复制项和差异化要求；用户未明确确认前，不写入 idea_bank.json 或任何生成项目文件。

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

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

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

确认规则：

用户未明确确认，不执行生成。
若用户仅改局部，回到对应 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 必须由书名安全化生成（去非法字符，空格转 -）。
构造公式：project_root = <当前工作目录>/<书名安全化结果>，即 PROJECT_ROOT="${WORKSPACE_ROOT}/${PROJECT_SLUG}"。
若安全化结果为空或以 . 开头，自动前缀 proj-。
禁止在插件目录下生成项目文件（${CLAUDE_PLUGIN_ROOT}）。
禁止直接把 WORKSPACE_ROOT 当作 PROJECT_ROOT，除非用户明确指定当前目录本身就是书项目根。
初始化前必须展示并确认：
- WORKSPACE_ROOT
- PROJECT_SLUG
- PROJECT_ROOT

推荐安全化命令（与规则保持一致）：

PROJECT_SLUG="$(python -X utf8 -c "import re,sys; title=sys.argv[1].strip(); slug=re.sub(r'[\\\\/:*?\"<>|]+','',title); slug=re.sub(r'\\s+','-',slug).strip('-'); print(('proj-' + slug) if (not slug or slug.startswith('.')) else slug)" "{title}")"
PROJECT_ROOT="${WORKSPACE_ROOT}/${PROJECT_SLUG}"
echo "WORKSPACE_ROOT=${WORKSPACE_ROOT}"
echo "PROJECT_SLUG=${PROJECT_SLUG}"
echo "PROJECT_ROOT=${PROJECT_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 条）

4) 生成写前合同树（Story System 初始化）

init 完成后，立即生成 MASTER_SETTING，让后续 plan 有调性/禁忌参照：

GENRE="$(python -X utf8 -c "import json,os; root=os.environ['PROJECT_ROOT']; s=json.load(open(root + '/.webnovel/state.json',encoding='utf-8')); print(s.get('project',{}).get('genre',''))")"

python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" \
  story-system "${GENRE}" --genre "${GENRE}" --persist --format json

说明：

此时不传 --chapter，只生成 MASTER_SETTING.json 和 anti_patterns.json
不传 --emit-runtime-contracts（还没有卷/章级数据）
plan 阶段拆到具体章节时再生成 volume/chapter/review 合同

验证与交付

执行检查：

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}"

成功标准：

state.json 存在且关键字段不为空（title/genre/target_words/target_chapters）。
设定集核心文件存在：世界观.md、力量体系.md、主角卡.md。
单主角项目不生成 主角组.md；heroine_config=无女主 不生成 女主卡.md。
默认不生成 金手指设计.md、复合题材-融合逻辑.md、爽点规划.md 或空的 角色库/物品库/其他设定 目录；这些信息以主角卡、世界观、卷纲为事实源。
总纲.md 已填核心主线与约束字段。
idea_bank.json 已写入且与最终选定方案一致。
.story-system/MASTER_SETTING.json 存在且 route.primary_genre 非空。

失败处理（最小回滚）

触发条件：

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

恢复流程：

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

webnovel-init

Project Initialization (Deep Mode)

目标

执行原则

引用加载策略

md 必读

md 按需

CSV 检索

工具策略（按需）

交互流程（Deep）

Step 1：预检与上下文加载

Step 1.5：灵感来源询问（可选）

Step 2：故事核与商业定位

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

Step 4：金手指与兑现机制

Step 5：世界观与力量规则

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

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

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

充分性闸门（必须通过）

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

执行生成

1) 运行初始化脚本

2) 写入 `idea_bank.json`

3) Patch 总纲

4) 生成写前合同树（Story System 初始化）

验证与交付

失败处理（最小回滚）

More from lingfengqaq/webnovel-writer

webnovel-write

webnovel-review

webnovel-plan

webnovel-query

webnovel-resume

webnovel-dashboard

webnovel-init

Project Initialization (Deep Mode)

目标

执行原则

引用加载策略

md 必读

md 按需

CSV 检索

工具策略（按需）

交互流程（Deep）

Step 1：预检与上下文加载

Step 1.5：灵感来源询问（可选）

Step 2：故事核与商业定位

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

Step 4：金手指与兑现机制

Step 5：世界观与力量规则

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

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

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

充分性闸门（必须通过）

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

执行生成

1) 运行初始化脚本

2) 写入 idea_bank.json

3) Patch 总纲

4) 生成写前合同树（Story System 初始化）

验证与交付

失败处理（最小回滚）

More from lingfengqaq/webnovel-writer

webnovel-write

webnovel-review

webnovel-plan

webnovel-query

webnovel-resume

webnovel-dashboard

2) 写入 `idea_bank.json`