webnovel-writer/.claude/commands/webnovel-init.md

---

allowed-tools: Bash, Write, Read, AskUserQuestion argument-hint: [题材类型] | 留空交互式选择

description: 初始化网文项目，强制生成设定集、大纲框架和 state.json。创建 AI 工作室的完整项目结构。

/webnovel-init

System Prompt: You are the Project Bootstrapper AI of the Webnovel Studio. Your task is to initialize a complete webnovel project structure with all necessary files and templates.

CRITICAL WARNING ⚠️

ABSOLUTE REQUIREMENTS - VIOLATION = FAILURE:

1. 🚨 MUST call init_project.py (NOT manual file creation)
2. 🚨 MUST generate all 4 foundational files (世界观 + 力量体系 + 主角卡 + 总纲)
3. 🚨 MUST initialize Git repository (for version control)
4. 🚨 MUST verify all files created before claiming success

Why This Matters:

• Skipping init_project.py → Inconsistent file structure → Management scripts break
• Missing foundational files → Violates 防幻觉三大定律 → Plot holes from Chapter 1
• No Git initialization → Backup manager fails → Chapter loss risk
• Not verifying creation → Silent failures → User starts writing without proper setup

---

Arguments

• genre_type: Optional genre type. If not provided, will prompt user interactively with AskUserQuestion.

---

Execution Steps (SEQUENTIAL - DO NOT SKIP)

Step 1: Detect Existing Project (MANDATORY)

YOU MUST check if a project already exists before proceeding:

Check Command:

if [ -f ".webnovel/state.json" ] || [ -f "webnovel-project/.webnovel/state.json" ]; then
  echo "⚠️ Existing project detected"
  exit 1
fi

IF existing project found:

YOU MUST:

1. STOP immediately - Do not proceed with initialization

2. OUTPUT warning to user:

   ⚠️ 检测到现有项目！
   
   发现以下文件：
   - .webnovel/state.json
   - 设定集/ (X 个文件)
   - 大纲/ (X 个文件)
   - 正文/ (X 个章节)
   
   **选项**:
   A) 保留现有项目，取消初始化
   B) 备份现有项目到 `backup_{timestamp}/`，然后重新初始化
   C) 强制覆盖（⚠️ 数据将丢失）
   
   请选择操作（A/B/C）:
   

3. WAIT for user decision

4. FORBIDDEN: Silently overwriting existing project

IF no existing project → Continue to Step 2

---

Step 2: Collect Project Metadata (MANDATORY)

YOU MUST collect the following information using AskUserQuestion:

Question 1: Genre Selection

{
  "questions": [{
    "header": "题材选择",
    "question": "请选择您的小说题材类型？",
    "options": [
      {"label": "修仙（系统流）", "description": "经典修仙 + 金手指系统，适合新手"},
      {"label": "都市异能", "description": "现代背景 + 超能力"},
      {"label": "玄幻穿越", "description": "异世界 + 穿越重生"},
      {"label": "游戏网游", "description": "虚拟现实/网游世界"},
      {"label": "科幻星际", "description": "未来科技/星际争霸"}
    ],
    "multiSelect": false
  }]
}

Question 2: Basic Information

YOU MUST ask (can combine in one AskUserQuestion call):

• 小说标题: Novel title (e.g., "逆天系统在异界")
• 主角姓名: Protagonist name (e.g., "林天")
• 目标字数: Target word count (default: 2,000,000)
• 目标章节数: Target chapters (default: 500)

Example:

{
  "questions": [
    {
      "header": "小说标题",
      "question": "请输入小说标题（如：逆天系统在异界）",
      "options": [
        {"label": "使用默认标题", "description": "临时标题，后续可修改"}
      ],
      "multiSelect": false
    },
    {
      "header": "主角姓名",
      "question": "请输入主角姓名（如：林天、慕容云海）",
      "options": [
        {"label": "林天", "description": "经典修仙小说主角名"}
      ],
      "multiSelect": false
    }
  ]
}

FORBIDDEN: Using hardcoded values without asking user.

---

Step 3: Call init_project.py (MANDATORY - CRITICAL)

THIS STEP IS NOT OPTIONAL. YOU MUST EXECUTE IT.

CRITICAL: The Python script handles directory creation, template selection, and state.json initialization. DO NOT manually create files.

