feat: 强制执行模式 - 重写全部5个命令文件

⚠️ CRITICAL: 解决"长跑引擎停机"问题

核心问题：
- 3章已创作（14,431字），但 state.json 显示 0/0
- 主角状态frozen（淬体1层/未觉醒系统）
- strand_tracker全为0
- 无Git章节标签

根因：
- 命令文件为"建议性流程"，Claude跳过所有管理脚本调用
- /webnovel-write 允许"只写正文不管理"

解决方案：全部5个命令文件重写为"强制执行模式"

✅ 重写完成的文件（5/5）:
1. webnovel-write.md (290行)
   - 添加 CRITICAL WARNING ⚠️ 部分
   - 7个步骤全部MANDATORY/FORBIDDEN标注
   - Execution Checklist（7项强制验证）
   - 明确后果："Without state update → AI forgets power"

2. webnovel-review.md (350行)
   - 添加 CRITICAL WARNING ⚠️ 部分
   - 5个checker全部强制调用
   - 每个checker详细评分标准+输出格式
   - Report Generation强制要求

3. webnovel-query.md (379行)
   - 添加 CRITICAL WARNING ⚠️ 部分
   - 强制搜索3个源（设定集+大纲+state.json）
   - Cross-Reference强制规则
   - 禁止伪造信息

4. webnovel-init.md (429行)
   - 添加 CRITICAL WARNING ⚠️ 部分
   - 强制调用init_project.py
   - 强制验证所有文件创建
   - Git初始化强制要求

5. webnovel-plan.md (426行)
   - 添加 CRITICAL WARNING ⚠️ 部分（补强Gemini版本）
   - AskUserQuestion强制调用
   - update_state.py强制调用
   - 完整Execution Checklist

🔧 统一加固模式：
- ✅ 所有命令均有 "CRITICAL WARNING ⚠️" 部分
- ✅ 所有步骤标注 MANDATORY/FORBIDDEN/CRITICAL
- ✅ 所有命令均有 Execution Checklist
- ✅ 明确写明后果（"Why This Matters"）
- ✅ Error Handling部分（禁止隐藏错误）

🚀 预期效果：
- AI无法跳过任何管理步骤
- 每步都有验证清单
- 错误必须显式报告
- 确保200万字长跑稳定运行

下一步：Phase 2 - 手动同步前3章状态

🚀 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

.claude/commands/webnovel-init.md

@@ -1,25 +1,82 @@
 ---
 allowed-tools: Bash, Write, Read, AskUserQuestion
 argument-hint: [题材类型] | 留空交互式选择
-description: 初始化网文项目，生成设定集和大纲框架。创建 AI 工作室的完整项目结构。
+description: 初始化网文项目，强制生成设定集、大纲框架和 state.json。创建 AI 工作室的完整项目结构。
 ---
 
 # /webnovel-init
 
-初始化网文创作项目，创建"AI 工作室"所需的完整文件结构。
+> **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 ⚠️
 
-### Step 1: 检测现有项目
+**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**:
 ```bash
-if [ -f ".webnovel/state.json" ]; then
-    询问用户是否覆盖现有项目
+if [ -f ".webnovel/state.json" ] || [ -f "webnovel-project/.webnovel/state.json" ]; then
+  echo "⚠️ Existing project detected"
+  exit 1
 fi
 ```
 
-### Step 2: 选择题材
+**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) 强制覆盖（⚠️ 数据将丢失）
 
-使用 AskUserQuestion 让用户选择题材类型：
+   请选择操作（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**
 
 ```json
 {
@@ -38,66 +95,334 @@ fi
 }
 ```
 
-### Step 3: 基础信息收集
+**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**:
+```json
+{
+  "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.**
 
-### Step 4: 调用 Python 脚本初始化
+**CRITICAL**: The Python script handles directory creation, template selection, and state.json initialization. **DO NOT manually create files**.
 
+**Command**:
 ```bash
-python .claude/skills/webnovel-writer/scripts/init_project.py "./webnovel-project" "小说标题" "题材类型"
+python .claude/skills/webnovel-writer/scripts/init_project.py \
+  "./webnovel-project" \
+  "{小说标题}" \
+  "{题材类型}" \
+  --protagonist-name "{主角姓名}" \
+  --target-words {目标字数} \
+  --target-chapters {目标章节数}
 ```
 
-这将创建：
-```
-webnovel-project/
-├── .webnovel/
-│   ├── state.json          # 项目状态
-│   └── backups/
-├── 设定集/
-│   ├── 世界观.md           # 根据题材模板生成
-│   ├── 力量体系.md
-│   ├── 主角卡.md
-│   └── 角色库/
-├── 大纲/
-│   └── 总纲.md             # 卷-篇-章结构
-├── 正文/
-└── 审查报告/
+**Example**:
+```bash
+python .claude/skills/webnovel-writer/scripts/init_project.py \
+  "./webnovel-project" \
+  "逆天系统在异界" \
+  "修仙（系统流）" \
+  --protagonist-name "林天" \
+  --target-words 2000000 \
+  --target-chapters 500
 ```
 
-### Step 5: 调用 webnovel-writer skill 生成初始设定
+**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:
+   ```bash
+   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**:
+```bash
+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**:
 ```
-Skill: webnovel-writer
-Mode: Plan
-Task: 根据题材模板生成世界观、主角卡和总纲
+-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 初始化网文项目：{小说标题}
 ```
 
-### Step 6: 输出提示
+**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
-📚 题材: 修仙（系统流）
-👤 主角: 林天
-
-✨ 已生成文件:
-- 设定集/世界观.md
-- 设定集/主角卡.md
-- 大纲/总纲.md（8 卷框架）
-
-🎯 下一步操作:
-1. 查看并调整设定集（可手动编辑）
-2. 运行 /webnovel-plan 1 规划第 1 卷详细大纲
-3. 运行 /webnovel-write 1 开始创作第 1 章
+📚 题材: {题材类型}
+👤 主角: {主角姓名}
+
+✨ 已生成基础文件:
+- ✅ .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**:
+
+```markdown
+✅ 网文项目初始化完成！
+
+---
+
+## 📊 项目信息
+
+- **项目路径**: `./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.
+
+---
 
-- 初始化后会自动打开项目目录
-- 所有文件均为 Markdown 格式，可手动编辑
-- state.json 由系统自动维护，建议不要手动修改
+**Start executing Step 1 now.**

.claude/commands/webnovel-plan.md

@@ -1,38 +1,77 @@
 ---
 allowed-tools: Read, Write, Edit, AskUserQuestion, Bash
 argument-hint: [卷号]
-description: 规划指定卷的详细大纲，将总纲细化为章节级别。支持交互式询问补充设定。
+description: 规划指定卷的详细大纲，强制将总纲细化为章节级别。支持交互式询问补充设定。
 ---
 
 # /webnovel-plan
 
-> **System Prompt**: You are the **Planner AI** of the Webnovel Studio. Your task is to generate a detailed volume outline (chapter-by-chapter) based on the user's input and the existing project state.
+> **System Prompt**: You are the **Planner AI** of the Webnovel Studio. Your task is to generate a detailed volume outline (chapter-by-chapter) based on user input and existing project state, **with MANDATORY state updates**.
+
+## CRITICAL WARNING ⚠️
+
+**ABSOLUTE REQUIREMENTS - VIOLATION = FAILURE**:
+1. 🚨 **MUST call AskUserQuestion** (NOT optional, NOT skippable)
+2. 🚨 **MUST generate detailed outline for ALL chapters** in volume (NOT summary)
+3. 🚨 **MUST call update_state.py** after saving outline (NOT optional)
+4. 🚨 **MUST save to correct file** (大纲/第X卷-详细大纲.md)
+
+**Why This Matters**:
+- Skipping AskUserQuestion → Generic plot → Reader says "boring" → Drop rate
+- Incomplete outline → Writer fills blanks with hallucinations → Plot holes
+- Skipping update_state.py → State tracking stops → AI forgets Volume 1 is planned
+- Wrong filename → Next command can't find outline → Workflow breaks
+
+---
 
 ## Arguments
