mcpField
S
story-structure

story-structure

github.com/rhavekost创意与媒体20288 次安装今天更新
代码仓库

关于 story-structure

story-structure 面向小说创作者,可在动笔前规划结构,或审查已有稿件中的节拍。它结合按篇幅比例定位的关键节点与情绪指示点,同时检查位置和作用。

主要功能

  1. 01规划 11 个结构节点
  2. 02审查稿件中的节拍位置
  3. 03用 14 个指示点检查情绪作用
  4. 04识别诱发事件混淆与虚假高潮

适用场景

  1. 01动笔前规划小说大纲
  2. 02定位现有稿件中的结构节拍
  3. 03检查节拍是否发挥预期作用

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/rhavekost/author-toolkit --skill story-structure

安装后在 Claude Code 中输入/story-structure确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

assets/
structure-profile-template.md
references/
landmark-beats.md
signposts.md
structure-audit.md
structure-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(两种模式都需要这两个文件)。不要预先加载未运行模式的文件。

工作流

  1. 识别作者正在使用的模式(见上表)。如果不明确,请询问。
  2. 加载 references/landmark-beats.md 和 references/signposts.md,以及已识别模式对应的文件。
  3. 严格按照该模式的参考文件中记录的工作流执行。
  4. 在该模式记录的停止条件处停止(见下文“停止点”)。将结果交还作者。
  5. 如果由此产生了新的或变更后的结构档案,请提供 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 中的提示框
把早期实现目标的场景称为“高潮”检查是否存在伪高潮——主人公与真正目标之间是否还有更大的障碍尚未清除?
在尚无草稿的故事上运行 AuditAudit 需要实际的手稿文本来定位情节点——起草前规划请改用 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 区块

评论

支持 Markdown