🎯

webnovel-init

🎯Skill

from lingfengqaq/webnovel-writer

VibeIndex|
What it does

Initializes a comprehensive webnovel project by collecting detailed story, character, world, and creative constraint data through an adaptive, conversational process.

📦

Part of

lingfengqaq/webnovel-writer(7 items)

webnovel-init

Installation

git cloneClone repository
git clone https://github.com/lingfengQAQ/webnovel-writer.git .claude
pip installInstall dependencies
pip install -r .claude/scripts/requirements.txt
PythonRun Python server
python -m data_modules.index_manager process-chapter --chapter 1 --project-root "."
PythonRun Python server
python -m data_modules.index_manager get-debt-summary --project-root "."
PythonRun Python server
python -m data_modules.index_manager get-recent-review-metrics --limit 5 --project-root "."

+ 2 more commands

📖 Extracted from docs: lingfengqaq/webnovel-writer
11Installs
-
AddedFeb 4, 2026

Skill Details

SKILL.md

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.

Overview

# 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.

References (read at specific phases)

Before Wave 1:

  • skills/webnovel-init/references/genre-tropes.md

After genre selection:

  • templates/genres/{genre}.md (read for each genre in A+B)

Before Wave 3 (golden finger):

  • templates/golden-finger-templates.md

Before Wave 4 (world):

  • skills/webnovel-init/references/worldbuilding/faction-systems.md

Before Wave 4 (constraints):

  • skills/webnovel-init/references/creativity/creativity-constraints.md
  • skills/webnovel-init/references/creativity/anti-trope-xianxia.md (修仙/玄幻/高武/西幻)
  • skills/webnovel-init/references/creativity/anti-trope-rules-mystery.md (规则/悬疑/灵异)

Optional (only if user explicitly asks):

  • skills/webnovel-init/references/creativity/market-trends-2026.md

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 条

  1. Apply 三问筛选:

- Q1: 这题材为什么"只能这样写"?

- Q2: 这主角如果换成常规人设会崩吗?

- Q3: 这个卖点一句话能讲清、且不撞常见套路吗?

  1. Score each package (满分 50):

- 新颖度 25% | 市场性 20% | 可写性 20% | 爽点密度 20% | 长线潜力 15%

  1. 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

```bash

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.

```json

{

"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

```bash

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.

  1. Re-run Final check. Do not proceed to /webnovel-plan until passing.