+
 - `volume_id`: The volume number to plan (e.g., "1"). If not provided, ask the user.
 
-## Execution Steps
+---
+
+## Execution Steps (SEQUENTIAL - DO NOT SKIP)
 
-Please execute the following steps sequentially:
+### Step 1: Initialize and Context Loading (MANDATORY)
 
-### Step 1: Initialize and Context Loading
+**YOU MUST read** the following files in parallel:
 
-1.  **Parse Argument**: Identify the `volume_id` from the user input.
-2.  **Read Project State**: Read `.webnovel/state.json` to understand the current protagonist state, relationships, and foreshadowing.
-3.  **Read Master Outline**: Read `大纲/总纲.md` to find the high-level framework for this volume.
+1. **Parse Argument**: Identify `volume_id` from user input
+2. **Read Project State**: `.webnovel/state.json` → Get current protagonist state, relationships, foreshadowing
+3. **Read Master Outline**: `大纲/总纲.md` → Find high-level framework for this volume
 
-### Step 2: Interactive Planning (AskUserQuestion)
+**Example Commands**:
+```bash
+# Read state.json
+cat webnovel-project/.webnovel/state.json
 
-Check the master outline and state. If you need more details to plan this volume effectively, use the `AskUserQuestion` tool.
+# Read master outline
+cat webnovel-project/大纲/总纲.md
+```
 
-**MANDATORY: You MUST call `AskUserQuestion` with the following structure to gather key plot points:**
+**CRITICAL**: These reads provide context for generating the outline. Skipping them will result in inconsistent planning.
+
+**FORBIDDEN**:
+- Skipping state.json read
+- Skipping master outline read
+- Proceeding without identifying volume_id
+
+---
+
+### Step 2: Interactive Planning (MANDATORY - AskUserQuestion)
+
+**THIS STEP IS NOT OPTIONAL. YOU MUST EXECUTE IT.**
+
+**YOU MUST call** `AskUserQuestion` to gather key plot points from the user:
+
+**MANDATORY Question Structure**:
 
 ```json
 {
   "questions": [
     {
       "header": "核心冲突",
-      "question": "第 {{volume_id}} 卷的核心冲突是什么？",
+      "question": "第 {volume_id} 卷的核心冲突是什么？",
       "options": [
         {"label": "宗门竞争", "description": "宗门内部的明争暗斗"},
         {"label": "外敌入侵", "description": "外部势力攻击"},
@@ -55,38 +94,332 @@ Check the master outline and state. If you need more details to plan this volume
 }
 ```
 
-### Step 3: Generate Detailed Outline
+**Why MANDATORY**:
+- Generic AI-generated plots are predictable → Reader boredom
+- User input ensures originality and alignment with author's vision
+- Answers guide chapter breakdown and cool point distribution
+
+**FORBIDDEN**:
+- Skipping AskUserQuestion and generating outline directly
+- Using hardcoded answers instead of user input
+- Proceeding if AskUserQuestion fails (must report error)
 
-Based on the Master Outline, State, and User Answers, generate a detailed markdown outline.
+---
+
+### Step 3: Generate Detailed Outline (MANDATORY)
 
-**Content Requirements:**
-- **Volume Info**: Range of chapters, word count estimate, summary.
-- **Structure**: Divide the volume into 2-4 "Parts" (e.g., Setup, Conflict, Climax).
-- **Chapter Breakdown**: For EACH chapter, provide:
-    - **Goal**: What happens?
-    - **Cool Point (爽点)**: Face-slapping, leveling up, or gaining items.
-    - **Entities**: New or returning characters/locations.
-    - **Foreshadowing**: Plan at least one foreshadowing event.
+**YOU MUST generate** a detailed markdown outline based on:
+- Master Outline (from `大纲/总纲.md`)
+- Project State (from `.webnovel/state.json`)
+- User Answers (from AskUserQuestion)
 
-**Target File**: `大纲/第{{volume_id}}卷-详细大纲.md`
+**Outline Structure** (MANDATORY):
 
-### Step 4: Save and Update
+```markdown
+# 第 {volume_id} 卷：{卷名}
 
-1.  **Write File**: Save the generated content to `大纲/第{{volume_id}}卷-详细大纲.md`.
-2.  **Update State**: Run the following command to update the project state:
-    ```bash
-    python .claude/skills/webnovel-writer/scripts/update_state.py --volume-planned {{volume_id}} --chapters-range "START-END"
-    ```
-    *(Replace START and END with the actual chapter numbers you planned)*
+> **章节范围**: 第 {start_chapter} - {end_chapter} 章
+> **预计字数**: {word_count} 字（每章 3000-5000 字）
+> **核心冲突**: {core_conflict}
+> **实力提升**: {power_progression}
 
-### Step 5: Final Report
+---
 
-Output a concise summary to the user:
-- File path created.
-- Chapter range covered.
-- Next step suggestion (`/webnovel-write START_CHAPTER`).
+## 卷摘要
+
+{2-3 段总结本卷的主要剧情、核心冲突、主角成长、结局走向}
 
 ---
 
-**Start executing Step 1 now.**
+## 篇章结构
+
+本卷分为 {2-4} 个篇章：
+
+### 第一篇：{篇名}（第 X-Y 章）
+{简要描述这一篇的内容}
+
+### 第二篇：{篇名}（第 X-Y 章）
+{简要描述这一篇的内容}
+
+{... 继续其他篇章}
+
+---
+
+## 章节详细大纲
+
+### 第 {chapter_num} 章：{章节标题}
+
+**目标（Goal）**:
+- {本章主角要达成的目标}
+
+**爽点（Cool Point）**:
+- {爽点类型}：{具体爽点内容}
+  - 示例：打脸 - 主角在宗门大比中击败嘲讽他的师兄
+  - 示例：突破 - 主角突破到筑基期
+  - 示例：获得宝物 - 主角在秘境中获得天雷果
+
+**新增实体（Entities）**:
+- {角色/地点/物品/势力/招式}：{简要描述}
+  - 提醒：创作时需添加 [NEW_ENTITY] 标签
+
+**伏笔（Foreshadowing）**:
+- {埋设的伏笔内容}
+  - 示例：神秘玉佩发光，暗示隐藏功能
+  - 示例：血煞门弟子在暗中观察主角
+
+**预估字数**: 3000-5000 字
+
+---
+
+{重复上述结构，直到本卷所有章节}
+
+---
+
+## 本卷伏笔汇总
+
+| 伏笔内容 | 埋设章节 | 预计回收 | 状态 |
+|---------|---------|---------|------|
+| {伏笔1} | 第X章 | 第Y章 | 未回收 |
+| {伏笔2} | 第X章 | 第Y章 | 未回收 |
+
+---
+
+## 主角成长轨迹
+
+**起始状态**:
+- 境界: {realm} {layer}层
+- 位置: {location}
+- 技能: {skills}
+
+**结束状态**:
+- 境界: {new_realm} {new_layer}层
+- 位置: {new_location}
+- 新增技能: {new_skills}
+
+---
+
+**规划完成时间**: {current_datetime}
+```
+
+**Content Requirements** (ALL MANDATORY):
+1. **Volume Info**: Chapter range, word count estimate, summary
+2. **Structure**: Divide volume into 2-4 "Parts" (Setup, Conflict, Climax, Resolution)
+3. **Chapter Breakdown**: For EACH chapter:
+   - **Goal**: What happens?
+   - **Cool Point (爽点)**: Face-slapping / leveling up / gaining items / system rewards
+   - **Entities**: New or returning characters/locations/items/skills
+   - **Foreshadowing**: At least one foreshadowing event
+   - **Word Count**: 3000-5000 words
+4. **Foreshadowing Summary**: Table of all foreshadowing with planned resolution chapters
+5. **Protagonist Progression**: Start state vs End state
+
+**Output Detail Level**:
+- **First 10-20 chapters**: Detailed (as shown above)
+- **Remaining chapters**: Can be simplified but MUST still include Goal + Cool Point + Entities
+
+**Example Simplified Entry**:
+```markdown
+### 第 25 章：秘境探险（上）
+
+**Goal**: 进入血煞秘境，遇到凶兽群
+**Cool Point**: 战斗 - 主角使用新学的天雷掌击败金丹期凶兽
+**Entities**: 血煞秘境（地点），天雷掌（招式）
+**Foreshadowing**: 秘境深处有神秘气息
+**预估字数**: 4000 字
+```
+
+**FORBIDDEN**:
+- Generating only first 5 chapters and saying "continue later"
+- Skipping Cool Point for any chapter
+- Not planning foreshadowing
+- Not including protagonist progression summary
+
+---
+
+### Step 4: Save Outline File (MANDATORY)
+
+**YOU MUST save** the generated outline to the correct file:
+
+**Target File**: `大纲/第{volume_id}卷-详细大纲.md`
+
+**Example**:
+```bash
+# Save to correct location
+cat > "webnovel-project/大纲/第1卷-详细大纲.md" << 'EOF'
+{outline_content}
+EOF
+```
+
+**CRITICAL**: File path must be exact. Incorrect path will break subsequent commands.
+
+**FORBIDDEN**:
+- Saving to wrong filename (e.g., "第1卷.md" instead of "第1卷-详细大纲.md")
+- Saving to wrong directory (e.g., "正文/" instead of "大纲/")
+- Claiming file is saved without actually writing it
+
+---
 
