narrative-nonfiction

叙事性非虚构作品工作坊

运用叙事元素和隐喻，引导读者实现转变的自助类和指导性非虚构作品工作流。

**核心概念：**读者是主角；书是地图和方法；转变是双方的约定。

会话连续性

图书项目会持续数周或数月。Claude 无法记住不同会话之间的信息，因此项目蓝图文档就是持久状态。

• **会话开始时：**在进行任何其他工作前，先阅读 book-blueprint.md（或项目中蓝图文档的实际名称）。浏览 sessions/ 中近期文件，了解尚未解决的问题。
• **会话结束时：**在 sessions/YYYY-MM-DD_topic-slug.md 写一则简短记录，总结已完成的工作、作出的决定以及停止时的进度。两到五句话即可。
• **基础设定发生变化时：**如果作品承诺、核心隐喻、读者旅程阶段或揭示结构发生变化，请立即更新蓝图。蓝图是权威依据，不是一次性模板。
• **提出尚未解决的问题：**开始新工作时，列出上次会话遗留的问题，并询问用户希望先处理哪些问题，再继续。

适用场景

此技能适用于：

• ✅ 自助类和指导性非虚构作品
• ✅ 带有经验教训或转变历程的回忆录
• ✅ 使用延展隐喻或叙事框架的书籍
• ✅ 包含故事元素的实用指南
• ✅ 读者旅程设计（转变前状态 → 转变后状态）
• ✅ 结构论证型非虚构作品（重新塑造读者对某个系统或类别的理解）

不适用场景

此技能不适用于：

• ❌ 纯虚构作品（小说、短篇故事）——请改用 fiction-workshop
• ❌ 学术写作或研究论文——遵循不同的惯例
• ❌ 纯新闻写作或报道——没有转变历程
• ❌ 不含故事元素的技术文档或操作指南
• ❌ 只关注数据或案例研究、不涉及读者旅程的商业书籍

---

阶段 1：构建基础

**目标：**确立作品承诺、隐喻体系和转变历程。

初始问题

1. 目标读者是谁？（人口统计特征 + 心理特征）
2. 转变承诺是什么？
3. 核心隐喻或框架是什么？
4. 读者的「转变前」和「转变后」状态是什么？
5. 这本书的独特角度是什么？
6. 大纲和初稿分别完成了多少？

核心组成部分

**承诺：**读者能获得什么。「本书将通过[方法]帮助你实现[转变]」

**隐喻：**核心隐喻、隐喻与建议的对应关系，以及隐喻能提供帮助或造成误导的地方

**读者旅程：**起点（读者的初始状态）、痛点、阻力、转变阶段、终点（读者将成为怎样的人）

转折／揭示（如适用）：将揭示什么、需要哪些铺垫，以及如何让最终效果令人信服

如有需要，请使用 assets/book-blueprint-template.md。

**退出条件：**清晰了解读者、承诺、隐喻和历程。

---

阶段 2：章节开发

**目标：**起草或完善章节，平衡建议、故事和练习。

**章节结构：**引子（故事／问题）→ 铺垫（说明重要性）→ 内容（讲解）→ 证据（故事／研究）→ 应用（练习）→ 过渡（引出下一章）

写作模式

模式主要用于第 2 阶段（章节开发）和第 3 阶段（篇章完整性检查）；第 1 阶段是自由发挥的基础构建，无需调用模式。根据需要在这些模式之间切换：

模式	调用方式	重点
声音编辑	“检查声音一致性……”	语气、隐喻契合度、作者人设
内容编辑	“评估……中的教学内容”	清晰度、完整性、准确性
练习设计师	“为……设计练习”	实际应用、难度是否合适
隐喻顾问	“检查隐喻一致性……”	延展隐喻的契合度、避免造成困惑
揭示设计师	“设计揭示……”	伏笔、误导、回报

只加载与当前调用模式对应的参考文件。不要在会话开始时预加载所有参考文件——这会浪费上下文预算。如果在会话中切换模式，请加载新的参考文件，并将之前的参考文件视为不再适用，除非当前工作明确涉及两者。

特别是对于揭示设计师：reveal-engineering.md 是涵盖四种揭示模式（权限重构、实证、结构、概念）的索引。先阅读其中的“选择揭示模式”部分，确定哪种模式适合该项目，然后只加载该模式对应的参考文件。不要预加载全部四种模式。

各模式的详细指南见 references/。

创作工作流

1. 目的检查： 核心收获是什么？在篇章中的什么位置？读者进入下一章前必须相信什么？

2. 列出大纲要点： 开场选项、教学要点（2-4 个）、故事/示例、练习、过渡

3. 起草： 撰写章节。采用“像说话一样写作”的口吻。

4. 融入隐喻： 适度呈现，不要生搬硬套。

5. 添加练习： 使用 references/exercise-design.md

