webnovel-writer/.claude/skills/webnovel-init/SKILL.md

---

name: webnovel-init

description: Initializes a new webnovel project in deep mode, collecting full story/world/character/constraint data and generating all pre-writing files. Use when starting a new novel or running /webnovel-init.

Project Initialization (Deep only)

Goal: create a writing-ready project skeleton + creative constraints. No Quick/Standard mode.

Workflow

1. Ask for deep setup info (story, character, world, golden finger, constraints).
2. Run init_project.py with full parameters.
3. Write idea_bank.json.
4. Patch 总纲.md with the collected core info.
5. Verify files.

Reference Loading Levels (strict, lazy)

Apply progressive disclosure:

• L0: Load nothing extra until task type is confirmed.
• L1: Load only the minimum file needed for the current wave.
• L2: Load conditional files only when the user choice requires them.
• L3: Load optional/time-sensitive files only on explicit user request.

Do not recursively chase references inside a reference file unless blocked.

Path conventions:

• references/... → relative to this skill directory (i.e. .claude/skills/webnovel-init/references/...)
• @templates/... → relative to .claude/templates/... (project-level shared templates)

L1 (minimum, wave-gated)

• Before Wave 1: references/genre-tropes.md

L2 (conditional)

• After genre selection: @templates/genres/{genre}.md (only for selected genres in A+B)
• Before Wave 3 (golden finger): @templates/golden-finger-templates.md
• Before Wave 4 (world): references/worldbuilding/faction-systems.md
• Before Wave 4 (constraints):
  • references/creativity/creativity-constraints.md
  • references/creativity/anti-trope-xianxia.md (修仙/玄幻/高武/西幻)
  • references/creativity/anti-trope-rules-mystery.md (规则/悬疑/灵异)

L3 (optional, explicit only)

• references/creativity/market-trends-2026.md
• If used, explicitly mark it as time-sensitive and verify freshness before relying on it.

Questioning style

• Ask in 3–4 conversational waves; avoid rigid templates.
• Ask only missing info; confirm before generation.
• Offer options only when the user is stuck.

Suggested grouping (flexible)

Wave 1: 书名 + 题材 + 目标规模 + 一句话故事 Wave 2: 主角（姓名/欲望/缺陷/结构） + 感情线 + 反派分层 Wave 3: 金手指（类型/名称/风格/可见度/代价） + 条件追问 Wave 4: 世界观（规模/力量/势力/阶层/境界） + 创意约束确认

Adjust order based on user's initial input. If user provides detailed info upfront, skip to missing items.

Required data (collect and map)

Order is flexible; group by theme.

A) Project scale & premise

• 书名
• 题材（支持 A+B）
  • 玄幻修仙类: 修仙 | 系统流 | 高武 | 西幻 | 无限流 | 末世 | 科幻
  • 都市现代类: 都市异能 | 都市日常 | 都市脑洞 | 现实题材 | 黑暗题材 | 电竞 | 直播文
  • 言情类: 古言 | 宫斗宅斗 | 青春甜宠 | 豪门总裁 | 职场婚恋 | 民国言情 | 幻想言情 | 现言脑洞 | 女频悬疑 | 狗血言情 | 替身文 | 多子多福 | 种田 | 年代
  • 特殊题材: 规则怪谈 | 悬疑脑洞 | 悬疑灵异 | 历史古代 | 历史脑洞 | 游戏体育 | 抗战谍战 | 知乎短篇 | 克苏鲁
• 目标规模：总字数或总章数（若只给总字数，默认按每章 3500 估算并告知）
• 一句话故事 + 核心冲突 + 主线目标
• 目标读者/平台（可一句话描述）

B) 主角与阵营

• 主角姓名、人设类型、核心欲望、关键缺陷
• 主角结构（单/多主角）+ 多主角姓名与定位
• 感情线：无/单女主/多女主；女主姓名与定位
• 反派分层（小/中/大）+ 反派镜像一句话 + 反派等级（若有）

C) 金手指

• 类型、名称/系统名、风格
  • 常见类型: 系统面板 | 重生记忆 | 老爷爷/传承 | 血脉觉醒 | 异能觉醒 | 随身空间 | 无金手指
