export WORKSPACE_ROOT="${CLAUDE_PROJECT_DIR:-$PWD}"
export SKILL_ROOT="${CLAUDE_PLUGIN_ROOT}/skills/webnovel-plan"
export SCRIPTS_DIR="${CLAUDE_PLUGIN_ROOT}/scripts"
export PROJECT_ROOT="$(python "${SCRIPTS_DIR}/webnovel.py" --project-root "${WORKSPACE_ROOT}" where)"

python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" placeholder-scan --format text

若本次规划会直接落到具体章节，还必须先刷新 Story System runtime 合同：

# genre 从 state.json 的初始化配置快照读取；写前主链真源是 .story-system 合同树。
# 必须先从详细大纲解析真实 CHAPTER_GOAL，禁止传 {章纲目标} / 第N章章纲目标 这类占位文本。
GENRE="$(python -X utf8 -c "import json,sys; s=json.load(open('${PROJECT_ROOT}/.webnovel/state.json',encoding='utf-8')); print(s.get('project',{}).get('genre',''))")"

python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${WORKSPACE_ROOT}" \
  story-system "${CHAPTER_GOAL}" --genre "${GENRE}" --chapter {chapter_num} --persist --emit-runtime-contracts --format both

生成后必须把 .story-system/MASTER_SETTING.json、.story-system/volumes/、 .story-system/chapters/、.story-system/reviews/ 视为后续写作主链输入。规划开始/结束都运行 placeholder-scan；plan 阶段发现占位先警告并补齐相关文件，进入写章前不得保留当前章相关实体的 [待...] / 暂名 / {占位}。每卷规划完成后，只向 大纲/总纲.md 渐进追加下一卷概要与本卷新增/承接伏笔，不在 init 阶段预填 V2-V20 空表。规划完成后写回必须来自显式结构化文件 大纲/第{volume_id}卷-总纲写回.json，禁止从卷纲自由文本推断伏笔或开放环。

引用加载策略

md 必读

Step	Trigger	Reference
Step 4	always	`templates/output/大纲-卷节拍表.md`
Step 5	always	`templates/output/大纲-卷时间线.md`
Step 6	always	`../../references/genre-profiles.md`
Step 6	always	`../../references/shared/strand-weave-pattern.md`
章纲拆分	always	`../../references/outlining/plot-signal-vs-spoiler.md`

md 按需

Step	Trigger	Reference
Step 6	需要爽点设计	`../../references/shared/cool-points-guide.md`
Step 6/7	需要冲突设计	`references/outlining/conflict-design.md`
Step 7	需要追读力分析	`../../references/reading-power-taxonomy.md`
Step 7	需要章纲细化	`references/outlining/chapter-planning.md`
Step 6/7	特定题材节奏	`references/outlining/genre-volume-pacing.md`

CSV 检索

Step	Trigger	检索命令
卷级规划	always	`python -X utf8 "${SCRIPTS_DIR}/reference_search.py" --skill plan --table 场景写法 --query "卷级结构叙事功能"`
章纲拆分	新增角色出现	`... --skill plan --table 命名规则 --query "角色命名" --genre {题材}`

执行流程

Step 1：加载项目数据并确认前置条件

必须加载：

# 项目配置/投影状态（兼容读取，不作为写后事实真源）
cat "$PROJECT_ROOT/.webnovel/state.json"

# 总纲（全局蓝图）
cat "$PROJECT_ROOT/大纲/总纲.md"

# 题材（来自 init 配置快照，后续 CSV 检索和裁决匹配依赖此值）
GENRE="$(python -X utf8 -c "import json; s=json.load(open('${PROJECT_ROOT}/.webnovel/state.json',encoding='utf-8')); print(s.get('project',{}).get('genre',''))")"

已有卷的剧情状态（跨卷规划时必须加载）：

若已有已完成卷（.webnovel/summaries/ 下有文件），加载以下数据感知已写内容：

# 最近 5 章摘要（了解剧情走向）
for ch in $(seq $((START_CH - 5)) $((START_CH - 1))); do
  cat "$PROJECT_ROOT/.webnovel/summaries/ch$(printf '%04d' $ch).md" 2>/dev/null
done

# 核心角色当前状态
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" \
  knowledge query-entity-state --entity "{protagonist_id}" --at-chapter {上一卷最后章}

# 核心关系当前状态
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" \
  knowledge query-relationships --entity "{protagonist_id}" --at-chapter {上一卷最后章}

# 活跃伏笔（跨卷未回收的伏笔）
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" \
  memory-contract get-open-loops