6. 润色： 检查语气、节奏和读者状态

编辑工作流

1. 以目标读者的视角阅读： 是否投入？是否理解？是否相信自己能做到？感到不知所措，还是已经准备好？

2. 诊断： 困惑 → 澄清 | 枯燥 → 添加故事 | 抵触 → 回应异议 | 不知所措 → 简化

3. 调用模式： 加载相关参考文件

4. 实施修改： 使用 str_replace

---

第 3 阶段：篇章完整性检查

目标： 确认整本书作为完整的转变旅程是否成立。

阅读完整大纲/手稿，检查：

1. 承诺兑现： 本书是否兑现承诺？转变是否清晰且可实现？
2. 节奏： 变化的速度是否合适？是否有整合停滞期？能量是否逐步提升？
3. 隐喻： 是否贯穿始终？是否出现断裂或矛盾？结尾处是否仍发挥作用？
4. 揭示（如适用）：反转是否合情合理？是否埋下线索？重新解读是否带来情感冲击？
5. 练习进阶： 练习是否层层递进？难度是否符合阶段？是否足够多样？

常见问题

症状	原因	修复方法
“说教味太重”	故事/示例不足	增加叙述
“太抽象”	缺少具体建议	添加具体做法
“令人不知所措”	每章内容太多	缩小范围，增加章节
“我为什么要在意？”	缺少与痛点的联系	从读者的困境切入
“我做不到”	缺少循序渐进的引导	增加更小的步骤和示例

---

自检：是否正常运行？

使用以下检查点，确认你是否在正确遵循工作流程。

完成基础构建后：

• 你能用一句话说明这本书的承诺吗？
• 你能清楚描述读者「之前」和「之后」的状态吗？
• 你是否理解核心隐喻，以及它如何对应建议？
• 不看笔记，你能概述转变过程的各个阶段吗？

完成一章草稿后：

• 这一章是否包含全部六个要素：钩子、铺垫、内容、证据、应用和衔接？
• 隐喻是否有所体现，但又不显得生硬？
• 叙述风格是否与前几章一致？
• 目标读者能否理解并相信自己可以应用这些内容？

设计完一项练习后：

• 练习难度是否符合读者当前所处的进程阶段？
• 读者能否运用目前已掌握的知识完成练习？
• 练习是否足够具体、可执行（不是「提升工作效率」，而是「连续三天记录自己的时间」）？
• 练习是否建立在之前的练习之上？

调用一种模式后：

• 你是否明确请求了「Voice Editor」「Metaphor Consultant」或指定模式？
• 反馈是否聚焦于该模式负责的领域？
• 你是否避免混杂不同关注点（同时处理叙述风格、内容和练习）？

在宣称「完成」之前：

• 整个转变过程是否兑现了第 1 章中的承诺？
• 隐喻是否贯穿始终保持一致（或经过有意演变）？
• 练习是否从简单到复杂，循序渐进？
• 如果有揭示或反转，前面的章节是否已埋下伏笔？

如果任何检查点的答案是「否」，请返回相应阶段再继续。

---

停止点

每种模式和每个阶段都有明确的终点。到达终点就停下。不要自动进入下一种模式，不要悄悄扩大范围，也不要在对方要求诊断时开始重写。

工具 / 阶段	停止条件	然后
基础构建（阶段 1）	基础构建自检通过	交还给作者。不要自动进入章节开发。
Voice Editor	完成所请求范围的一轮检查并报告发现的问题	等待作者应用修改。除非对方提出要求，否则不要复查其他章节。
Content Editor	提交清晰度、完整性或准确性问题的诊断	停止。不要撰写修复方案——由作者决定。
Exercise Designer	提供 2–3 个练习选项，并分别说明理由	不要替作者选择。未经确认，不要将练习纳入正文。
Metaphor Consultant	生成一致性报告（对应关系、断裂之处、建议）	不要擅自改写隐喻相关内容。报告后停止。
Reveal Engineer	为当前章节提供伏笔计划或铺垫建议	不要根据建议起草章节。这些是输入，而非输出。
情节弧完整性检查（阶段 3）	提交完整情节弧报告（承诺兑现、节奏、隐喻、揭示、练习进展）	交还给作者。由作者决定采纳哪些发现，以及按什么顺序处理。
会话	到达停止点或上下文窗口即将填满	如果基础设定发生变化，则更新蓝图；撰写一份 sessions/ 记录；然后停止。

如果作者明确要求你越过停止点继续操作，可以继续，但要说明接下来将要做什么（「我现在将从诊断转向重写第 4 章的钩子」），让范围变化一目了然。

常见错误

