plan

plan is a command for Claude Code from wordflowlab/novel-writer-skills. It costs 8 tokens per session (4,100 once invoked), scanned A, original, MIT.

A command that turns a story specification into a technical writing plan, including structure, pacing, and chapter details.

In plain words
What is it for?
Use it to create a creative plan for a story. It can apply structures such as the three-act structure, the hero’s journey, a seven-point structure, or a character-focused story circle.
Why use it?
It gathers the project’s rules and clarifications first, so the writing plan reflects the intended story and any available pacing guidance.

Command for Claude Code

Written for Claude Code: allowed-tools in frontmatter. Also seen: model in frontmatter.

Good fit Use it to create a creative plan for a story. It can apply structures such as the three-act structure, the hero’s journey, a seven-point structure, or a character-focused story circle.

Compare 6 commands from other repositories ↓
Install with agentmods
npx agentmods add commands/wordflowlab/novel-writer-skills/plan
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/wordflowlab/novel-writer-skills

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for plan

README.md
[![agentmods](https://agentmods.dev/badge/commands/wordflowlab/novel-writer-skills/plan/github.svg)](https://agentmods.dev/commands/wordflowlab/novel-writer-skills/plan)
Your own site
<a href="https://agentmods.dev/commands/wordflowlab/novel-writer-skills/plan"><img src="https://agentmods.dev/badge/commands/wordflowlab/novel-writer-skills/plan/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for plan

Your own site · 80×15
<a href="https://agentmods.dev/commands/wordflowlab/novel-writer-skills/plan"><img src="https://agentmods.dev/badge/commands/wordflowlab/novel-writer-skills/plan.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 8 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 4,100 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00008 $0.04100
Opus 5 $0.00004 $0.02050
Sonnet 5 $0.00002 $0.00820
Haiku 4.5 $0.00001 $0.00410

Measured 11d ago against content hash 1cf2a2795a58, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

plan scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

templates/commands/plan.md · 409 lines

How it starts

The opening of the file, as written. The whole thing — 409 lines — stays where its author put it; the contents beside it link to each section on GitHub.

用户输入:$ARGUMENTS

目标

将"要创造什么"(规格)转化为"如何创造"(计划)。这是从需求到实现的关键转换。

执行步骤

1. 加载前置文档

运行 {SCRIPT} 检查并加载:

  • 宪法文件:memory/constitution.md
  • 规格文件:stories/*/specification.md
  • 澄清记录(如果已运行 /clarify

🆕 条件加载:黄金开篇法则

判断条件

  1. 检查 specification.md 中的"目标字数"或"总章数"
  2. 检查当前是否在规划开篇阶段
  3. 判断依据:
    • 如果总字数 < 10000字,或
    • 如果规划的章节范围包含第1-3章

如果满足开篇条件,执行以下操作

# 检查是否存在黄金开篇法则文件
test -f spec/presets/golden-opening.md && echo "found" || echo "not-found"
  • 如果存在:读取 spec/presets/golden-opening.md

    • 在规划第1-3章时自动应用五大黄金法则
    • 在后续"章节架构设计"部分特别标注前三章规划
  • ⚠️ 如果不存在:继续正常规划(不影响流程)

🆕 条件加载:节奏配置

如果用户使用了 /book-internalize 命令分析对标作品:

# 检查是否存在节奏配置文件
test -f spec/presets/rhythm-config.json && echo "found" || echo "not-found"
  • 如果存在:读取 spec/presets/rhythm-config.json

    • 应用对标作品的节奏模式(章节字数、爽点间隔等)
    • 应用内容比例建议(对话/动作/描写/心理)
    • 在"2.2 章节架构设计"中引用这些数据
  • ⚠️ 如果不存在:使用默认节奏规划

验证规格澄清状态

  • 如果存在未澄清的关键决策,提示先运行 /clarify
  • 或接受用户明确指示跳过

2. 制定创作计划

创建 stories/*/creative-plan.md,包含以下内容:

2.1 写作方法选择

基于规格分析和故事类型,选择最适合的写作方法:

  • 三幕结构:适合线性叙事、明确起承转合
  • 英雄之旅:适合成长型、冒险类故事
  • 七点结构:适合悬念、反转类故事
  • 故事圈:适合角色驱动、心理深度
  • 混合方法:主线+支线使用不同方法
  • 类型专用结构:如爽文的"爽点分布结构"、悬疑的"线索布局结构"等(参考类型知识库)

记录选择理由和应用方式。

2.2 章节架构设计
## 章节架构

### 总体规划
- 总章数:[基于目标字数和章节长度]
- 章节长度:[基于节奏配置或默认2000-3000字/章]
- 分卷安排:[如适用]

**🆕 节奏参数(如有rhythm-config.json)**:
- 平均章节字数:[从配置读取,如3200字]
- 小高潮间隔:[从配置读取,如5章]
- 大高潮间隔:[从配置读取,如30章]
- 节奏风格:[快/适中/慢]
- 内容比例:对话[X]% / 动作[X]% / 描写[X]% / 心理[X]%

### 🌟 黄金开篇规划(如果包含第1-3章)

**重要**:如果本次规划包含第1-3章,必须特别注意以下要点(基于 golden-opening.md):

#### 第一章规划
- ✅ **法则1-动态场景切入**:
  - 禁止:静止场景、大段环境描写
  - 必须:从冲突/动作/对话直接切入
  - 具体设计:[描述第一章的开场方式]

- ✅ **法则2-核心冲突前置**:
  - 第一章内必须抛出主角核心冲突
  - 具体设计:[描述核心冲突如何呈现]

- ✅ **法则3-避免信息轰炸**:
  - 绝对禁止开篇大篇幅介绍世界观
  - 采用"滴灌式"信息透露
  - 具体设计:[列出第一章透露的信息点]

- ✅ **法则4-限制出场人数**:
  - 有名有姓角色不超过3人
  - 具体设计:[列出第一章出场角色]

#### 第二-三章规划
- ✅ **法则5-快速展现金手指**:
  - 第二或第三章内展现"金手指"作用
  - 具体设计:[描述金手指展现方式]

#### 开篇节奏要求
- 第一章目标:钩住读者,建立期待
- 第二章目标:展现能力,强化钩子
- 第三章目标:初步爽点,确认追读

### 情绪曲线设计 ⭐(构建阅读体验的情绪闭环)

**核心理念**:好的小说不仅是故事的旅程,更是**情绪的旅程**。读者追读的本质是追逐情绪的起伏和满足。

**情绪类型定义**(使用小说术语):

| 情绪类型 | 定义 | 读者体验 | 典型场景 |
|---------|------|---------|---------|
| 😤 **爽点** | 主角获胜、反转、展现实力 | 畅快、解气、期待下一次 | 打脸、逆袭、装逼成功 |
| 😭 **虐点** | 主角失败、压抑、挫折 | 担忧、憋屈、期待翻盘 | 被欺负、失败、失去重要的人 |
| 🤔 **悬念** | 未知、疑问、伏笔 | 好奇、猜测、想继续看 | 出现神秘人物、发现线索、留下谜题 |
| 💧 **平缓** | 日常、过渡、铺垫 | 缓冲、理解、准备情绪 | 日常生活、角色互动、世界观展示 |

**情绪设计原则**:
1. ✅ **欲扬先抑**:爽点前适度铺垫虐点,爽感更强
2. ✅ **张弛有度**:避免连续虐点或连续爽点,保持节奏
3. ✅ **悬念驱动**:每章结尾留悬念,驱动追读欲
4. ✅ **情绪递进**:高潮处的情绪强度要明显高于开篇

**章节段情绪规划**:

| 章节段 | 情绪类型 | 强度 | 目标效果 | 关键场景 |
|--------|---------|------|---------|---------|
| 第1-3章 | 虐→爽→悬念 | 中→高→中 | 开局抑扬,建立追读欲 | [具体描述] |
| 第4-8章 | 平缓→虐→爽 | 低→中→高 | 第一波小高潮 | [具体描述] |
| 第9-15章 | 悬念→虐→爽 | 中→高→高 | 第二波高潮,埋伏笔 | [具体描述] |
| ... | ... | ... | ... | ... |

**情绪强度等级**:
- **低**:情绪波动小,主要是铺垫和过渡
- **中**:情绪有明显起伏,读者有代入感
- **高**:情绪爆发点,读者高度投入
- **极高**:全书顶点,决定性高潮(通常1-3处)

**情绪曲线可视化**(可选,ASCII简图):

情绪强度 极高 | ╱╲ ╱╲ 高 | ╱╲ ╱ ╲ ╱ ╲___ 中 | ╱╲ ╱ ╲ ╱ ╲___ _╱ 低 | __╱ ╲╱ ╲╱ ╲╱ └─────────────────────────────────────> 章节 3 8 15 25 35 45 55


**情绪设计自检清单**:
- [ ] 开篇3章是否有明确的情绪钩子?
- [ ] 是否存在连续5章以上的平缓期?(警告:容易弃读)
- [ ] 虐点之后是否有足够的爽点回报?
- [ ] 每个卷/阶段是否有明确的情绪高潮?
- [ ] 全书最高情绪点是否在后1/3部分?
- [ ] 章节结尾是否留有悬念驱动下一章?

**与节奏配置的关系**:
- 如果存在 `rhythm-config.json`,参考其中的"爽点间隔"参数
- 对标作品的情绪节奏可作为参考,但需根据自己的故事调整
- 不同类型有不同的情绪节奏(爽文:高频爽点;悬疑:高频悬念;虐文:后期高爽)

### 结构映射
[根据选定方法,映射关键节点到具体章节]

### 线索分布规划

**重要**:从specification.md第五章读取线索管理规格,在每个卷/章节段标注活跃线索。

#### 第一卷:[卷名](章节范围)

| 章节段 | 内容 | 关键事件 | **活跃线索** | **交汇点** |
|--------|------|---------|-------------|-----------|
| [X-Y章] | [段落内容] | [关键事件列表] | PL-01⭐⭐⭐、PL-02⭐⭐ | X-001(第X章) |
| [X-Y章] | [段落内容] | [关键事件列表] | PL-01⭐⭐、PL-03⭐⭐⭐ | 无 |

**线索标注说明**:
- PL-XX:线索ID,来自specification.md 5.1节
- ⭐⭐⭐ 主推进:本章节段重点推进此线索,占据主要篇幅
- ⭐⭐ 辅助:正常推进,有一定篇幅
- ⭐ 背景:偶尔提及,保持存在感
- X-XXX:交汇点ID,来自specification.md 5.3节

#### 第二卷:[卷名](章节范围)

[重复上述表格结构]

### 节奏设计
- 开篇钩子:第[X]章
- 第一个高潮:第[X]章
- 中点转折:第[X]章
- 最大危机:第[X]章
- 最终高潮:第[X]章

Read the full file on GitHub · 409 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 11d ago First seen · 409 lines · 8 tokens per session scan A 1cf2a2795a58

Subscribe to this mod's changes

plan is a command published in the GitHub repository wordflowlab/novel-writer-skills (258 stars, last pushed 10mo ago), licensed MIT. It adds 8 tokens to every session and 4,100 once invoked, about $0.0000 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.