Spec Kit 游戏叙事编写预设

什么是 Spec Kit?

Spec Kit 是一个 免费、开源的框架，将结构化的软件开发原则应用于创作工作。相反的，你使用 Spec Kit 进行预设驱动：在一开始就定义规则，将这些规则应用于 AI，持续验证。

这个预设的作用是什么？

我为 Spec Kit 创建了一个 游戏叙事编写预设，它将这种严格性的应用于分叉叙事设计。如果你曾经：

  • 编写一个分叉叙事，后来突然意识到两个分叉应该收敛但没有这样做
  • 花费了几个小时来追踪“NPC X 什么时候了解 Y”（但没有）
  • 创建了一个选择使得玩家感觉毫无意义（选择权力，但没有后果）
  • 构建了一个Quest树如此复杂以至于你无法回忆起哪些是可到达的
  • 手动测试每个分叉组合，以测试所有潜在的结局
  • 尝试将输出导出到多个引擎（SugarCube、Ink、Ren'py）并且遇到了格式碎片
  • Planned for point-and-click adventures

...这个预设就是为你而设计的。

关键功能

1. 全面的叙事流水线（36 个 AI 命令）
- 指定 → 计划 → 详细规划 → 实现 → 验证 → 编译
- AI 根据你的说明来编写文本，而不是从头开始
- 在质量控制方面设定门槛（例如，不会自动生成一个未经批准的节点）

2. 宪法管治
- 一个单一的 constitution.md文件 = 一切真相
- 引擎目标（SugarCube、Ink、Ren'py）、角度模式、机制hook、工艺规则
- 每个节都从它读取 - 在 200 节项目中没有一致性问题

3. 13 个叙事质量检查
运行以下自动检查：
- 玩家行为 — 检查非真实的选择（选择看起来很有意义，但实际上没有分叉）
- 结局质量 — 所有结局都解决了中心问题
- 对话分叉 — 可选择都有不同的后果
- 信息不当 — 玩家得到他们需要的信息以做出明智的决定
- 状态映射 — 没有死路的变量组合
- 节奏 — 没有堆积信息，无节奏的冲击波
- 可访问性 — 读取水平、内容警告、WCAG对比度
- 预兆/回报 — 在预兆之前种下的钥匙
- 副剧情 — 开端、发展、展开的线路
- 连贯性 — 可分叉的连贯性检查
- 复杂性 — 分叉爆炸的警告
- 可再玩 — 测量每场游玩内容的可玩性
- 秘密 — 隐藏的内容可被发现

4. 多方POV支持
- 单一人物、双重并行、旋转POV、团体演员
- 每个POV对信任状态进行跟踪（例如，“insider_trusts_hacker”：0-100）
- 信息非对称性映射（“每个角色知道什麼时候？”）

5. 对话分叉辅助信任状态

守卫： “您在这里干什么？”

[如果 player_charisma > 50]
“我们可以解决吗？” → [成功] 守卫变成盟友 / [失败] 守卫命令军队来干预

[如果 player_courage > 60]
 “远离点。” → [成功] 守卫撤退 / [失败] 战斗开始

[如果 player_deception > 50]
 “我得到授权进行维护。” → [成功] 通关 / [失败] 捕获

由玩家统计成功/失败。这其中有信任状态改变守卫对话。

6. 11个机制钩子（可扩展）
标签、计数器、访问过、库存、计时器、信任、钱币、npc_state、结束条件、选择记忆、线索。

7. 多引擎编译
- 在共享格式下编写一次
- 编译到SugarCube 2.x（Twine）、Ink（Unity/Unreal/Godot）、通用Markdown
- 自动机制钩子翻译（没有手动的 <＆lt＆;set＆gt＆gt; 重命名）
- 主题应用（SugarCube的暗光轻量级CSS、Ink的HTML包装）

8. 系列圣经支持
- 游戏1的结局→游戏2的开始状态
- 传递变量（证据安全、npc存活、世界状态）
- 结局canonical表（哪些结局可以玩，哪些会锁定）

9. 24个模板
人物角色、世界建设、对话树、节目详细说明、检查表单、研究日志、关系、时间线、副剧情、线索、对话推动线索、可访问性审计、结局、变量、机制、情节、百科全书等

示例工作流程

``bash

1. 建立您的游戏宪法（引擎目标、POV模式、语气）

speckit.constitution

2. 提出您的游戏设想

speckit.specify “一位黑客发现了他们所信任的特工其实是间谍。”

3. 制作故事结构

speckit.plan

4. 生成节点详细说明（节奏表）

