outline

name	outline
description	设计章节结构，标注 Rise/Plateau，写作技巧选用，大纲自动校验

Stage 03: 大纲

固定上下文（启动前必读）

• {profile_dir}/style-library.md — 参考句式和节奏
• {skill_dir}/rules/article-templates.md — 文章结构模板
• {project_dir}/00-brief.md — 选题 + 核心判断
• {project_dir}/01-research/ — 全部研究素材

---

章节结构设计

基于核心判断 + 研究素材设计章节结构。

结构参考（工具类，难度曲线）： 场景代入 → 卖点/核心判断 → 快速上手 → 深入使用（原理穿插） → Takeaway

禁止：原理单独成章放在实操前面。每个大章节开头必须有场景句或动机句。

H2 排列顺序（黄金圈，必须遵守）：

H2 按 Why→What→How 排列：

• Why（1-2 个 H2）：为什么需要，动机/痛点
• What（1 个 H2）：是什么，概念定义
• How（主体 H2）：怎么做，实操配置
• CTA/Takeaway（1 个 H2）：收尾

H3 层级（必须有）：

每个 H2 下至少 2 个 H3（CTA/结尾类除外）。大纲示例：

## CLAUDE.md 为什么管不住 Claude（Why）
### 他可以选择不听
### 上下文一长，规则就漏

## Harness 是什么（What）
### 系统层约束 vs 模型层建议
### 一个类比：便利贴 vs 撤权限

## 先装这三个（How）
### 任务完成通知
### 自动格式化
### 保护敏感文件

每章标注：核心观点 + 素材来源 + 预期字数。

---

Rise/Plateau 标注（必做）

每个章节额外标注类型和难度，确保 flow channel 内的渐进上升：

• Rise = 引入新概念/新技术，读者需要动脑理解的内容
• Plateau = 巩固当前难度，用场景/例子/截图/类比让读者"过关"
• 判断方法：这一节如果跳过，后面还能看懂吗？能 → Plateau；不能 → Rise

整体结构对应：

场景   → Plateau（零门槛，读者代入）
卖点   → Rise（引入核心判断）
试用   → Rise + Plateau 交替（配置是Rise，效果/场景是Plateau，循环）
CTA    → Plateau（收尾，难度回落）

难度曲线示意：

难度
 5 |                                          ╭─ 进阶(R)
   |                                    ╭─(P)─╯
 4 |                              ╭─(R)─╯
   |                        ╭─(P)─╯
 3 |                  ╭─(R)─╯
   |            ╭─(P)─╯
 2 |      ╭─(R)─╯
   | ╭(P)─╯
 1 |─╯
   └──────────────────────────────────────────→ 文章位置
     场景    卖点    试用（交替区）         CTA

两条硬规则：

1. 不能连续两个 Rise，每个 Rise 后面必须跟至少一个 Plateau
2. Rise 的难度单调递增（后面的 ≥ 前面的）

Plateau 工具箱（每个 Plateau 至少用一种）：

• 场景故事：引入新概念后，用真实情境巩固
• 可抄代码/配置：实操类 Rise 之后，读者立刻能动手
• 效果截图：配置完/跑完后，读者看到"成功了"
• 类比：抽象概念后，用读者已懂的东西映射
• 对比（前 vs 后）：卖点 Rise 之后，让读者直观感受差异
• 自检/验证步骤：操作类 Rise 之后，读者确认自己做对了

示例标注（以"Claude Code 写 CLI 工具"为例）：

## 开头：你是不是也手动跑过 10 遍同样的命令
- 类型: Plateau（场景代入）/ 难度: 1/5
- 手段: 日常痛点，读者觉得"这说的是我"

## 卖点：一行命令搞定重复操作
- 类型: Rise（引入核心判断）/ 难度: 1.5/5
- 配套 Plateau: 前 vs 后对比，5步手动 vs 1行命令

## 最小可用：3 行配置跑起来
- 类型: Rise（第一次接触配置语法）/ 难度: 2/5
- 配套 Plateau: 完整可抄代码 + "跑完你会看到这个输出"

## 原理：他怎么把你的描述变成代码的
- 类型: Rise（讲机制）/ 难度: 3.5/5（此时读者已有实操经验）
- 配套 Plateau: 类比（"就像跟同事说需求，他写完给你 review"）

## 进阶：错误处理 + 边界情况
- 类型: Rise（最高难度）/ 难度: 4/5
- 配套 Plateau: 我踩过的 3 个坑 + 解法

---

写作技巧工具箱（大纲标注阶段选用）

以下技巧在大纲时标注使用位置，写手阶段执行：

• 升番逻辑：文章涉及多个工具/功能/案例对比时必用。逐个展示，每个带一句吐槽/点评，按冲击力从弱到强排列——基础功能→进阶用法→"卧槽还能这样"。最弱放前面，最炸留最后。不一次性罗列结论。详见 {skill_dir}/stages/04-write/techniques/escalation.md。
• 契诃夫之枪（回环呼应）：开头/中间埋的钩子（意象/问题/场景），结尾必须 callback 回来。大纲时标注：「钩子位置」→「callback 位置」。让文章从信息流变成作品。详见 {skill_dir}/stages/04-write/techniques/chekhovs-gun.md。
• 人物画像法：涉及用户数量/市场现象时，用 3-5 句话从数据点构建一个具体的人：触发数据→快速代入→多维堆砌（城市/职位/心理/行为）→情感锚定→细节具象化。替代空泛的"很多用户"。详见 {skill_dir}/stages/04-write/techniques/persona-method.md。

---

大纲自动校验（确认前必做）

用户看大纲之前，先自动检查以下四项，不通过就修正后再展示：

1. Why→What→How 顺序：前 1-2 个 H2 必须是 Why（动机/痛点），中间是 What（概念），后面是 How（实操）。顺序不对直接调整。
2. 难度曲线：检查有无连续两个 Rise，有则在中间插入 Plateau。
3. 配图规划：每个 H2 标注是否需要截图/配图（截图/架构图/流程图/无），大纲里直接标，不要等写完再想。
4. 写作技巧标注：是否有多产品/功能对比 section → 标注「升番逻辑」；是否有开头钩子 → 标注「契诃夫之枪 callback: 结尾」；是否涉及用户数据/市场现象 → 标注「人物画像法」。

等用户确认后继续。