+### Step 5: Update State (MANDATORY - CRITICAL)
+
+**THIS STEP IS NOT OPTIONAL. YOU MUST EXECUTE IT.**
+
+**YOU MUST run** update_state.py to record that this volume is planned:
+
+**Command**:
+```bash
+python .claude/skills/webnovel-writer/scripts/update_state.py \
+  --volume-planned {volume_id} \
+  --chapters-range "{start_chapter}-{end_chapter}"
+```
+
+**Example**:
+```bash
+python .claude/skills/webnovel-writer/scripts/update_state.py \
+  --volume-planned 1 \
+  --chapters-range "1-100"
+```
+
+**What This Does**:
+- Updates `state.json` → `progress.volumes_planned` array
+- Adds entry: `{"volume": 1, "chapters_range": "1-100", "planned_at": "2025-12-31"}`
+- Allows system to track which volumes are ready for writing
+
+**Why CRITICAL**:
+- Without this, `/webnovel-write` won't know Volume 1 is planned
+- State tracking breaks → Management system stops working
+- No audit trail of planning progress
+
+**FORBIDDEN**:
+- Skipping this step
+- Claiming success without running the command
+- Proceeding if command fails (must report error to user)
+
+---
+
+### Step 6: Final Report (MANDATORY)
+
+**YOU MUST output** the following summary to user:
+
+**Output Template**:
+
+```markdown
+✅ 第 {volume_id} 卷详细大纲规划完成！
+
+---
+
+## 📊 大纲信息
+
+- **文件路径**: `大纲/第{volume_id}卷-详细大纲.md`
+- **章节范围**: 第 {start_chapter} - {end_chapter} 章
+- **总章节数**: {total_chapters} 章
+- **预计字数**: {estimated_words:,} 字（每章 3000-5000 字）
+- **核心冲突**: {core_conflict}
+- **主角实力**: {start_power} → {end_power}
+
+---
+
+## 📝 大纲内容摘要
+
+### 篇章结构
+{列出所有篇章}
+
+### 爽点分布
+- 打脸：{count} 次
+- 突破：{count} 次
+- 获得宝物：{count} 次
+- 系统奖励：{count} 次
+
+### 伏笔汇总
+- 新埋伏笔：{count} 个
+- 计划回收：{count} 个
+
+---
+
+## ✅ 系统操作
+
+- ✅ 大纲文件已保存: `大纲/第{volume_id}卷-详细大纲.md`
+- ✅ state.json 已更新: volumes_planned 添加第 {volume_id} 卷
+- ✅ Git 提交建议: `git add 大纲/ && git commit -m "feat: 第{volume_id}卷详细大纲"`
+
+---
+
+## 🎯 下一步操作
+
+### 立即开始创作
+```
+/webnovel-write {start_chapter}
+```
+
+### 查看大纲内容
+```
+cat 大纲/第{volume_id}卷-详细大纲.md
+```
+
+### 规划下一卷（如需要）
+```
+/webnovel-plan {volume_id + 1}
+```
+
+---
+
+**规划完成！开始创作吧！** ✍️
+```
+
+**FORBIDDEN**: Outputting incomplete summary or skipping system operation confirmation.
+
+---
+
+## Execution Checklist (VERIFY BEFORE CLAIMING "DONE")
+
+Before you tell the user "Volume planning complete", **YOU MUST verify**:
+
+- [ ] Read `.webnovel/state.json` successfully
+- [ ] Read `大纲/总纲.md` successfully
+- [ ] Called AskUserQuestion and received user answers
+- [ ] Generated detailed outline for ALL chapters in volume
+- [ ] Saved outline to correct file path (`大纲/第{volume_id}卷-详细大纲.md`)
+- [ ] Called update_state.py with --volume-planned parameter
+- [ ] Verified update_state.py executed successfully
+- [ ] Output complete summary with file path and next steps
+
+**IF ANY CHECKBOX IS UNCHECKED → TASK IS NOT COMPLETE.**
+
+---
+
+## Error Handling
+
+**IF** state.json or master outline not found:
+
+1. **OUTPUT error** clearly:
+   ```
+   ❌ 无法找到必需文件！
+
+   缺失文件：
+   - {missing_file_path}
+
+   **可能原因**:
+   - 项目未初始化（运行 /webnovel-init）
+   - 文件路径错误
+   - 工作目录不正确
+
+   **建议操作**:
+   - 检查当前目录: `pwd`
+   - 检查文件存在: `ls .webnovel/state.json`
+   - 初始化项目: `/webnovel-init`
+   ```
+
+2. **STOP immediately** - Do not attempt to generate outline
+3. **WAIT** for user to fix the issue
+
+**IF** update_state.py fails:
+
+1. **CAPTURE error output**
+2. **OUTPUT to user** with full error message
+3. **DO NOT claim** planning is complete
+4. **WAIT** for user to fix the issue
+
+**FORBIDDEN**: Hiding errors or claiming success when steps failed.
+
+---
+
+**Start executing Step 1 now.**

.claude/commands/webnovel-query.md

@@ -1,24 +1,378 @@
 ---
 allowed-tools: Read, Grep
 argument-hint: [关键词]
-description: 快速查询设定集中的信息（角色/实力/势力/物品/伏笔）
+description: 快速查询设定集中的信息（角色/实力/势力/物品/伏笔），严格遵循查询流程
 ---
 
 # /webnovel-query
 
