关于 story-structure
story-structure 面向小说创作者,可在动笔前规划结构,或审查已有稿件中的节拍。它结合按篇幅比例定位的关键节点与情绪指示点,同时检查位置和作用。
主要功能
- 01规划 11 个结构节点
- 02审查稿件中的节拍位置
- 03用 14 个指示点检查情绪作用
- 04识别诱发事件混淆与虚假高潮
适用场景
- 01动笔前规划小说大纲
- 02定位现有稿件中的结构节拍
- 03检查节拍是否发挥预期作用
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ rhavekost/ author-toolkit --skill story-structure安装后在 Claude Code 中输入/story-structure确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
assets/structure-profile-template.mdreferences/landmark-beats.mdsignposts.mdstructure-audit.mdstructure-map.md详细介绍
故事结构
以百分比为锚点的标志性节拍骨架(K.M. Weiland 的 5 Secrets of Story Structure / Structuring Your Novel),叠加 James Scott Bell 的 14 个路标目录(Super Structure)——并提供两种使用方式:在动笔前规划新故事的结构,以及依据该结构审查现有手稿。
Weiland 的节拍回答转折点应该落在哪里;Bell 的路标回答转折点需要完成什么心理或情感作用。两者结合,便能形成一种位置骨架,并在每个衔接点提供内容诊断,而不只是一条百分比阶梯。
适用场景
此技能适用于:
- ✅ 虚构类手稿——长篇小说、中篇小说、短篇小说
- ✅ 在动笔前将标志性节拍(引发事件、情节点、紧张点、中点、高潮)安排到新大纲中
- ✅ 按大致百分比检查节拍在现有初稿中的实际位置
- ✅ 检查已出现的节拍是否完成了所需的心理作用(通过 Bell 的路标)
- ✅ 发现两个具体且常被忽略的问题:引发事件/关键事件/第一情节点混淆,以及虚假高潮陷阱
不适用场景
此技能不适用于:
- ❌ 场景层面的微观结构(目标/冲突/结果、场景/后续)——请改用
fiction-workshop的references/developmental-editing.md中的场景层级部分。 - ❌ 人物弧线机制(欲望、需求、创伤、谎言)——请改用
fiction-workshop的references/character-work.md中的核心四要素。此技能只会指出谎言在哪个结构节拍中受到考验(第三情节点),又在哪个节拍中得到解决(高潮)。 - ❌ 叙事类非虚构作品结构——请改用
narrative-nonfiction的转变弧指导;此技能的节拍以有情节的虚构冲突为前提。 - ❌ 散文层面的节奏(句子韵律、措辞)——请使用
prose-mechanics。
会话连续性
结构位置应保存在项目的故事圣经中,而不是每次会话都重新推导。
- 会话开始时: 如果存在故事圣经,请检查其中的“Plot Foundation”部分,确认是否已有 Structure Profile 区块(参见
assets/structure-profile-template.md)。除非作者要求重新检查,否则不要对已有该区块的故事重新运行 Map。 - 新增或移动节拍时: 将配置文件区块交还作者,由作者自行粘贴到故事圣经中——此技能不会直接写入故事圣经(请参见各模式下方的停止条件)。
标志性节拍骨架
完整骨架、百分比,以及两种具名问题诊断(引发事件/关键事件/第一情节点混淆、虚假高潮):references/landmark-beats.md。
Bell 的 14 个路标
完整目录按照 Bell 本人的顺序排列,并与上文的标志性节拍交叉参照,标明两者重合之处:references/signposts.md。
两种模式
| 模式 | 调用方式 | 问题 | 参考文件 |
|---|---|---|---|
| Map | “为这个故事规划结构” | 对于尚未完成初稿的故事,各节拍和路标应落在什么位置? | references/structure-map.md |
| Audit | “审查这份手稿的结构” | 节拍实际落在什么位置?每个节拍是否发挥了作用? | references/structure-audit.md |
模式选择指导: Map 用于动笔前规划;Audit 用于任何已经写下的内容。它们不是同一会话中依次进行的阶段——应根据故事当前所处阶段选择相应模式。
只加载与当前调用模式对应的参考文件,以及 landmark-beats.md 和 signposts.md(两种模式都需要这两个文件)。不要预先加载未运行模式的文件。
工作流
- 识别作者正在使用的模式(见上表)。如果不明确,请询问。
- 加载
references/landmark-beats.md和references/signposts.md,以及已识别模式对应的文件。 - 严格按照该模式的参考文件中记录的工作流执行。
- 在该模式记录的停止条件处停止(见下文“停止点”)。将结果交还作者。
- 如果由此产生了新的或变更后的结构档案,请提供
assets/structure-profile-template.md中的代码块,供作者粘贴到其故事圣经的情节基础部分——不要自行写入。
与 fiction-workshop 的集成
fiction-workshop/references/developmental-editing.md的“Act-Level”部分链接到此处,以便查看更深入的、以百分比为锚点的故事骨架和标志点内容检查。fiction-workshop/references/character-work.md的“Arc Milestones”部分链接到此处,并指出第三情节点和高潮是谎言受到考验并得到解决的情节点。assets/structure-profile-template.md旨在直接粘贴到故事圣经现有的“Plot Foundation → Three-Act Structure”部分(见fiction-workshop/assets/story-bible-template.md),在现有的第一幕/中点/第二幕 B 部分/第三幕占位内容上补充更细致的情节点百分比和标志点说明。- 此技能不会重构
fiction-workshop/assets/story-bible-template.md——它只会添加一个可选代码块。
停止点
每种模式都有明确的终点。到达后即停止。不要自动切换到另一种模式,不要默默扩大范围,也不要未经请求就写入故事圣经。
| 模式 | 在何时停止…… | 然后 |
|---|---|---|
| Map | 完成全部 11 个标志点的结构图代码块 | 交还作者确认。不要自动写入故事圣经。 |
| Audit | 提交已标记情节点的报告(缺失/时机不当/薄弱的情节点、伪高潮检查) | 停止。不要自动改写——由作者决定对哪些标记采取行动。 |
发现项格式
审计模式的输出(缺失/错位的标志点、标志点缺漏)
须符合 ../../references/finding-schema.json:audit =
"story-structure-audit",technique = 涉及的具体标志点或标志(例如 "Weiland Midpoint" 或 "Bell Pinch Point 1"),severity,
location(如果没有适用的单行位置,则使用章节级位置——填写该章第 1 行,并在 issue 中描述缺漏),confidence: "judgment",
exemplar 可选。绘制结构图模式(非诊断)不在范围内。
常见错误
| 错误 | 修正方法 |
|---|---|
| 把百分比当作精确页数 | Weiland 本人的表述是:以大致的四分之一位置为目标,而非追求外科手术般的精确度——情节点与标记相差几个百分点也没问题 |
| 把激励事件、关键事件和第一情节点混为一个情节点 | 它们可以是三个不同场景,各自承担不同作用——参见 landmark-beats.md 中的提示框 |
| 把早期实现目标的场景称为“高潮” | 检查是否存在伪高潮——主人公与真正目标之间是否还有更大的障碍尚未清除? |
| 在尚无草稿的故事上运行 Audit | Audit 需要实际的手稿文本来定位情节点——起草前规划请改用 Map |
| 只检查位置,不检查内容 | 情节点即使落在正确的百分比位置,也可能空洞无力——始终同时执行对应的 Bell 标志点内容检查 |
快速参考命令
| 需求 | 命令 |
|---|---|
| 规划新故事的结构 | “为这个故事绘制结构图” |
| 检查现有草稿 | “审计这份手稿的结构” |
| 检查单个情节点的位置 | “中点在这份草稿中的位置在哪里?” |
| 检查特定陷阱 | “检查这份手稿是否存在伪高潮” |
文件
references/landmark-beats.md- 11 个节拍的百分比骨架、诊断信息,以及两个失败模式说明references/signposts.md- Bell 完整的 14 个路标目录,并与各个地标交叉引用references/structure-map.md- 映射模式工作流references/structure-audit.md- 审计模式工作流assets/structure-profile-template.md- 故事结构档案的 Story Bible 区块