错误	原因	修正方法
跳过基础构建	“我只想开始写作”	如果没有明确的承诺、隐喻和主线，章节就会偏离方向。花 30 分钟制定蓝图，可以省下数小时的重写时间。
生搬硬套隐喻	试图让每句话都符合框架	隐喻应该阐明内容，而不是限制内容。在有助于理解的地方使用，不适用时就跳过。自然胜过生硬。
教学太多，故事太少	想要分享自己掌握的所有知识	读者首先通过故事建立共鸣。目标比例为：40% 的故事／示例、40% 的教学、20% 的应用。根据各章的需要进行调整。
练习与读者的准备程度不匹配	照搬其他书籍的练习形式	练习难度必须与读者在主线中所处的位置相匹配。前面的章节＝简单反思。后面的章节＝更大的挑战。
失去声音的一致性	在学术语气和对话语气之间切换	选定一种声音（自助类书籍通常采用对话语气）并始终保持一致。使用“Voice Editor”模式检查一致性。参见下方示例。
忽视读者的抵触情绪	假设读者认同前提	明确回应反对意见。“你可能会想……”能表明你理解他们的怀疑，并建立信任。
揭示缺少铺垫	计划了反转结尾，却没有埋下伏笔	如果书中有重新解读／揭示，每一章都需要巧妙地埋下伏笔。使用“Reveal Engineer”模式埋下并追踪伏笔。

示例：声音一致性

声音不一致（第 1 章是对话语气，第 4 章是学术语气）：

第 1 章：“你是否有过这样的感觉：度过了‘高效’的一天，却没完成任何重要的事？这是你的大脑在告诉你，有些地方不对劲。”

第 4 章：“实证研究表明，采用时间分块方法的个体在任务完成度和主观生产力方面显著更高（Chen et al.，2019）。”

声音一致（两章都是对话语气）：

第 4 章：“研究结果是这样的：使用时间分块的人能完成更多重要工作。一项研究跟踪了 500 名知识工作者，历时 6 个月，发现采用时间分块的人完成的高优先级项目多了 60%。你的直觉没错。”

**区别：**对话语气会持续使用“你／你的”来称呼读者，采用通俗语言，并将研究结果与读者的体验联系起来。

示例：生硬与自然的隐喻

书籍隐喻：“像建筑师一样思考”

生硬：“早上醒来时，为这一天绘制蓝图。喝下你的地基咖啡。每一刻都是设计人生结构的机会。”

自然：“建筑师会在动工前先规划所需的一切。开始一个项目时，先明确需求——不要只顾着动手，希望最后一切顺利。”

**区别：**自然的隐喻能阐明具体建议。生硬的隐喻则试图把每个细节都硬塞进框架里。

示例：循序渐进地设计练习

前面的章节中的练习（读者刚开始学习概念）：

EXERCISE: Track Your Time
This week, log what you actually do for three full workdays.
Just notice. Don't judge yourself or try to optimize yet.
Write down: Where did your time go? When were you most focused?

后面的章节中的练习（读者已练习过基础内容）：

EXERCISE: Block Your First Deep Work Session
Choose one morning this week (not your busiest day—start manageable).
1. Identify your most important task
2. Block 90 minutes using the protocol from Chapter 3
3. Practice saying it out loud three times before the actual conversation
4. Deliver the boundary
5. Journal: What happened? How did you feel? What would you do differently?

**区别：**前面的练习只需观察，没有压力。后面的练习则建立在已掌握的技能之上，并要求读者采取行动。

---

命令速查

需求	命令
开始新项目	“让我们为 [project] 制定蓝图”
检查声音	“检查 [chapter] 中声音的一致性”
编辑内容	“评估 [chapter] 中的教学内容”
设计练习	“为 [concept] 设计练习”
检查隐喻	“检查 [chapters] 中隐喻的一致性”
为揭示做铺垫	“帮我在 [chapter] 中为 [reveal] 埋下伏笔”
审查主线	“审查 [outline/draft] 中的转变主线”

---

发现格式

此技能的诊断模式（揭示设计中的铺垫与回报缺失、 隐喻一致性检查、读者旅程审查）遵循 ../../references/finding-schema.json：audit = 模式 名称，technique = 具体的写作要素（例如“有铺垫却无回报的揭示”），severity、 location、issue、confidence: "judgment"， exemplar 可选。练习设计和转变弧线脚手架 输出（用于生成，而非诊断）不在范围内。

---

文件

• references/transformation-arc.md - 读者旅程结构
• references/metaphor-consistency.md - 延展隐喻管理
• references/exercise-design.md - 实践应用设计
• references/reveal-engineering.md - 揭示模式索引；详细介绍许可重构模式
• references/empirical-reveal.md - 反直觉数据揭示模式（Freakonomics 风格）
• references/structural-reveal.md - 隐形机制揭示模式（Bastiat 风格）
• references/conceptual-reveal.md - 类别转换揭示模式（Antifragile 风格）
• references/voice-editing.md - 语调与人物设定一致性
• assets/book-blueprint-template.md - 图书规划文档
• assets/chapter-template.md - 章节结构模板