CSV 创作参考（卷级规划时按需检索）：

python -X utf8 "${SCRIPTS_DIR}/reference_search.py" --skill plan --table 爽点与节奏 --query "{卷级核心冲突}" --genre "${GENRE}"
python -X utf8 "${SCRIPTS_DIR}/reference_search.py" --skill plan --table 桥段套路 --query "{卷级核心冲突}" --genre "${GENRE}"

按需读取（设定集）：

设定集/世界观.md
设定集/力量体系.md
设定集/主角卡.md
设定集/反派设计.md
.webnovel/idea_bank.json

阻断条件：

总纲缺少卷名、章节范围、核心冲突或卷末高潮

Step 2：补齐设定基线

目标：让设定集从骨架模板进入"可规划、可写作"的状态。

必须补齐：

设定集/世界观.md：世界边界、社会结构、关键地点用途
设定集/力量体系.md：境界链、限制、代价与冷却
设定集/主角卡.md：欲望、缺陷、初始资源与限制
设定集/反派设计.md：小/中/大反派层级与镜像关系

硬规则：

只增量补齐，不清空、不重写整文件
发现冲突时先列出冲突并阻断

Step 3：选择目标卷并确认范围

必须确认：

卷名
章节范围
核心冲突
是否存在特殊要求，例如视角、情感线、题材偏移

Step 4：生成卷节拍表

执行前加载模板：

cat "${SKILL_ROOT}/../../templates/output/大纲-卷节拍表.md"

硬要求：

必须填写中段反转；若确实没有，写"无（理由：...）"
危机链至少 3 次递增
卷末新钩子必须能落到最后一章的章末未闭合问题

输出文件：大纲/第{volume_id}卷-节拍表.md

Step 5：生成卷时间线表

执行前加载模板：

cat "${SKILL_ROOT}/../../templates/output/大纲-卷时间线.md"

硬要求：

必须明确时间体系
必须明确本卷时间跨度
有倒计时事件时必须列出并标记 D-N

输出文件：大纲/第{volume_id}卷-时间线.md

Step 6：生成卷纲骨架

必须加载：

cat "${SKILL_ROOT}/../../references/genre-profiles.md"
cat "${SKILL_ROOT}/../../references/shared/strand-weave-pattern.md"

按需加载：

cat "${SKILL_ROOT}/../../references/shared/cool-points-guide.md"
cat "${SKILL_ROOT}/references/outlining/conflict-design.md"
cat "${SKILL_ROOT}/references/outlining/genre-volume-pacing.md"
cat "$PROJECT_ROOT/.webnovel/idea_bank.json"

卷纲必须明确：

卷摘要
关键人物与反派层级
Strand 分布
爽点密度规划
伏笔规划
约束触发规划

跨卷一致性检查（非首卷时必须执行）：

上一卷未回收的伏笔必须出现在新卷的伏笔规划中（继续推进或标记回收）
角色关系变化必须延续（不能当上一卷没发生过）
主角能力/境界必须承接（不能回退也不能跳级，除非有剧情解释）

Step 7：批量生成章纲

批次规则：

默认按 10章/批
复杂题材或多线并进时可降到 8章/批
简单升级流可放宽到 12章/批
不建议单批超过 12章

按需加载：

cat "${SKILL_ROOT}/../../references/reading-power-taxonomy.md"
cat "${SKILL_ROOT}/references/outlining/chapter-planning.md"

每章必须包含：

目标
阻力
代价
时间锚点
章内时间跨度
与上章时间差
倒计时状态
爽点
Strand
反派层级
视角/主角
关键实体
本章变化
章末未闭合问题
钩子
章节起点（CBN）
推进节点（CPNs）
章节终点（CEN）
必须覆盖节点
本章禁区

结构化节点规范

节点格式统一为：

主体 | 动作/变化 | 对象/结果

说明：

这里的节点是写作执行骨架，不追求严格语法学 SVO。
动作/变化 可以表示行动、判断、意识变化或状态转移。
对象/结果 可以是人、物、地点，也可以是结果状态。

示例：

萧炎 | 抵达 | 迦南学院入口
萧炎 | 展示 | 异火控制力
药老 | 对萧炎产生 | 明确兴趣
萧炎 | 意识到 | 学院考核远比预想更严苛

结构规则：

每章固定 1 个 CBN
每章 2-4 个 CPN
每章固定 1 个 CEN
相邻章节 CEN -> 下一章 CBN 必须逻辑承接（首章和末章除外）
CPNs 必须按时间顺序排列

