| name | webnovel-plan |
| description | Builds volume and chapter outlines from the total outline, inherits creative constraints, and prepares writing-ready chapter plans. Use when the user asks for outlining or runs /webnovel-plan. |
| allowed-tools | Read Write Edit Grep Bash Task |
Outline Planning
Purpose: refine 总纲 into volume + chapter outlines. Do not redesign the global story.
Setting policy: 先基于 init 产出的总纲+世界观补齐设定集基线；再在卷纲完成后，直接对现有设定集做增量补充。
Project Root Guard
- Claude Code 的“工作区根目录”不一定等于“书项目根目录”。常见结构：工作区为
D:\wk\xiaoshuo，书项目为 D:\wk\xiaoshuo\凡人资本论。
- 必须先解析
PROJECT_ROOT 为真实书项目根（必须包含 .webnovel/state.json），后续所有读写路径都以该目录为准。
环境设置（bash 命令执行前）：
export WORKSPACE_ROOT="${CLAUDE_PROJECT_DIR:-$PWD}"
if [ -z "${CLAUDE_PLUGIN_ROOT}" ] || [ ! -d "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-plan" ]; then
echo "ERROR: 未设置 CLAUDE_PLUGIN_ROOT 或缺少目录: ${CLAUDE_PLUGIN_ROOT}/skills/webnovel-plan" >&2
exit 1
fi
export SKILL_ROOT="${CLAUDE_PLUGIN_ROOT}/skills/webnovel-plan"
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"
export PROJECT_ROOT="$(python "${SCRIPTS_DIR}/webnovel.py" --project-root "${WORKSPACE_ROOT}" where)"
References（按步骤导航）
Reference Loading Levels (strict, lazy)
Use progressive disclosure and load only what current step requires:
- L0: No references before scope/volume is confirmed.
- L1: Before each step, load only the “必读” items in References（按步骤导航）.
- L2: Load optional items only when the trigger condition applies.
Workflow
- Load project data.
- Build setting baseline from 总纲 + 世界观 (in-place incremental).
- Select volume and confirm scope.
- Generate volume beat sheet (节拍表).
4.5. Generate volume timeline (时间线表).
- Generate volume skeleton.
- Generate chapter outlines in batches.
- Enrich existing setting files from volume outline (in-place incremental).
- Validate + save + update state.
1) Load project data
cat "$PROJECT_ROOT/.webnovel/state.json"
cat "$PROJECT_ROOT/大纲/总纲.md"
Optional (only if they exist):
设定集/主角组.md设定集/女主卡.md设定集/反派设计.md设定集/世界观.md设定集/力量体系.md设定集/主角卡.md设定集/典故引用库.md（若存在：本卷引用规划的输入源）设定集/原创诗词口诀.md（若存在：原创口诀优先于外部典故）.webnovel/idea_bank.json (inherit constraints)
If 总纲.md lacks volume ranges / core conflict / climax, ask the user to fill those before proceeding.
创意约束文件完整性检查（Soft warning）:
以下文件若缺失，后续 write 流程会降级处理（不阻断 plan）：
设定集/叙事声音.md（缺失 → style-adapter 使用分题材默认，跨章风格一致性降低）设定集/情感蓝图.md（缺失 → emotion-checker 跳过蓝图对标）设定集/开篇策略.md（缺失 → Ch1-3 使用 Golden Opening Protocol 通用默认）
若缺失，在 plan 开始前提示用户：“建议先运行 /webnovel-init 补齐设定集”。
Step 1.5 · Cross-volume awareness（Round 19 Phase E · upstream@3e36417 借鉴）
下卷规划前必须读已写章节真实数据，不能只看大纲：
-
跑：
python -X utf8 ${SCRIPTS_DIR}/webnovel.py --project-root "${PROJECT_ROOT}" \
state get-recent-meta --last-n 10
取最近 10 章 hook_close / hook_type / unresolved_loops / overall_score / narrative_version。
-
（Phase G 之后追加）跑：
python -X utf8 ${SCRIPTS_DIR}/webnovel.py --project-root "${PROJECT_ROOT}" \
state get-hook-trend --last-n 10
取 4 类钩子分布。
-
在新卷规划必须显式回应：
- 至少 1 个上卷未解决伏笔在本卷开篇 3 章内被触及
- 主角金手指曲线在新卷保持单调或带显式弱化事件
- 上卷读者钩子若 overall_score < 70，新卷开篇加强同类钩子
- 上卷 hook_type 若连续 5+ 章相同 → 新卷必须切换钩子类型
不做 Cross-volume 检查的章节
第 1 卷规划（无前卷数据）→ 跳过 Step 1.5，仅按既有 Step 1 大纲流程。
2) Build setting baseline from 总纲 + 世界观
目标：在不推翻现有内容的前提下，让设定集从“骨架模板”进入“可规划可写作”的基线状态。
输入来源：
大纲/总纲.md设定集/世界观.md设定集/力量体系.md设定集/主角卡.md设定集/反派设计.md
执行规则（必须）：
- 只做增量补齐，不清空、不重写整文件。
- 优先补齐“可执行字段”：角色定位、势力关系、能力边界、代价规则、反派层级映射。
- 若总纲与现有设定冲突，先列冲突并阻断，等待用户裁决后再改。
基线补齐最小要求：
设定集/世界观.md：世界规则边界、社会结构、关键地点用途。设定集/力量体系.md：境界链/能力限制/代价与冷却。设定集/主角卡.md：欲望、缺陷、初始资源与限制。设定集/反派设计.md：小/中/大反派层级与主角镜像关系。
2.5) 卷前调研（必做）
目标：在规划本卷章纲前，通过搜索获取专业知识和创作参考，确保大纲有真实细节支撑。
搜索统一使用 Tavily 直连 API 脚本（${SCRIPTS_DIR}/tavily_search.py），禁止使用 MCP 工具。
卷前调研（至少5次search）：
1. 搜索本卷涉及的专业领域（2-3次）
python -X utf8 "${SCRIPTS_DIR}/tavily_search.py" search "机甲拆解 技术 废品回收" --max 5
python -X utf8 "${SCRIPTS_DIR}/tavily_search.py" search "遗迹暴走 失控机甲 设定参考" --max 5
2. 搜索同题材近6个月内爆款的节奏和创新点（1-2次）
python -X utf8 "${SCRIPTS_DIR}/tavily_search.py" search "科幻机甲 网文 2025 2026 热门 爆款 节奏" --max 5
3. 搜索本卷关键场景类型的写作技巧（1-2次）
python -X utf8 "${SCRIPTS_DIR}/tavily_search.py" search "机甲战斗场景 描写技巧" --max 5
4. 复杂专业领域用深度研究模式
python -X utf8 "${SCRIPTS_DIR}/tavily_search.py" research "太空探索遗迹考古的物理原理和技术细节" --model pro
5. 将调研结果保存到 调研笔记/ 对应主题文件
6. 在后续Step中引用调研笔记作为参考输入
Search 失败处理：同 webnovel-write 的失败协议——立即停止，检查 Tavily API key 配置。
3) Select volume
- Offer choices from 总纲.md (卷名 + 章节范围).
- Confirm any special requirement (tone, POV emphasis, romance, etc.).
If 总纲缺少卷名/章节范围/核心冲突/卷末高潮，先补问并更新总纲，再继续。
4) Generate volume beat sheet (节拍表)
目标：先把本卷“承诺→危机递增→中段反转→最低谷→大兑现+新钩子”钉死，避免卷中段漂移。
Load template:
cat "${SKILL_ROOT}/../../templates/output/大纲-卷节拍表.md"
执行前搜索（推荐）：
python -X utf8 "${SCRIPTS_DIR}/tavily_search.py" search "网文 {题材} 节奏 节拍 结构" --max 5
python -X utf8 "${SCRIPTS_DIR}/tavily_search.py" search "网文 {爽点类型} 写法 案例" --max 5
Must satisfy (hard requirements):
- 中段反转（必填）：不得留空；若无，写
无（理由：...）
- 危机链：至少 3 次递增（表格 1-3 行不得空）
- 卷末新钩子：必须能落到“最后一章的章末未闭合问题”
Write output:
cat > "$PROJECT_ROOT/大纲/第${volume_id}卷-节拍表.md" << 'EOF'
{beat_sheet_content}
EOF
Completion criteria:
大纲/第{volume_id}卷-节拍表.md 存在且非空- Step 4/5 能直接引用 Catalyst / 中段反转 / 最低谷 / 大兑现 / 新钩子来锚定节奏
4.5) Generate volume timeline (时间线表)
目标：为本卷建立时间轴基准，确保章节间时间推进逻辑自洽，避免“第一章灾变第二章火拼”的时间跳跃问题。
Load template:
cat "${SKILL_ROOT}/../../templates/output/大纲-卷时间线.md"
Must satisfy (hard requirements):
- 时间基准（必填）：明确本卷使用的时间体系（末世第X天/仙历年月/现代日期）
- 本卷时间跨度（必填）：本卷覆盖的时间范围
- 关键倒计时事件：若有时限性事件（物资耗尽/大比开始/截止日期），必须列出并标注 D-N
Write output:
cat > "$PROJECT_ROOT/大纲/第${volume_id}卷-时间线.md" << 'EOF'
{timeline_content}
EOF
Completion criteria:
大纲/第{volume_id}卷-时间线.md 存在且非空- 时间基准和本卷跨度已明确
- 若存在倒计时事件，已在表中列出
5) Generate volume skeleton
Load genre profile and apply standards:
cat "${SKILL_ROOT}/../../references/genre-profiles.md"
cat "${SKILL_ROOT}/../../references/shared/strand-weave-pattern.md"
Optional (only if爽点结构需要细化):
cat "${SKILL_ROOT}/../../references/shared/cool-points-guide.md"
Optional (only if需要补强卷级冲突链与强度分层):
cat "${SKILL_ROOT}/references/outlining/conflict-design.md"
Load beat sheet (must exist):
cat "$PROJECT_ROOT/大纲/第{volume_id}卷-节拍表.md"
Extract for current genre:
- Strand 比例（Quest/Fire/Constellation）
- 爽点密度标准（每章最低/推荐）
- 钩子类型偏好
Strand Weave 规划策略
Strand 比例与 Weaving 规则详见规范源：
cat "${SKILL_ROOT}/../../references/shared/strand-weave-pattern.md"
基于 genre profile 分配三线（Quest/Fire/Constellation）章节比例，遵循规范源中的切换阈值和交织模式。
For 电竞/直播文/克苏鲁, apply dedicated volume pacing template:
cat "${SKILL_ROOT}/references/outlining/genre-volume-pacing.md"
爽点密度规划策略
Based on genre profile, adjusted by project pacing_preference (from state.json):
若 state.json 包含 pacing_preference：
- 高频密集 (
coolpoint_frequency: "高频密集"):
- 常规章节: 2-3 个小爽点（强度 2-3）
- 关键章节: 3-4 个爽点，至少 1 个中爽点（强度 4-5）
- 每 3-5 章至少 1 个关键章节
- 每卷
climaxes_per_volume 个高潮章节
- 适中 (
coolpoint_frequency: "适中", 默认):
- 常规章节: 1-2 个小爽点（强度 2-3）
- 关键章节: 2-3 个爽点，至少 1 个中爽点（强度 4-5）
- 每 5-8 章至少 1 个关键章节
- 每卷至少 1 个高潮章节（通常在卷末）
- 慢热积累 (
coolpoint_frequency: "慢热积累"):
- 常规章节: 0-1 个小爽点，允许纯铺垫章
- 关键章节: 2-3 个爽点，至少 1 个中爽点（强度 4-5）
- 每 8-12 章至少 1 个关键章节
- 每卷
climaxes_per_volume 个高潮章节
若 pacing_preference 缺失，使用“适中”默认值。
约束触发规划策略
If idea_bank.json exists:
cat "$PROJECT_ROOT/.webnovel/idea_bank.json"
Calculate trigger frequency:
- 反套路规则: 每 N 章触发 1 次
- N = max(5, 总章数 / 10)
- 例：50 章卷 → 每 5 章触发
- 例：100 章卷 → 每 10 章触发
- 硬约束: 贯穿全卷，在章节目标/爽点设计中体现
- 主角缺陷: 每卷至少 2 次成为冲突来源
- 反派镜像: 反派出场章节必须体现镜像对比
Use this template and fill from 总纲 + idea_bank:
# 第 {volume_id} 卷：{卷名}
> 章节范围: 第 {start} - {end} 章
> 核心冲突: {conflict}
> 卷末高潮: {climax}
## 卷摘要
{2-3 段落概述}
## 关键人物与反派
- 主要登场角色：
- 反派层级：
## Strand Weave 规划
| 章节范围 | 主导 Strand | 内容概要 |
|---------|------------|---------|
## 爽点密度规划
| 章节 | 爽点类型 | 具体内容 | 强度 |
|------|---------|---------|------|
## 伏笔规划
| 章节 | 操作 | 伏笔内容 |
|------|------|---------|
## 引用规划（若 `设定集/典故引用库.md` 存在）
> 从引用库中选取本卷适合的引用，标注章节、载体、伏笔功能。全卷 10-15 处，单章上限 2 处。
| 章 | 引用内容 | 类型/编号 | 载体 | 伏笔 |
|----|---------|----------|------|------|
## 约束触发规划（如有）
- 反套路规则：每 N 章触发一次
- 硬约束：贯穿全卷
6) Generate chapter outlines (batched)
Batching rule:
- ≤20 章：1 批
- 21–40 章：2 批
- 41–60 章：3 批
-
60 章：4+ 批
Optional (only if需要钩子/节奏细分):
cat "${SKILL_ROOT}/../../references/reading-power-taxonomy.md"
Optional (only if需要章节微结构/标题策略细化):
cat "${SKILL_ROOT}/references/outlining/chapter-planning.md"
Chapter generation strategy
For each chapter, determine:
1. Strand assignment (follow volume skeleton distribution)
- Quest: 主线任务推进、目标达成、能力提升
- Fire: 人物关系、情感冲突、团队动态
- Constellation: 世界揭示、伏笔埋设、谜团推进
2. 爽点设计 (based on Strand and position)
- Quest Strand → 成就爽点（打脸、逆袭、突破）
- Fire Strand → 情感爽点（认可、保护、告白）
- Constellation Strand → 认知爽点（真相、预言、身份）
3. 钩子设计 (based on next chapter's Strand)
- 悬念钩子：提出问题、制造危机
- 承诺钩子：预告奖励、暗示转折
- 情感钩子：关系变化、角色危机
4. 反派层级 (based on volume skeleton)
- 无：日常章节、修炼章节、关系章节
- 小：小冲突、小反派、局部对抗
- 中：中反派出场、重要冲突、阶段性对抗
- 大：大反派出场、核心冲突、卷级高潮
5. 关键实体 (new or important)
- 新角色：姓名 + 一句话定位
- 新地点：名称 + 一句话描述
- 新物品：名称 + 功能
- 新势力：名称 + 立场
6. 约束检查 (if idea_bank exists)
- 是否触发反套路规则？
- 是否体现硬约束？
- 是否展现主角缺陷？
- 是否体现反派镜像？
Chapter format (include 反派层级 for context-agent):
### 第 {N} 章：{标题}
- 目标: {20字以内}
- 阻力: {20字以内}
- 代价: {20字以内}
- 时间锚点: {末世第X天 时段/仙历X年X月X日/具体日期+时段}
- 章内时间跨度: {如 3小时/半天/1天}
- 与上章时间差: {如 紧接/6小时/1天/跨夜}
- 倒计时状态: {事件A D-3 -> D-2 / 无}
- 爽点: {类型} - {30字以内} | 预估爽值: 压抑{N}×反转{N}/逻辑{N}→≈{score}
- Strand: {Quest|Fire|Constellation}
- 反派层级: {无/小/中/大}
- 视角/主角: {主角A/主角B/女主/群像}
- 关键实体: {新增或重要出场}
- 本章变化: {30字以内，优先可量化变化}
- 章末未闭合问题: {30字以内}
- 钩子: {类型} - {30字以内} | 强度: {strong/medium/weak}
- 读者情绪: {压抑|紧张|释放|燃|温暖|震撼|好奇|焦虑}
- 氛围/情绪色调: {一句话描述本章的感官底色}
- 场景预案: {2-3个关键场景一句话，如"废品站深夜改装+红光映脸"}
- 对话种子: {1-2句关键对话方向，如"配角A问'你叫什么名字'"}
- 视觉锚点: {最有画面感的1-2个镜头}
- 引用锚点: {若引用库存在且本章在引用规划中：编号+"原文"（载体，伏笔说明）/ 无引用库或本章不引用则省略此字段}
时间字段说明：
- 时间锚点：本章发生的具体时间点，必须与时间线表一致
- 章内时间跨度：本章内容覆盖的时间长度
- 与上章时间差：与上一章结束时间的间隔
- 紧接：无时间间隔，直接承接
- 跨夜：过夜但不超过 12 小时
- 具体时长：如 6小时、1天、3天
- 倒计时状态：若存在倒计时事件，标注推进情况（D-N → D-(N-1)）
字段说明：
- 章末未闭合问题：本章结尾必须保留的“未闭合决策/问题”，用于驱动读者点下一章。
- 规则：必须与 钩子 的类型/强度一致；不得出现“钩子很强但问题很虚”的错配。
- 钩子：本章应设置的章末钩子（规划用）
- 例：悬念钩 - 神秘人身份即将揭晓
- 意思是：本章结尾要设置这个悬念钩子
- 下章 context-agent 会读取 chapter_meta[N].hook（实际实现的钩子），生成“接住上章”指导
- 钩子类型参考：悬念钩 | 危机钩 | 承诺钩 | 情绪钩 | 选择钩 | 渴望钩
Save after each batch:
cat >> "$PROJECT_ROOT/大纲/第${volume_id}卷-详细大纲.md" << 'EOF'
{batch_content}
EOF
7) Enrich existing setting files from volume outline
目标：卷纲写完后，把本卷新增事实写回“现有设定集文件”，确保后续写作可直接读取。
输入来源：
大纲/第{volume_id}卷-节拍表.md大纲/第{volume_id}卷-详细大纲.md- 现有设定集文件（世界观/力量体系/主角卡/主角组/女主卡/反派设计）
写回策略（必须）：
- 仅增量补充相关段落，不覆盖整文件。
- 新增角色：写入对应角色卡或角色组条目（含首次出场章、关系、红线）。
- 新增势力/地点/规则：写入世界观或力量体系对应章节。
- 新增反派层级信息：写入反派设计并保持小/中/大层级一致。
- 典故引用回写（若
典故引用库.md 存在）：将卷骨架“引用规划”段的条目增量写入引用库的“第N卷引用规划总表”。若章纲中有“引用锚点”引用了引用库中未登记的新引用，追加到对应分类。同时将承载伏笔的引用条目登记到 伏笔追踪.md 的“典故伏笔”分类。
冲突处理（硬规则）：
- 若卷纲新增信息与总纲或已确认设定冲突，标记
BLOCKER 并停止 state 更新。
- 只有冲突裁决完成后，才允许继续更新设定并进入保存步骤。
8) Validate + save
Validation checks (must pass all)
1. 爽点密度检查
- 每章 ≥1 小爽点（强度 2-3）
- 每 5-8 章至少 1 个关键章节（强度 4-5）
- 每卷至少 1 个高潮章节（强度 6-7）
2. Strand 比例检查
Count chapters by Strand and compare with genre profile:
- Quest: 应占 55-65%
- Fire: 应占 20-30%
- Constellation: 应占 10-20%
If deviation > 15%, adjust chapter assignments.
3. 总纲一致性检查
- 卷核心冲突是否贯穿章节？
- 卷末高潮是否在最后 3-5 章体现？
- 关键人物是否按计划登场？
4. 约束触发频率检查 (if idea_bank exists)
- 反套路规则触发次数 ≥ 总章数 / N（N = max(5, 总章数/10)）
- 硬约束在至少 50% 章节中体现
- 主角缺陷至少 2 次成为冲突来源
- 反派镜像在反派出场章节中体现
5. 完整性检查
Every chapter must have:
- 目标（20 字以内）
- 阻力（20 字以内）
- 代价（20 字以内）
- 时间锚点（必填）
- 章内时间跨度（必填）
- 与上章时间差（必填）
- 倒计时状态（若有倒计时事件则必填）
- 爽点（类型 + 30 字描述）
- Strand（Quest/Fire/Constellation）
- 反派层级（无/小/中/大）
- 视角/主角
- 关键实体（至少 1 个）
- 本章变化（30 字以内）
- 章末未闭合问题（30 字以内）
- 钩子（类型 + 30 字描述 + 强度）
- 读者情绪
- 氛围/情绪色调
- 场景预案（至少 1 个）
6. 时间线一致性检查（新增）
- 时间线表文件存在：
大纲/第{volume_id}卷-时间线.md
- 所有章节时间锚点已填写
- 时间单调递增（不得回跳，除非明确标注为闪回）
- 倒计时推进正确（D-5 → D-4 → D-3，不得跳跃）
- 大跨度时间跳跃（>3天）必须有过渡章说明或明确标注
7. 读者情绪连续性检查（新增）
- 连续 3 章以上相同“读者情绪”值 = 预警（读者疲劳风险）
- 高压章节（压抑/紧张/焦虑）后 2 章内必须出现释放/温暖/燃
- 卷末 3 章必须有至少 1 个“燃”或“震撼”
- 卷首章必须是“好奇”或“震撼”（抓住新读者）
8. 钩子强度与丰满度检查（新增）
- 钩子强度交替规则：“1强2缓”交替（不要每章都 strong，会疲劳）
- 卷末 3 章连续 strong 钩子
- 卷首章 strong 钩子
- 每章场景预案至少 1 个
- 关键章节（高潮/转折）必须有视觉锚点
- 每 5 章至少有 1 个对话种子
9. 爽值预估检查（新增）
- 关键章节（爽点强度 4-5）预估爽值应 > 50
- 高潮章节（爽点强度 6-7）预估爽值应 > 70
- 爽值 = 压抑强度(0-10) × 反转速度(0-10) / max(1, 11-逻辑完整度(0-10))
10. 设定补全检查
- 本卷涉及的新角色/势力/规则已回写到现有设定集文件
- 所有新增条目可回溯到本卷章纲章节
BLOCKER 数量为 0；若 >0，必须先裁决，不得进入 state 更新
Update state (include chapters range):
python "${SCRIPTS_DIR}/webnovel.py" --project-root "$PROJECT_ROOT" update-state -- \
--volume-planned {volume_id} \
--chapters-range "{start}-{end}"
Final check:
- 节拍表文件已写入：
大纲/第{volume_id}卷-节拍表.md
- 时间线表文件已写入：
大纲/第{volume_id}卷-时间线.md
- 章纲文件已写入：
大纲/第{volume_id}卷-详细大纲.md
- 设定集已完成基线补齐与本卷增量补充（原文件内可见）
- 每章包含：目标/阻力/代价/时间锚点/章内时间跨度/与上章时间差/爽点/Strand/反派层级/视角/关键实体/本章变化/章末未闭合问题/钩子
- 时间线单调递增，倒计时推进正确
- 与总纲冲突/高潮一致，约束触发频率合理（如有 idea_bank）
Hard fail conditions (must stop)
- 节拍表文件不存在或为空
- 节拍表中段反转缺失（未按“必填/无（理由）”规则填写）
- 时间线表文件不存在或为空
- 章纲文件不存在或为空
- 任一章节缺少：目标/阻力/代价/时间锚点/章内时间跨度/与上章时间差/爽点/Strand/反派层级/视角/关键实体/本章变化/章末未闭合问题/钩子
- 任一章节时间字段（时间锚点/章内时间跨度/与上章时间差）缺失
- 时间回跳且未标注为闪回
- 倒计时算术冲突（如 D-5 直接跳到 D-2）
- 重大事件发生时间与前章间隔不足且无合理解释（如末世第1天建帮派）
- 与总纲核心冲突或卷末高潮明显冲突
- 设定集基线未补齐，或本卷增量未回写到现有设定集
- 存在
BLOCKER 未裁决
- 约束触发频率不足（当 idea_bank 启用时）
Rollback / recovery
If any hard fail triggers:
- Stop and list the failing items.
- Re-generate only the failed batch (do not overwrite the whole file).
- If the last batch is invalid, remove that batch and rewrite it.
- Only update state after Final check passes.
Next steps:
- 继续规划下一卷 → /webnovel-plan
- 开始写作 → /webnovel-write
