fiction-plan：小说规划

基于总纲增量细化卷/时间线/章纲，同步 Story System 底本。 不重做全局故事，不重写整份总纲或设定集。

执行原则

1. 只做增量补全，不重写整份总纲或设定集
2. 先锁定卷级节奏，再批量拆章
3. 时间线是硬约束，所有章纲必须带时间字段
4. 发现总纲与设定冲突时先阻断，等用户裁决

阻断条件

• 项目根不合法或总纲缺失
• 总纲缺少卷名/章节范围/核心冲突/卷末高潮 → 阻断
• 批量拆章时时间回跳且未标注闪回 → 阻断

执行流程

Step 1：加载项目数据

# SCRIPTS_DIR 由安装宿主指向本仓库或已安装的 scripts/ 目录。
export PROJECT_ROOT="$(python -X utf8 "${SCRIPTS_DIR}/fiction.py" --project-root "${CODEX_PROJECT_DIR:-${CLAUDE_PROJECT_DIR:-$PWD}}" where)"

按需读取 .novel/state.json 和 大纲/总纲.md；不要依赖 shell 的 cat 或聊天记忆替代项目文件。题材从 state.json.project.genre 读取，旧项目再兼容 project_info。

按需读取设定集。

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

确认卷名、章节范围、核心冲突，以及是否有特殊要求（视角/感情线/题材偏移）。

Step 3：生成卷节拍表

模板内容：

## 第 X 卷：{卷名}
- 功能：{铺垫/起步/第一个大爽点}
- 核心事件：{一句话}
- 起始状态 → 结束状态
- 中段反转（必须有，确定无则写"无（理由）"）
- 危机链至少 3 次递进
- 卷末新钩子
- 章节定位：推进/高压/训练/关系/呼吸/信息（可多选，但说明主次）

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

Step 4：生成卷时间线

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

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

Step 5：生成详细章纲（每批默认 10 章）

每章必须包含：

每章同时写明目标字数和节点预算；预算总和应落在 [目标字数, 目标字数×1.1]。低压、关系或信息章可以没有显性爽点/反转，但必须保留读者继续阅读的具体理由。

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

Step 6：滚动批次管理

• 第 1 批细纲（至少 5 章）在 fiction-start 前完成
• 默认每 10 章一批
• 写完一批后只在完成报告中提示下一批细纲缺口，不自动开始生成或写正文
• 用户也可主动：(fiction-plan 11-20)

Step 7：同步底本

每批章纲生成后，如项目已初始化 Story System，再同步对应底本；未初始化时报告缺口，不伪造同步成功：

# 底本同步由 AI agent 直接写入 .story-system/ JSON 文件完成

Step 8：写回设定（新增角色/势力）

扫描本次章纲中新出现的具名角色/势力/关键设定：

• 会复用的 → 自动建档到设定集/
• 一次性的路人 → 不建档
• 仅填细纲已确定的信息，未定字段留占位符

输出文件清单

大纲/第{卷号}卷/
├─ 节拍表.md
├─ 时间线.md
└─ 详细大纲.md

与 fiction-write 的关系

fiction-write 执行时自动读取本章细纲，作为写作依据。 如果没有本章细纲 → 阻断，提示先 fiction-plan。

参考

节拍表模板、时间线模板为内置模式。 写作技法类参考在 fiction-write 阶段加载，此处不加载。

致谢

本 skill 的开发参考了以下开源项目的思路与实现：

• lingfengQAQ/webnovel-writer
• worldwonderer/oh-story-claudecode

感谢原作者的开源贡献。