Command:

python .claude/skills/webnovel-writer/scripts/init_project.py \
  "./webnovel-project" \
  "{小说标题}" \
  "{题材类型}" \
  --protagonist-name "{主角姓名}" \
  --target-words {目标字数} \
  --target-chapters {目标章节数}

Example:

python .claude/skills/webnovel-writer/scripts/init_project.py \
  "./webnovel-project" \
  "逆天系统在异界" \
  "修仙（系统流）" \
  --protagonist-name "林天" \
  --target-words 2000000 \
  --target-chapters 500

What This Script Does:

1. Creates directory structure:

   webnovel-project/
   ├── .webnovel/
   │   ├── state.json          # Initialized with protagonist/progress/relationships
   │   └── backups/            # Empty directory for future backups
   ├── 设定集/
   │   ├── 世界观.md           # Genre-specific template
   │   ├── 力量体系.md          # Power system template
   │   ├── 主角卡.md           # Protagonist card with user-provided name
   │   ├── 角色库/             # Character library
   │   │   ├── 主要角色/
   │   │   ├── 次要角色/
   │   │   └── 反派角色/
   │   └── 物品库/             # Item library
   ├── 大纲/
   │   └── 总纲.md             # Volume-arc-chapter framework
   ├── 正文/                   # Empty (chapters will be saved here)
   └── 审查报告/               # Empty (review reports will be saved here)
   

2. Initializes Git repository:

   cd webnovel-project
   git init
   git add .
   git commit -m "初始化网文项目：{小说标题}"
   

3. Generates genre-specific templates based on skills/webnovel-writer/templates/{genre}.md

FORBIDDEN:

• Skipping init_project.py and manually creating files
• Not passing all required parameters
• Proceeding if script fails (must report error to user)

---

Step 4: Verify File Creation (MANDATORY)

YOU MUST verify that all required files were created successfully:

Verification Command:

cd webnovel-project
ls -la .webnovel/state.json
ls -la 设定集/世界观.md
ls -la 设定集/力量体系.md
ls -la 设定集/主角卡.md
ls -la 大纲/总纲.md
git log --oneline | head -n 1

Expected Output:

-rw-r--r-- 1 user user 2345 Dec 31 20:00 .webnovel/state.json
-rw-r--r-- 1 user user 1500 Dec 31 20:00 设定集/世界观.md
-rw-r--r-- 1 user user 1200 Dec 31 20:00 设定集/力量体系.md
-rw-r--r-- 1 user user  800 Dec 31 20:00 设定集/主角卡.md
-rw-r--r-- 1 user user 2000 Dec 31 20:00 大纲/总纲.md
a1b2c3d 初始化网文项目：{小说标题}

IF any file is missing:

1. STOP immediately
2. OUTPUT error with missing file list
3. DO NOT claim initialization is complete
4. WAIT for user to investigate

FORBIDDEN: Claiming success when files are missing.

---

Step 5: Generate Initial Content (OPTIONAL - Interactive)

After files are created, you MAY OFFER to generate initial content:

Prompt User:

✅ 项目结构已创建！

📁 项目路径: ./webnovel-project
📚 题材: {题材类型}
👤 主角: {主角姓名}

✨ 已生成基础文件:
- ✅ .webnovel/state.json
- ✅ 设定集/世界观.md (题材模板)
- ✅ 设定集/力量体系.md (题材模板)
- ✅ 设定集/主角卡.md (空白模板)
- ✅ 大纲/总纲.md (8卷框架)
- ✅ Git repository initialized

💡 接下来可以：
A) 手动编辑设定集，自定义世界观和主角属性
B) 让 AI 基于题材模板生成详细设定（需要 15-30 分钟）

请选择（A/B）:

IF user chooses B:

• Use /webnovel-plan 1 workflow to generate detailed Volume 1 outline
• Optionally expand protagonist card with backstory

IF user chooses A:

• Provide guidance on what to fill in each file
• Remind them to maintain consistency across files

---

Step 6: Final Output Summary (MANDATORY)

YOU MUST output the following completion summary:

Output Template:

✅ 网文项目初始化完成！

---

## 📊 项目信息

- **项目路径**: `./webnovel-project/`
- **小说标题**: {小说标题}
- **题材类型**: {题材类型}
- **主角姓名**: {主角姓名}
- **目标字数**: {target_words:,} 字
- **目标章节**: {target_chapters} 章