必须覆盖规则：

每章必须覆盖节点最多 4 个
建议为：CBN + CEN + 1~2 个核心 CPN
可选节点只作为写作建议，不得作为 fail 主依据

本章禁区规则：

不超过 5 条
只写本章绝对不能发生的硬禁区
不写风格类建议，不写空泛表述

向后兼容：

若旧项目章纲缺失 CBN/CPNs/CEN/必须覆盖节点/本章禁区 字段，下游流程正常执行，仅跳过结构化检查

输出文件：大纲/第{volume_id}卷-详细大纲.md

Step 8：把新增设定写回现有设定集

输入来源：

卷节拍表
卷时间线表
卷详细大纲
现有设定集文件

写回规则：

只增量补充相关段落
新角色写入角色卡或角色组
新势力、地点、规则写入世界观或力量体系
新反派层级写入反派设计

硬规则：

若发现与总纲或既有设定冲突，标记 BLOCKER 并停止后续更新

Step 9：验证、保存并更新状态

必须通过以下检查：

节拍表存在且非空
时间线表存在且非空
详细大纲存在且非空
每章时间字段齐全
时间线单调递增
倒计时推进正确
新设定已回写到现有设定集
BLOCKER=0
有节点时，相邻章节 CEN -> CBN 无明显逻辑冲突
有节点时，每章必须覆盖节点不超过 4 个

验证全部通过后，生成显式结构化写回文件：

{
  "next_volume_anchor": {
    "volume": 2,
    "volume_name": "下一卷卷名",
    "core_conflict": "下一卷核心冲突",
    "volume_end_climax": "下一卷卷末高潮"
  },
  "foreshadow_writeback": [
    {"content": "本卷规划明确新增的伏笔", "buried_chapter": "第10章", "payoff_chapter": "", "level": "卷级"}
  ],
  "open_loop_writeback": [
    {"content": "本卷结束后仍持续开放的问题", "buried_chapter": "", "payoff_chapter": "", "level": "持续开放环"}
  ]
}

只允许写入规划过程中显式列出的结构化伏笔/开放环；不要把自由文本里的暗示整理进去。随后执行最小总纲写回：

python "${SCRIPTS_DIR}/webnovel.py" --project-root "$PROJECT_ROOT" master-outline-sync \
  --volume {volume_id} \
  --writeback-file "大纲/第{volume_id}卷-总纲写回.json" \
  --format text

该步骤只允许更新 大纲/总纲.md 的 V+1 卷名 / 核心冲突 / 卷末高潮与伏笔表，不得生成下一卷详细大纲、节拍表、时间线或章纲。

更新状态：

python "${SCRIPTS_DIR}/webnovel.py" --project-root "$PROJECT_ROOT" update-state -- \
  --volume-planned {volume_id} \
  --chapters-range "{start}-{end}"

硬失败条件

节拍表不存在或为空
中段反转缺失且未给出理由
时间线表不存在或为空
详细大纲不存在或为空
任一章节缺少时间字段
时间回跳且未标注闪回
倒计时算术冲突
与总纲核心冲突或卷末高潮明显冲突
存在 BLOCKER 未裁决

恢复规则

只重做失败批次，不覆盖整卷文件。
最后一个批次无效时，只删除并重写该批次。
仅在全部验证通过后更新状态。

webnovel-plan

المزيد من هذا المستودع

Outline Planning

目标

执行原则

常见误区

优先级链

决策树入口

环境准备

引用加载策略

md 必读

md 按需

CSV 检索

执行流程

Step 1：加载项目数据并确认前置条件

Step 2：补齐设定基线

Step 3：选择目标卷并确认范围

Step 4：生成卷节拍表

Step 5：生成卷时间线表

Step 6：生成卷纲骨架

Step 7：批量生成章纲

结构化节点规范

Step 8：把新增设定写回现有设定集

Step 9：验证、保存并更新状态

硬失败条件

恢复规则

Outline Planning

目标

执行原则

常见误区

优先级链

决策树入口

环境准备

引用加载策略

md 必读

md 按需

CSV 检索

执行流程

Step 1：加载项目数据并确认前置条件

Step 2：补齐设定基线

Step 3：选择目标卷并确认范围

Step 4：生成卷节拍表

Step 5：生成卷时间线表

Step 6：生成卷纲骨架

Step 7：批量生成章纲

结构化节点规范

Step 8：把新增设定写回现有设定集

Step 9：验证、保存并更新状态

硬失败条件

恢复规则

المزيد من هذا المستودع