speckit.outline --all

5. 由批准详细说明创编全部节点

speckit.implement --all

6. 运行验证套件

speckit.agency # 检查迷惑性的选择
speckit.endings # 结束品质检查
speckit.consequences # 检查选择分叉
speckit.continuity # 检测跨叉的连贯性
speckit.pacing # 检查拖慢节奏
speckit.accessibility # 阅读水平、警告、WCAG对比度

7. 编译为可玩输出

speckit.compile --all-engines

输出：可玩.story.html

```

为什么这很重要？

对于独创者：
- 调整叙事验证时间60%（自动验证而非手动测试）
- 多引擎支持无需格式重写
- AI帮助编写文本，你焦点在结构和故事上

对于叙事团队：
- 宪法 = 共享规则，无需来回澄清
- 状态框架显示了节点完成、分叉覆盖、变量声明的状态
- 验证门槛防止糟糕的分叉进入生产流程

对于互动小说编写者：
- 对话树验证（无孤立的分叉，无不可到达的选项）
- 机制钩子支持信任状态
- 玩家行为检查区分“选择”和“装饰”

对于故事原型工作：
- 在对你的游戏进行生产之前，在较早的项目阶段，就可以开发一个可交互的原型以呈现给批评家

该栈

  • 免费及开源 — MIT许可证，托管在GitHub
  • 语言中立 — 支援Markdown、Twee、Ink、Ren'py等，无不支持的引擎
  • AI驱动 — AI编写文本、给出修正建议、进行结构验证
  • Python+CLI — 无须订阅、可离线运行的扩展性工具
  • 真实项目经验 — 为实际的叙事团队

链接

  • GitHub项目： speckit-preset-game-narrative-writing
  • Spec Kit文档： github.com/github/spec-kit
  • 完整README：项目README教程、命令参考、模板查看

同作者其他的预设

这个预设是其中更广泛的系列 Spec Kit的预设用于叙事和创作事业，所有使用相同的原则：预设驱动、AI辅助编写和自动验证。这其中包括了叙事、小说、戏剧的预设。

Spec Kit 小说编写预设（含有音频小说）

同样的理念应用于 小说、短篇小说编写。

特性：
- 宪法管治来规避语气、角度模式、小说特征、
- 30+ AI 命令：详细规划 → 场景概括 → 文本编写 → 修正 → 出版
- 验证门槛检查项为：
- 小说结构 — 三幕时间，转折点定位，高潮的强度
- 人物轮廓 — 主角转变、支线角色预期、高调平衡
- 文体质量 — 句子的多样性，过度依赖动词，连续动词量、过滤词
- 整流性 — 时间轴的连贯性、地点细节、角色知识状态
- 对话真实性 — 每个角色声音的连贯性、孤立分叉的检测
- 情感节奏 — 趋近/降低的紧张程度、得来的救赎、语气转折
- 可访问性 — 阅读水平、内容警告、敏感性检测
- 支持多种输出格式：EPUB、PDF、Markdown（用于代理投递）、Word（用于出版社）
- 系列圣经（多本小说的续集中、推移的剧情线）
- 资料集成（嵌入引证、事实核查）
- 小说结构模板、人物圣经、剧情概要、情节线条、场景总结等

Spec Kit 复杂预设

同样的理念在 戏剧和电视剧的预设。

特性：
- 宪法管治来规避语气、演示结构、分镜数等
- 28+ AI 命令：剧本概述 → 节奏表 → 场景概要 → 对白文本 → 最终剧本
- 验证规则检查项：
- 剧本结构 — 三幕时间、演出场景，演出过渡
- 人物保持真实性 — 轮廓，对白语气，动机明确性
- 对白效率 — 对白细节，展示场景简化，对白语气保持
- 可视叙述 — 维护行动，而非被动使用，动作简略，阻障的清晰性
- 节奏 — 分镜节数、场景长度、切换的时长
- 支持多个输出格式：industry-standard screenplay (.fountain)、PDF、演出剖析表单
- 系列管理：剧情线条（单集的结局 vs 一整季）
- 动用剧本模板、电视剧展开概要、短片展开概要、剧情线条表格

成为参与者

利用了三个预设，你可以全方位地使用 AI 工具来构建一致性的长篇故事、戏剧和叙事游戏。

请告诉我你正在打造什麼样的计划：

  • GitHub 的讨论 — 分享你关于验证优先任务的想法，并投票支持验辨器
  • 早期试用版本 — 在他们发布之时测试这些预设
  • 贡献模板 — 提交自定义的故事结构、人物框架、生产模板