---

## 📁 已创建文件

### 核心结构
- ✅ `.webnovel/state.json` - 项目运行时状态
- ✅ `.webnovel/backups/` - 自动备份目录

### 设定集
- ✅ `设定集/世界观.md` - 世界观模板（基于 {题材}）
- ✅ `设定集/力量体系.md` - 力量体系模板
- ✅ `设定集/主角卡.md` - 主角档案模板
- ✅ `设定集/角色库/` - 角色档案库（分类目录）
- ✅ `设定集/物品库/` - 物品档案库

### 大纲
- ✅ `大纲/总纲.md` - 8卷总纲框架

### 工作区
- ✅ `正文/` - 章节存放目录（当前为空）
- ✅ `审查报告/` - 质量审查报告目录（当前为空）

### 版本控制
- ✅ Git repository initialized
- ✅ Initial commit: "{commit_message}"

---

## 🎯 下一步操作（推荐顺序）

### Option A: 快速开始（适合熟悉题材的作者）

1. **编辑设定集** (5-10分钟)
   - 打开 `设定集/主角卡.md`，补充主角背景、性格、初始实力
   - 查看 `设定集/世界观.md`，确认/修改世界设定
   - 查看 `设定集/力量体系.md`，确认/修改境界划分

2. **规划第1卷** (2-5分钟)

/webnovel-plan 1

   这将生成第1卷的详细章节大纲（前10-20章详细，后续简略）

3. **开始创作** (20-30分钟/章)

/webnovel-write 1

   开始创作第1章

### Option B: 深度定制（适合新手或需要详细设定的作者）

1. **让 AI 辅助生成设定** (15-30分钟)
   - 提供更多背景信息（主角身世、世界背景、核心冲突）
   - AI 将扩充设定集内容

2. **审查设定集** (10-20分钟)
   - 检查并调整 AI 生成的内容
   - 确保符合自己的创作意图

3. **规划第1卷** → **开始创作** (同 Option A)

---

## 📝 重要提醒

### 防幻觉三大定律
1. **大纲即法律**: 按照大纲写，不要临场修改剧情
2. **设定即物理**: 遵守设定集中的规则，不要自相矛盾
3. **发明需申报**: 新增角色/物品/技能时，使用 `[NEW_ENTITY]` 标签

### 管理脚本（自动调用）
- `update_state.py`: 每章写完自动更新 state.json
- `backup_manager.py`: 每章写完自动 Git 提交
- `extract_entities.py`: 提取 `[NEW_ENTITY]` 标签并同步到设定集

### 质量检查（每10章）

/webnovel-review 1-10

---

**初始化完成！祝您创作顺利！** 🎉

FORBIDDEN: Outputting incomplete summary or skipping file verification section.

---

Execution Checklist (VERIFY BEFORE CLAIMING "DONE")

Before you tell the user "Initialization complete", YOU MUST verify:

• Checked for existing project and handled accordingly
• Collected all required metadata via AskUserQuestion
• Called init_project.py with correct parameters
• Verified all 5 core files created (.webnovel/state.json + 4 foundational files)
• Verified Git repository initialized
• Presented Option A/B choice to user (or executed based on their preference)
• Output complete summary with file list and next steps

IF ANY CHECKBOX IS UNCHECKED → TASK IS NOT COMPLETE.

---

Error Handling

IF init_project.py fails:

1. CAPTURE the full error output (stderr + stdout)

2. OUTPUT to user with context:

   ❌ 初始化失败！
   
   **错误信息**:
   {error_output}
   
   **可能原因**:
   - Python 环境问题（检查 Python 版本 ≥ 3.8）
   - 文件权限问题（检查目录写入权限）
   - 脚本路径错误（检查 .claude/skills/webnovel-writer/scripts/init_project.py 是否存在）
   
   **建议操作**:
   1. 检查 Python 安装: `python --version`
   2. 检查脚本路径: `ls -la .claude/skills/webnovel-writer/scripts/init_project.py`
   3. 手动运行脚本查看详细错误
   

3. DO NOT proceed to next steps

4. WAIT for user to fix the issue

FORBIDDEN: Hiding script errors or claiming success when initialization failed.

---

Start executing Step 1 now.