• 读者可见度、不可逆代价、成长节奏
• 条件追问（根据类型）：
  • 系统面板 → 系统性格、系统命名、升级节奏
  • 重生记忆 → 重生时间点、记忆完整度、先知程度
  • 老爷爷/传承 → 器灵性格、器灵实力、辅助方式
  • 随身空间 → 空间大小、特殊功能、升级方式
  • 血脉觉醒 → 血脉来源、觉醒条件、能力限制
  • 异能觉醒 → 异能来源、异能上限、是否可进化
  • 无金手指 → 主角天赋、特殊机遇、成长路线

D) 世界观与力量

• 世界规模、势力格局、力量体系类型
• 社会阶层、资源分配
• 货币体系 + 兑换规则
• 宗门/组织层级
• 境界链 + 小境界划分（如适用）

E) 创意约束

Generation flow:

1. Load anti-trope library based on genre (xianxia or rules-mystery)
2. Generate 2-3 creative packages, each containing:
   • 书名变体（可选）
   • 一句话卖点
   • 反套路规则（从库中选 1 条）
   • 主角缺陷（驱动故事）
   • 反派镜像设计（一句话）
   • 开篇钩子
   • 硬约束 2–3 条
3. Apply 三问筛选:
   • Q1: 这题材为什么"只能这样写"？
   • Q2: 这主角如果换成常规人设会崩吗？
   • Q3: 这个卖点一句话能讲清、且不撞常见套路吗？
4. Score each package (满分 50):
   • 新颖度 25% | 市场性 20% | 可写性 20% | 爽点密度 20% | 长线潜力 15%
5. Present packages to user for selection

Collected data:

• 反套路规则（从对应库选 1 条）
• 硬约束 2–3 条
• 主角缺陷如何驱动故事（一句话）
• 反派镜像如何体现（一句话）
• 开篇钩子 + 核心卖点 1–3 条

Generate project

Sufficiency check (must pass before running init)

Hard requirement: do not run init_project.py until all items below are known or explicitly deferred by the user.

• 书名、题材（含复合题材）
• 目标规模（总字数或总章数）
• 主角姓名 + 欲望 + 缺陷
• 世界规模 + 力量体系类型
• 金手指类型（可为“无金手指”）
• 反套路规则 + 硬约束（若用户拒绝创意约束，必须明确记录）

If any is missing, stop and ask only for the missing items.

Project directory

• project_root = 书名安全化（去非法字符，空格转 -；为空或以 . 开头则前缀 proj-）
• 禁止在 .claude/ 下生成

Run init script

python "${CLAUDE_PLUGIN_ROOT}/scripts/init_project.py" \
  "{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}"

Write idea_bank.json

Create .webnovel/idea_bank.json with the selected idea and inherited constraints.

{
  "selected_idea": {
    "title": "",
    "one_liner": "",
    "anti_trope": "",
    "hard_constraints": []
  },
  "constraints_inherited": {
    "anti_trope": "",
    "hard_constraints": [],
    "protagonist_flaw": "",
    "antagonist_mirror": ""
  }
}

Patch 总纲.md

After init, fill these fields in 大纲/总纲.md using collected info:

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

Verify

Get-Item "{project_root}/.webnovel/state.json"
Get-ChildItem "{project_root}/设定集" -Filter *.md
Get-Item "{project_root}/大纲/总纲.md"

Final check

• .webnovel/state.json 存在且包含 title/genre/target_words/target_chapters
• 设定集/世界观.md、力量体系.md、主角卡.md、金手指设计.md 已生成
• 大纲/总纲.md 已填：一句话故事 / 核心主线 / 创意约束 / 反派分层
• .webnovel/idea_bank.json 已写入（有创意约束时）

Hard fail conditions (must stop)

• 任一关键文件不存在（state.json / 总纲.md / 设定集主文件）
• 总纲关键字段为空（故事一句话 / 核心主线 / 创意约束 / 反派分层）
• idea_bank.json 需要但未生成（当创意约束被启用时）

Rollback / recovery

If any hard fail triggers:

1. Stop and report missing items.
2. Ask only for missing info.
3. Re-run the minimal step needed:
   • Missing files → re-run init_project.py.
   • 总纲缺字段 → patch 总纲.md only.
   • idea_bank.json 缺失 → write it only.
4. Re-run Final check. Do not proceed to /webnovel-plan until passing.