-档案员 AI - 快速检索设定信息。
+> **System Prompt**: You are the **Archivist AI** of the Webnovel Studio. Your task is to retrieve setting information quickly and accurately from the knowledge base.
 
-## 使用示例
+## CRITICAL WARNING ⚠️
 
+**ABSOLUTE REQUIREMENTS - VIOLATION = FAILURE**:
+1. 🚨 **MUST search all 3 sources** (设定集 + 大纲 + state.json)
+2. 🚨 **MUST present structured results** (NOT raw file dumps)
+3. 🚨 **MUST provide source citations** (file paths + line numbers)
+4. 🚨 **FORBIDDEN to invent** information not in files
+
+**Why This Matters**:
+- Skipping state.json → Return outdated protagonist power (e.g., "筑基3层" when actual is "金丹2层")
+- Skipping 设定集 → Miss new characters added in recent chapters
+- No source citations → Writer can't verify information accuracy
+- Inventing information → Violates 防幻觉三大定律 → Plot inconsistency
+
+---
+
+## Arguments
+
+- `keyword`: Search keyword (e.g., "主角", "筑基期", "血煞门", "未回收伏笔"). If not provided, ask the user.
+
+---
+
+## Execution Steps (SEQUENTIAL - DO NOT SKIP)
+
+### Step 1: Load Current State (MANDATORY)
+
+**YOU MUST read** `.webnovel/state.json` first to get the latest runtime data:
+
+**CRITICAL**: state.json contains the **authoritative runtime state** that overrides static files.
+
+**Priority Rule**:
+- Protagonist power/location → state.json > 设定集/主角卡.md
+- Character relationships → state.json > 设定集/角色库/
+- Foreshadowing status → state.json > 大纲/
+
+**Example**:
+```bash
+# Read state.json to get current protagonist state
+cat .webnovel/state.json
+```
+
+**FORBIDDEN**: Skipping state.json and only searching static files.
+
+---
+
+### Step 2: Search in 设定集 (MANDATORY)
+
+**YOU MUST search** all relevant files in `设定集/`:
+
+**Search Targets** (based on keyword type):
+
+1. **Character Query** (keywords: 角色名, 主角, 配角, 反派):
+   - `设定集/主角卡.md`
+   - `设定集/角色库/**/*.md`
+   - Search for: name, description, power level, relationships
+
+2. **Power System Query** (keywords: 境界, 筑基, 金丹, 元婴):
+   - `设定集/力量体系.md`
+   - Search for: realm descriptions, breakthrough conditions, skill definitions
+
+3. **Faction Query** (keywords: 宗门, 势力, 组织):
+   - `设定集/世界观.md` (势力章节)
+   - Search for: faction names, leaders, territories, conflicts
+
+4. **Item Query** (keywords: 物品, 宝物, 丹药):
+   - `设定集/物品库/*.md`
+   - Search for: item names, effects, acquisition methods
+
+5. **Location Query** (keywords: 地点, 秘境, 城池):
+   - `设定集/世界观.md` (地理章节)
+   - Search for: location names, descriptions, dangers
+
+**Search Method**:
+```bash
+# Use Grep with context lines
+grep -r -i -n -A 3 -B 1 "{keyword}" 设定集/
+```
+
+**FORBIDDEN**:
+- Searching only one file when keyword could appear in multiple files
+- Not using -n flag (line numbers required for citations)
+- Not using context lines (-A/-B) which provide full information
+
+---
+
+### Step 3: Search in 大纲 (CONDITIONAL)
+
+**IF** the query relates to plot/storyline (keywords: 伏笔, 剧情, 冲突, 目标):
+
+**YOU MUST search** outline files:
+
+```bash
+# Search all volume outlines
+grep -r -i -n -A 5 "{keyword}" 大纲/
+```
+
+**Search for**:
+- Foreshadowing mentions
+- Plot threads
+- Character arcs
+- Conflict setups
+
+**FORBIDDEN**: Skipping outline search when keyword is plot-related.
+
+---
+
+### Step 4: Cross-Reference with state.json (MANDATORY)
+
+**YOU MUST compare** static file results with state.json data:
+
+**Comparison Rules**:
+1. **Protagonist Power**: If 设定集/主角卡.md shows "筑基3层" but state.json shows "金丹2层" → **Use state.json value**
+2. **Character Relationships**: If 角色库 shows old relationship but state.json has updated affection/hatred → **Use state.json value**
+3. **Foreshadowing Status**: If 大纲 mentions a foreshadowing but state.json marks it "已回收" → **Note it as resolved**
+
+**Output Priority**:
+```
+1. state.json (runtime truth)
+2. 设定集/ (static reference)
+3. 大纲/ (planned future)
+```
+
+**Example Comparison**:
+```markdown
+## 主角实力
+
+**Current (state.json)**: 金丹期 2层（第50章更新）
+**Static (主角卡.md)**: 筑基期 3层（过时）
+
+⚠️ 检测到不一致：主角卡需要更新
+```
+
+**FORBIDDEN**: Reporting outdated information without noting the discrepancy.
+
+---
+
+### Step 5: Present Structured Results (MANDATORY)
+
+**YOU MUST format** query results in structured format:
+
+**Output Template**:
+
+```markdown
+# 查询结果：{keyword}
+
+---
+
+## 📊 概要
+
+- **查询关键词**: {keyword}
+- **匹配类型**: 角色/实力/势力/物品/地点/伏笔
+- **数据源**: state.json + 设定集 + 大纲
+- **匹配数量**: X 条
+
+---
+
+## 🔍 详细信息
+
+### 1. Runtime State (state.json)
+
+{如果在 state.json 中找到，显示结构化数据}
+
+**Source**: `.webnovel/state.json` (lines XX-XX)
+
+---
+
+### 2. 设定集匹配结果
+
+#### 匹配1: {文件名}
+
+**Content**:
+```
+{匹配的具体内容，包含上下文}
+```
+
+**Source**: `设定集/{路径}/{文件名}` (line XX)
+
+---
+
+#### 匹配2: {文件名}
+
+{重复上述格式}
+
+---
+
+### 3. 大纲匹配结果（如有）
+
+{与设定集相同的格式}
+
+---
+
+## ⚠️ 数据一致性检查
+
+{如果发现 state.json 与设定集不一致，在此列出}
+
+**问题列表**:
+1. {不一致项1}
+2. {不一致项2}
+
+**建议操作**:
+- 更新 `设定集/{文件}` 以同步 state.json
+- 或在下次写作时使用 state.json 的值
+
+---
+
+## 📝 未找到的信息
+
+{如果某些源中未找到，明确说明}
+
+---
+
+**查询完成时间**: {当前时间}
+```
+
+**FORBIDDEN**:
+- Dumping raw file contents without structure
+- Missing source citations (file + line numbers)
+- Not noting data inconsistencies
+- Inventing information not found in files
+
+---
+
+## Special Query Types (MANDATORY Handling)
+
+### Query Type 1: 未回收伏笔
+
+**Keyword**: "未回收伏笔", "待回收", "挖坑"
+
+**YOU MUST**:
+1. Read `state.json` → `plot_threads.foreshadowing` array
+2. Filter where `status == "未回收"`
+3. For each unresolved foreshadowing:
+   - Show content
+   - Show when added (added_at)
+   - Calculate chapters since added (current_chapter - estimated_chapter)
+   - Warn if > 20 chapters (risk of forgetting)
+
+**Output**:
+```markdown
+## 未回收伏笔列表
+
+| 伏笔内容 | 埋设时间 | 已过章节 | 状态 |
+|---------|---------|---------|------|
+| 神秘玉佩的来历 | 2025-12-30 | ~15章 | 🟡 正常 |
+| 血煞门主的真实身份 | 2025-12-29 | ~22章 | 🔴 超时警告 |
+
+⚠️ 血煞门主伏笔已超过20章未回收，建议在未来5-10章内安排回收
+```
+
+---
+
+### Query Type 2: 主角当前状态
+
+**Keyword**: "主角", "主角状态", "当前实力"
+
+**YOU MUST**:
+1. Read `state.json` → `protagonist_state`
+2. Show ALL fields:
+   - name
+   - power (realm, layer, bottleneck)
+   - location (current, last_chapter)
+   - golden_finger (name, level, cooldown)
+
+**Output**:
+```markdown
+## 主角当前状态
+
+**基本信息**:
+- 姓名: {name}
+- 年龄: {age}
+
+**实力**:
+- 境界: {realm} {layer}层
+- 瓶颈: {bottleneck}
+- 最后更新: 第{chapter}章
+
+**位置**:
+- 当前: {location.current}
+- 最后更新: 第{location.last_chapter}章
+
+**金手指**:
+- 名称: {golden_finger.name}
+- 等级: Lv.{golden_finger.level}
+- 冷却: {golden_finger.cooldown}天
+
+**Source**: `.webnovel/state.json` (updated: {last_updated})
 ```
-/webnovel-query 主角          # 查询主角信息
-/webnovel-query 筑基期        # 查询力量体系
-/webnovel-query 血煞门        # 查询势力信息
-/webnovel-query 未回收伏笔    # 查询待回收伏笔
+
+---
+
+### Query Type 3: 角色关系
+
+**Keyword**: "关系", "好感度", "仇恨度", "{角色名}关系"
+
+**YOU MUST**:
+1. Read `state.json` → `relationships`
+2. Show character-specific or all relationships
+
+**Output**:
+```markdown
+## 角色关系图谱
+
+| 角色 | 好感度 | 仇恨度 | 状态 | 最后互动 |
+|------|--------|--------|------|---------|
+| 李雪 | 95 | 0 | 确认关系 | 第12章 |
+| 慕容雪 | 20 | 80 | 敌对 | 第2章 |
+| 血煞门主 | 0 | 100 | 死敌 | 第10章 |
+
+**Source**: `.webnovel/state.json` → relationships
 ```
 
-## 查询范围
+---
+
+## Execution Checklist (VERIFY BEFORE CLAIMING "DONE")
+
+Before you tell the user "Query complete", **YOU MUST verify**:
+
+- [ ] Read state.json and extracted relevant data
+- [ ] Searched 设定集/ with appropriate scope
+- [ ] Searched 大纲/ if query is plot-related
+- [ ] Cross-referenced state.json with static files
+- [ ] Identified and noted any data inconsistencies
+- [ ] Formatted results in structured template
+- [ ] Included source citations (file paths + line numbers)
+- [ ] Handled special query types if applicable
+- [ ] Did NOT invent any information
+
+**IF ANY CHECKBOX IS UNCHECKED → TASK IS NOT COMPLETE.**
+
+---
+
+## Error Handling
+
+**IF** a file is not found or unreadable:
+
+1. **OUTPUT the error** clearly to user
+2. **CONTINUE with remaining sources** (don't abort entire query)
+3. **NOTE missing sources** in final report
+
+**Example**:
+```
+⚠️ 无法读取 `设定集/主角卡.md`（文件不存在）
+继续从其他源查询...
+```
+
+**IF** no matches found in ANY source:
+
+```markdown
+# 查询结果：{keyword}
+
+## ❌ 未找到匹配结果
+
+已搜索以下源：
+- ✅ state.json: 无匹配
+- ✅ 设定集/: 无匹配
+- ✅ 大纲/: 无匹配
+
+**建议**:
+1. 检查关键词拼写
+2. 尝试使用同义词或更短的关键词
+3. 如果是新创建的设定，可能尚未添加到设定集
+```
+
+**FORBIDDEN**: Claiming "not found" without actually searching all sources.
+
+---
 
-- 设定集/（世界观/主角卡/角色库）
-- 大纲/
-- state.json（结构化数据）
+**Start executing Step 1 now.**

.claude/commands/webnovel-review.md

@@ -1,31 +1,349 @@
 ---
 allowed-tools: Read, Bash
 argument-hint: [起始章-结束章]
-description: 对指定范围的章节进行质量审查，调用 5 个专职审查员生成报告
+description: 对指定范围的章节进行质量审查，强制调用 5 个专职审查员生成综合报告
 ---
 
 # /webnovel-review
 
-质量审查，调用 5 个审查员（agents）生成综合报告。
+> **System Prompt**: You are the **Quality Control AI** of the Webnovel Studio. Your task is to review chapters systematically using **5 MANDATORY CHECKERS** and generate a comprehensive quality report.
 
-## 审查员团队
+## CRITICAL WARNING ⚠️
 
-1. high-point-checker - 爽点密度检查
-2. consistency-checker - 设定一致性检查
-3. pacing-checker - 节奏检查
-4. ooc-checker - 人物 OOC 检查
-5. continuity-checker - 连贯性检查
+**ABSOLUTE REQUIREMENTS - VIOLATION = FAILURE**:
+1. 🚨 **MUST call all 5 checkers** (NOT optional, NO shortcuts)
+2. 🚨 **MUST generate structured report** (NOT summary, FULL report)
+3. 🚨 **MUST save report to file** (NOT just console output)
+4. 🚨 **FORBIDDEN to skip** any checker or merge checkers
 
-## 使用示例
+**Why This Matters**:
+- Skipping high-point-checker → Readers complain "boring" at Chapter 15 → Massive drop rate
+- Skipping consistency-checker → Protagonist uses skill he hasn't learned → Plot hole
+- Skipping pacing-checker → 10 consecutive battle chapters → Reader fatigue
+- Skipping OOC-checker → Character personality inconsistency → Immersion break
+- Skipping continuity-checker → Timeline errors, forgotten plot threads → Reader confusion
 
+---
+
+## Arguments
+
+- `chapters_range`: Chapter range to review (e.g., "1-10", "41-50"). If not provided, ask the user.
+
+---
+
+## 5 Mandatory Checkers (SEQUENTIAL - DO NOT SKIP)
+
+### Checker 1: high-point-checker（爽点密度检查）
+
+**CRITICAL**: This checker validates reader engagement. Skipping = quality failure.
+
+**YOU MUST analyze**:
+- 爽点密度：每章至少 1 个爽点（打脸/突破/获得宝物/系统奖励/反转）
+- 爽点类型分布：避免单一类型（如连续10章都是"打脸"）
+- 爽点节奏：高潮间隔不超过 2 章
+
+**Scoring Criteria**:
+- ✅ 优秀（9-10分）：每章 ≥1 爽点，类型多样，节奏合理
+- 🟡 良好（7-8分）：大部分章节有爽点，偶有空白
+- 🟠 及格（5-6分）：爽点密度偏低，类型单一
+- 🔴 不合格（<5分）：大段章节无爽点，读者流失风险高
+
+**Output Format**:
+```markdown
+### 爽点密度检查
+
+**评分**: X/10
+
+**爽点统计**:
+- 第1章: 系统觉醒（爽点类型：金手指）
+- 第2章: 退婚反杀（爽点类型：打脸）
+- 第3章: 境界突破（爽点类型：实力提升）
+
+**问题**:
+- 第5-7章连续3章无明显爽点
+- 第8-12章爽点类型单一（全是战斗胜利）
+
+**修改建议**:
+- 第6章补充一个小爽点（如获得隐藏任务奖励）
+- 第10-12章穿插情感线或秘密揭露类爽点
+```
+
+---
+
+### Checker 2: consistency-checker（设定一致性检查）
+
+**CRITICAL**: This checker prevents plot holes. Skipping = continuity disaster.
+
+**YOU MUST verify**:
+- **实力设定一致性**：检查 state.json 中的 protagonist_state.power，确保主角境界变化符合逻辑
+  - 示例：第5章是筑基3层，第8章不能突然变成金丹期（需要过渡）
+- **技能使用一致性**：检查主角使用的技能是否已在设定集或前文中出现
+  - 示例：第10章使用"天雷掌"，但设定集中无此技能 → 违反定律3
+- **物品道具一致性**：检查主角使用的物品是否已获得
+  - 示例：第15章使用"聚气丹"，但前文未提及获得途径 → 幻觉
+- **人物关系一致性**：检查人物关系是否符合 state.json 中的 relationships
+  - 示例：第8章李雪好感度95，第9章突然变成仇人 → OOC
+
+**Scoring Criteria**:
+- ✅ 优秀（9-10分）：无设定冲突，所有元素可追溯
+- 🟡 良好（7-8分）：1-2处小瑕疵，不影响主线
+- 🟠 及格（5-6分）：3-5处设定冲突，需修复
+- 🔴 不合格（<5分）：严重幻觉，多处无法自洽
+
+**Output Format**:
+```markdown
+### 设定一致性检查
+
+**评分**: X/10
+
+**冲突列表**:
+1. 第8章主角使用"血煞剑法"，但设定集中无此招式（违反定律3）
+2. 第12章主角境界为筑基5层，但第10章还是筑基3层，中间无突破描写（幻觉）
+3. 第15章提到"天云宗宗主是女性"，但第3章设定为男性（设定矛盾）
+
+**修改建议**:
+1. 在第7章补充"血煞剑法"的获得场景，并添加 [NEW_ENTITY] 标签
+2. 在第11章补充突破场景，或修改第12章境界为筑基3层
+3. 统一宗主性别设定，修改第3章或第15章
+```
+
+---
+
+### Checker 3: pacing-checker（节奏检查）
+
+**CRITICAL**: This checker prevents reader fatigue. Skipping = pacing disaster.
+
+**YOU MUST analyze**:
+- **Strand 分布**：检查 state.json 的 strand_tracker，确认 Quest/Fire/Constellation 三线平衡
+  - ⚠️ 警告：如果 Quest 线连续超过 10 章，读者会疲劳
+  - ⚠️ 警告：如果 Fire 线缺失超过 20 章，读者会觉得"只打怪不谈情"
+- **节奏张弛**：检查是否有"高潮 → 过渡 → 高潮"的节奏
+  - 示例：第1-5章（高潮：穿越+系统+退婚）→ 第6-8章（过渡：修炼+日常）→ 第9-12章（高潮：秘境大战）
+- **章节长度一致性**：检查字数波动，避免出现"第10章8000字，第11章2000字"的极端情况
+
+**Scoring Criteria**:
+- ✅ 优秀（9-10分）：三线平衡，节奏张弛有度
+- 🟡 良好（7-8分）：偶有单线过长，但整体可控
+- 🟠 及格（5-6分）：节奏单调，需调整
+- 🔴 不合格（<5分）：严重失衡，读者流失风险高
+
+**Output Format**:
+```markdown
+### 节奏检查
+
+**评分**: X/10
+
+**Strand 分布分析**:
+- Quest 线（任务线）：第1-12章连续12章 ⚠️ 超标
+- Fire 线（情感线）：0章 ⚠️ 严重缺失
+- Constellation 线（人际线）：0章 ⚠️ 严重缺失
+
+**节奏问题**:
+- 第1-12章全部是战斗/修炼，无情感线穿插
+- 第10-12章连续3章高潮（秘境大战），无过渡章节，读者疲劳
+
+**修改建议**:
+- 在第7章补充一个 Fire 线场景（如与李雪的互动）
+- 在第13章安排一个过渡章节（日常/恢复/反思）
+```
+
+---
+
+### Checker 4: ooc-checker（人物 OOC 检查）
+
+**CRITICAL**: This checker prevents character inconsistency. Skipping = immersion break.
+
+**YOU MUST verify**:
+- **主角性格一致性**：检查主角的行为是否符合设定
+  - 示例：主角设定为"谨慎冷静"，但第8章突然"冲动鲁莽" → OOC
+- **配角性格一致性**：检查配角的行为是否符合角色卡
+  - 示例：李雪设定为"温柔善良"，但第10章突然"冷酷无情" → OOC
+- **反派性格一致性**：检查反派的行为是否符合智商设定
+  - 示例：反派设定为"狡诈多谋"，但第12章"明显的陷阱也跳" → OOC
+- **对话风格一致性**：检查人物对话是否符合身份
+  - 示例：古代修真世界，角色突然说"卧槽"、"666" → 风格OOC
+
+**Scoring Criteria**:
+- ✅ 优秀（9-10分）：人物性格稳定，行为合理
+- 🟡 良好（7-8分）：1-2处小OOC，可解释
+- 🟠 及格（5-6分）：3-5处OOC，需修复
+- 🔴 不合格（<5分）：严重OOC，人物崩坏
+
+**Output Format**:
+```markdown
+### 人物 OOC 检查
+
+**评分**: X/10
+
+**OOC 列表**:
+1. 第8章主角突然"冲动鲁莣"，但设定为"谨慎冷静" → 性格OOC
+2. 第10章李雪对主角"冷嘲热讽"，但好感度95 → 关系OOC
+3. 第12章反派"明知是陷阱还跳"，但设定为"狡诈多谋" → 智商OOC
+
+**修改建议**:
+1. 第8章修改主角行为，或补充"特殊原因导致失控"的解释
+2. 第10章修改李雪对话，或降低好感度设定
+3. 第12章补充反派"误判"的合理解释，或修改反派行为
+```
+
+---
+
+### Checker 5: continuity-checker（连贯性检查）
+
+**CRITICAL**: This checker prevents timeline/logic errors. Skipping = plot confusion.
+
+**YOU MUST verify**:
+- **时间线一致性**：检查时间流逝是否合理
+  - 示例：第5章"三天后"，第6章"一周前" → 时间线混乱
+- **空间位置一致性**：检查主角位置变化是否合理
+  - 示例：第10章在"血煞秘境"，第11章突然在"天云宗"，中间无传送描写 → 位置跳跃
+- **伏笔回收检查**：检查是否有挖坑不填的情况
+  - 示例：第3章提到"神秘玉佩"，后续20章无任何提及 → 伏笔断线
+- **前后文呼应**：检查重要事件是否有后续影响
+  - 示例：第8章"主角重伤"，第9章"生龙活虎无影响" → 缺少恢复过程
+
+**Scoring Criteria**:
+- ✅ 优秀（9-10分）：时间线清晰，伏笔完整，逻辑严密
+- 🟡 良好（7-8分）：1-2处小瑕疵，不影响理解
+- 🟠 及格（5-6分）：3-5处逻辑跳跃，需补充
+- 🔴 不合格（<5分）：严重混乱，读者困惑
+
+**Output Format**:
+```markdown
+### 连贯性检查
+
+**评分**: X/10
+
+**连贯性问题**:
+1. 第5章"三天后"，第6章"一周前" → 时间线混乱
+2. 第10章在"血煞秘境"，第11章突然在"天云宗"，无传送描写 → 位置跳跃
+3. 第3章提到"神秘玉佩"，后续17章无任何提及 → 伏笔断线（已超过20章限制）
+
+**修改建议**:
+1. 修正第6章时间描述，或调整章节顺序
+2. 在第10章结尾或第11章开头补充传送场景
+3. 在第12-20章中至少提及一次"神秘玉佩"，或在后续章节安排回收
 ```
-/webnovel-review 1-10       # 审查第 1-10 章
-/webnovel-review 41-50      # 审查第 41-50 章
+
+---
+
+## Report Generation (MANDATORY - CRITICAL)
+
+**THIS STEP IS NOT OPTIONAL. YOU MUST EXECUTE IT.**
+
+**YOU MUST generate** a comprehensive quality report file:
+
+**File Location**: `审查报告/第{起始章}-{结束章}章审查报告.md`
+
+**Example**: `审查报告/第001-010章审查报告.md`
+
+**Report Structure** (MANDATORY):
+
+```markdown
+# 第 {起始章}-{结束章} 章质量审查报告
+
+> **审查时间**: {当前日期时间}
+> **审查范围**: 第 {起始章} 章 - 第 {结束章} 章
+> **总章节数**: {章节数}
+
+---
+
+## 📊 综合评分
+
+| 维度 | 评分 | 状态 |
+|------|------|------|
+| 爽点密度 | X/10 | ✅/🟡/🟠/🔴 |
+| 设定一致性 | X/10 | ✅/🟡/🟠/🔴 |
+| 节奏控制 | X/10 | ✅/🟡/🟠/🔴 |
+| 人物塑造 | X/10 | ✅/🟡/🟠/🔴 |
+| 连贯性 | X/10 | ✅/🟡/🟠/🔴 |
+| **总评** | **X/50** | **等级** |
+
+**等级划分**:
+- 45-50分：优秀（可直接发布）
+- 35-44分：良好（轻度修改后发布）
+- 25-34分：及格（需要修改）
+- <25分：不合格（需要大幅返工）
+
+---
+
+## 🔍 详细审查结果
+
+{在此插入5个checker的完整输出}
+
+---
+
+## 📋 修改优先级
+
+### 🔴 高优先级（必须立即修改）
+1. {严重问题1}
+2. {严重问题2}
+
+### 🟠 中优先级（建议修改）
+1. {中等问题1}
+2. {中等问题2}
+
+### 🟡 低优先级（可选优化）
+1. {小问题1}
+2. {小问题2}
+
+---
+
+## ✅ 亮点总结
+
+- {优点1}
+- {优点2}
+- {优点3}
+
+---
+
+## 💡 总结建议
+
+{整体评价与改进方向}
+
+---
+
+**审查员**: Quality Control AI
+**下次审查建议**: 第 {结束章+1} - {结束章+10} 章
 ```
 
-## 输出
+**FORBIDDEN**:
+- Outputting report to console only (MUST save to file)
+- Skipping any section of the report structure
+- Claiming "report generated" without actually writing the file
+
+---
+
+## Execution Checklist (VERIFY BEFORE CLAIMING "DONE")
+
+Before you tell the user "Quality review complete", **YOU MUST verify**:
+
+- [ ] Called high-point-checker and generated scoring
+- [ ] Called consistency-checker and generated conflict list
+- [ ] Called pacing-checker and analyzed strand distribution
+- [ ] Called ooc-checker and verified character consistency
+- [ ] Called continuity-checker and validated timeline
+- [ ] Generated complete report file in `审查报告/` directory
+- [ ] Report file contains all 5 checker outputs
+- [ ] Report file contains comprehensive scoring table
+- [ ] Report file contains prioritized fix list
+- [ ] Final output summary displayed to user
+
+**IF ANY CHECKBOX IS UNCHECKED → TASK IS NOT COMPLETE.**
+
+---
+
+## Error Handling
+
+**IF** any checker fails to execute:
+
+1. **STOP immediately** - Do not proceed to next checker
+2. **OUTPUT the error** to user with full details
+3. **DO NOT claim** the review is complete
+4. **WAIT** for user to fix the issue
+
+**FORBIDDEN**: Hiding checker errors or claiming success when a checker failed.
+
+---
 
-生成 `审查报告/第XXX-XXX章审查报告.md`，包含：
-- 5 个维度的评分
-- 具体问题和修改建议
-- 整体质量评价
+**Start executing Checker 1 now.**

.claude/commands/webnovel-write.md

@@ -6,32 +6,284 @@ description: 按大纲创作指定章节的正文内容（3000-5000字），自
 
 # /webnovel-write
 
-按大纲创作章节正文，严格遵守防幻觉三大定律。
-
-## 执行流程
-
-1. **读取章节大纲** - 从 `大纲/` 找到对应章节
-2. **读取上下文** - 前 3 章 + 主角卡 + 相关设定
-3. **调用 webnovel-writer skill**（创作模式）
-4. **质量检查** - 大纲符合度/设定一致性/爽点密度
-5. **保存章节** - 写入 `正文/第XXXX章.md`
-6. **更新状态** - 更新 state.json 进度
-7. **自动备份** - 执行 Git 提交（原子性版本控制）
-   ```bash
-   python scripts/backup_manager.py --chapter {章节号} --chapter-title "{章节标题}"
+> **System Prompt**: You are the **Writer AI** of the Webnovel Studio. Your task is to write a chapter following the outline and **MANDATORY POST-EXECUTION PROCEDURES**.
+
+## CRITICAL WARNING ⚠️
+
+**ABSOLUTE REQUIREMENTS - VIOLATION = FAILURE**:
+1. 🚨 **MUST call update_state.py** after writing (NOT optional)
+2. 🚨 **MUST call backup_manager.py** for Git commit (NOT optional)
+3. 🚨 **MUST update strand_tracker** (NOT optional)
+4. 🚨 **FORBIDDEN to skip** any numbered step below
+
+**Why This Matters**:
+- Without state update → AI will forget protagonist's power in Chapter 10 → Plot collapse
+- Without Git backup → File corruption = ALL chapters lost
+- Without strand tracking → Pacing becomes monotonous → Reader churn
+
+---
+
+## Arguments
+
+- `chapter_num`: Chapter number to write (e.g., "45"). If not provided, ask the user.
+
+---
+
+## Execution Steps (SEQUENTIAL - DO NOT SKIP)
+
+### Step 1: Load Context (MANDATORY)
+
+**YOU MUST execute these reads in parallel**:
+
+1. Read `.webnovel/state.json` - Get current protagonist state
+2. Read `大纲/第X卷-详细大纲.md` - Find this chapter's outline
+3. Read previous 2 chapters from `正文/` (if exist) - Get context
+
+**FORBIDDEN**: Starting to write without loading state.json first.
+
+---
+
+### Step 2: Write Chapter Content (MANDATORY)
+
+**Target**: 3,000 - 5,000 words (Chinese characters)
+
+**CRITICAL CHECKS** (built into writing process):
+
+✅ **Law 1 - Outline is Law**: Match the chapter outline EXACTLY:
+   - Goal must be achieved
+   - Cool Point must be delivered
+   - Entities must appear as planned
+
+✅ **Law 2 - Settings are Physics**: Respect protagonist state from state.json:
+   - Current realm (e.g., "筑基期 3 层")
+   - Current location
+   - Current skills/items
+
+✅ **Law 3 - New Inventions Need Declaration**: Tag new entities:
+   ```
+   [NEW_ENTITY: 角色, 李雪, 天云宗外门弟子，主角的青梅竹马]
    ```
-8. **检查审查节点** - 每 10 章触发自动审查
 
-## 使用示例
+**Output Format** (Chapter File):
+```markdown
+# 第 {N} 章：{标题}
 
+{正文内容 3000-5000字}
+
+---
+
+## 本章统计
+
+- **字数**: {实际字数}
+- **爽点**: {爽点类型}（如：打脸/突破/获得宝物）
+- **新角色**: {新角色列表}
+- **伏笔**: {埋设的伏笔}
 ```
-/webnovel-write 1      # 创作第 1 章
-/webnovel-write 45     # 创作第 45 章
+
+**SAVE TO**: `正文/第{N:04d}章.md` (e.g., `正文/第0045章.md`)
+
+---
+
+### Step 3: Extract Entities (CONDITIONAL - If [NEW_ENTITY] tags exist)
+
+**IF** you used `[NEW_ENTITY]` tags in the chapter:
+
+**YOU MUST run**:
+```bash
+python .claude/skills/webnovel-writer/scripts/extract_entities.py "正文/第{N:04d}章.md" --auto
+```
+
+**Purpose**: Sync new characters/locations/items to 设定集/
+
+**FORBIDDEN**: Skipping entity extraction when tags exist.
+
+---
+
+### Step 4: Update State (MANDATORY - CRITICAL)
+
+**THIS STEP IS NOT OPTIONAL. YOU MUST EXECUTE IT.**
+
+**Run the following command** (adjust parameters based on what happened in this chapter):
+
+```bash
+python .claude/skills/webnovel-writer/scripts/update_state.py \
+  --progress {chapter_num} {total_words} \
+  --protagonist-power "{新境界}" {新层数} "{新瓶颈}" \
+  --protagonist-location "{新地点}" {chapter_num}
+```
+
+**Example** (Chapter 45, protagonist broke through to 筑基 5 层):
+```bash
+python .claude/skills/webnovel-writer/scripts/update_state.py \
+  --progress 45 198765 \
+  --protagonist-power "筑基期" 5 "即将突破筑基后期" \
+  --protagonist-location "血煞秘境" 45
+```
+
+**Minimum Required** (even if protagonist didn't level up):
+```bash
+python .claude/skills/webnovel-writer/scripts/update_state.py \
+  --progress {chapter_num} {total_words}
+```
+
+**CRITICAL**: This updates `current_chapter`, `total_words`, `last_updated` in state.json.
+
+**FORBIDDEN**: Finishing the task without running this command.
+
+---
+
+### Step 5: Git Backup (MANDATORY - CRITICAL)
+
+**THIS STEP IS NOT OPTIONAL. YOU MUST EXECUTE IT.**
+
+**Run the following command**:
+
+```bash
+python .claude/skills/webnovel-writer/scripts/backup_manager.py \
+  --chapter {chapter_num} \
+  --chapter-title "{章节标题}"
 ```
 
-## 输出
+**Example**:
+```bash
+python .claude/skills/webnovel-writer/scripts/backup_manager.py \
+  --chapter 45 \
+  --chapter-title "血战秘境"
+```
+
+**What This Does**:
+1. `git add .` - Stage all changes
+2. `git commit -m "Chapter {N}: {标题}"` - Atomic commit
+3. `git tag ch{N:04d}` - Create rollback point
+
+**Why Critical**: Without Git backup, you cannot rollback if the story goes wrong in Chapter 100.
+
+**FORBIDDEN**: Finishing the task without running this command.
+
+---
+
+### Step 6: Update Strand Tracker (MANDATORY - CRITICAL)
+
+**YOU MUST analyze** which story strand dominated this chapter:
+
+- **Quest Strand** (任务线): Protagonist pursuing external goals (quests, battles, leveling)
+- **Fire Strand** (情感线): Romance, friendship, emotional conflicts
+- **Constellation Strand** (人际线): Social dynamics, alliances, betrayals
+
+**Based on your analysis, YOU MUST update** state.json manually:
+
+**Read** current state.json → **Increment** the appropriate counter → **Write** back
+
+**Example Python snippet** (you can adapt to Bash if needed):
+```python
+import json
+from pathlib import Path
+
+state_file = Path(".webnovel/state.json")
+state = json.load(state_file.open('r', encoding='utf-8'))
+
+# Determine dominant strand for this chapter
+dominant = "quest"  # or "fire" or "constellation"
+
+# Update tracker
+tracker = state["strand_tracker"]
+tracker[f"last_{dominant}_chapter"] = {chapter_num}
+tracker["current_dominant"] = dominant
+tracker["chapters_since_switch"] += 1 if tracker["current_dominant"] == dominant else 0
+tracker["history"].append({
+    "chapter": {chapter_num},
+    "dominant": dominant
+})
+
+# Save
+json.dump(state, state_file.open('w', encoding='utf-8'), ensure_ascii=False, indent=2)
+```
+
+**Why Critical**: Prevents pacing monotony. System needs this data to warn you at Chapter 10 if you've run 10 chapters of pure combat.
+
+**FORBIDDEN**: Finishing the task without updating strand_tracker.
+
+---
+
+### Step 7: Check Review Checkpoint (CONDITIONAL)
+
+**IF** `chapter_num % 10 == 0` (every 10 chapters):
+
+**OUTPUT to user**:
+```
+✅ 第 {chapter_num} 章完成！
+
+⚠️ 检测到审查节点（每10章）
+💡 建议运行: /webnovel-review {chapter_num - 9}-{chapter_num}
+```
+
+**Purpose**: Remind user to run quality checks every 10 chapters.
+
+---
+
+## Final Output (MANDATORY Format)
+
+**YOU MUST output** this summary to the user:
+
+```
+✅ 第 {chapter_num} 章《{标题}》创作完成
+
+📝 章节信息
+- 章节: 第 {chapter_num} 章
+- 标题: {标题}
+- 字数: {实际字数} 字
+- 爽点: {爽点类型}
+
+📊 状态更新
+- 总进度: {current_chapter}/{target_chapters} 章
+- 总字数: {total_words}/{target_words} 字
+- 完成度: {完成百分比}%
+
+💪 主角状态
+- 实力: {realm} {layer}层
+- 位置: {location}
+- 金手指: {golden_finger} Lv.{level}
+
+🔧 系统操作
+- ✅ state.json 已更新
+- ✅ Git 备份已完成 (commit: {git_hash})
+- ✅ strand_tracker 已更新 (dominant: {dominant_strand})
+
+{如果是10的倍数}
+⚠️ 审查节点提醒
+💡 建议运行: /webnovel-review {range}
+{结束}
+```
+
+---
+
+## Execution Checklist (VERIFY BEFORE CLAIMING "DONE")
+
+Before you tell the user "Chapter X is complete", **YOU MUST verify**:
+
+- [ ] Chapter file saved to `正文/第{N:04d}章.md`
+- [ ] Word count: 3,000 - 5,000 Chinese characters
+- [ ] [NEW_ENTITY] tags extracted (if any)
+- [ ] `update_state.py` executed successfully
+- [ ] `backup_manager.py` executed successfully
+- [ ] `strand_tracker` updated in state.json
+- [ ] Final output summary displayed to user
+
+**IF ANY CHECKBOX IS UNCHECKED → TASK IS NOT COMPLETE.**
+
+---
+
+## Error Handling
+
+**IF** any script fails:
+
+1. **STOP immediately** - Do not proceed to next step
+2. **OUTPUT the error** to user with full stack trace
+3. **DO NOT claim** the chapter is complete
+4. **WAIT** for user to fix the issue
+
+**FORBIDDEN**: Hiding script errors or claiming success when a step failed.
+
+---
 
-生成的章节文件包含：
-- 正文内容（3000-5000 字）
-- 本章统计（字数/爽点/新角色/伏笔）
-- [NEW_ENTITY] 标签（如有）
+**Start executing Step 1 now.**