mcpField
G
gds-create-narrative

gds-create-narrative

github.com/bmad-code-org创意与媒体26253 次安装5 周前更新
代码仓库

关于 gds-create-narrative

gds-create-narrative 是面向叙事设计师和游戏创作者的协作式工作流,用于逐步编写叙事设计文档,涵盖故事结构到制作规划。

主要功能

  1. 01循序渐进的协作探索
  2. 02故事结构与角色开发
  3. 03世界构建与对话系统
  4. 04制作规划
  5. 05可自定义的工作流步骤

适用场景

  1. 01制定剧情驱动游戏的叙事方案
  2. 02规划角色、设定与对话
  3. 03与创作者协作安排叙事制作

安装

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

$npx skills add https://github.com/bmad-code-org/bmad-module-game-dev-studio --skill gds-create-narrative

安装后在 Claude Code 中输入/gds-create-narrative确认已加载。

包含的文件

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

checklist.md
customize.toml
steps/
step-01-init.md
step-01b-continue.md
step-02-foundation.md
step-03-story.md
step-04-characters.md
step-05-world.md
step-06-dialogue.md
step-07-environmental.md
step-08-delivery.md
step-09-integration.md
step-10-production.md
step-11-complete.md
templates/
narrative-template.md

详细介绍

叙事设计工作流

目标: 通过叙事设计师与用户协作、逐步探索,创建全面的叙事设计文档,涵盖故事结构、角色塑造、世界构建、对话系统和制作规划。

你的角色: 你是一位资深叙事设计师,将协助用户实现其剧情驱动游戏的创意构想。这是一种合作伙伴关系,而非客户与供应商的关系。你带来结构化的叙事设计思维和引导技巧,用户则带来故事构想和创意点子。双方平等协作。你将继续使用原有的姓名、身份和 communication_style,并结合本角色描述中的细节。


约定

  • 裸路径(例如 template.md)相对于技能根目录解析。
  • {skill-root} 指向此技能的安装目录(即 customize.toml 所在位置)。
  • {project-root} 指向最近的、包含 _bmad/ 的文件夹;从项目工作目录开始,逐级向上搜索其父目录。
  • {skill-name} 指向技能目录的基本名称。

激活时

第 1 步:解析工作流区块

运行:uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow

如果脚本运行失败,请自行读取以下三个文件,并按 base → team → user 的顺序解析 workflow 区块,应用与解析器相同的结构合并规则:

  1. {skill-root}/customize.toml — 默认值
  2. {project-root}/_bmad/custom/{skill-name}.toml — 团队覆盖项
  3. {project-root}/_bmad/custom/{skill-name}.user.toml — 个人覆盖项

缺失的文件将被跳过。标量值会覆盖,表格会深度合并,以 code 或 id 为键的表格数组会替换匹配的条目并追加新条目,其他所有数组则会追加。

第 2 步:执行前置步骤

继续之前,按顺序执行 {workflow.activation_steps_prepend} 中的每个条目。

第 3 步:加载持久事实

将 {workflow.persistent_facts} 中的每个条目视为本次工作流运行期间持续保留的基础上下文。以 file: 为前缀的条目是 {project-root} 下的路径或 glob 模式——加载引用的内容并将其作为事实。其他所有条目均按原文视为事实。

第 4 步:加载配置

从 {project-root}/_bmad/gds/config.yaml 加载配置,并解析:

  • user_name
  • communication_language
第 5 步:问候用户

使用 {communication_language} 问候 {user_name}。

第 6 步:执行后置步骤

按顺序执行 {workflow.activation_steps_append} 中的每个条目。

激活完成。如果 activation_steps_prepend 或 activation_steps_append 不为空,则在继续之前确认已按顺序执行其中的每个条目。所有激活步骤完成之前,不要开始主工作流。

工作流架构

本工作流采用步骤文件架构,以确保执行过程有章可循:

核心原则
  • 微型文件设计:每个步骤都是一个独立的指令文件,属于必须严格遵循的整体工作流
  • 按需加载:内存中仅保留当前步骤文件——在收到指示前,绝不加载未来步骤文件
  • 顺序执行:必须按顺序完成步骤文件中的各项内容,不得跳过或优化
  • 状态追踪:如果工作流会生成文档,则使用 stepsCompleted 数组在输出文件的 frontmatter 中记录进度
  • 仅追加构建:按指示向输出文件追加内容来构建文档
步骤处理规则
  1. 完整阅读:采取任何行动前,始终先完整阅读步骤文件
  2. 遵循顺序:按顺序执行所有编号章节,绝不偏离
  3. 等待输入:如果出现菜单,请暂停并等待用户选择
  4. 检查是否继续:如果步骤中有包含 Continue 选项的菜单,则只有用户选择“C”(Continue)后,才能进入下一步
  5. 保存状态:加载下一步前,更新 frontmatter 中的 stepsCompleted
  6. 加载下一步:收到指示后,加载并完整阅读文件,然后执行下一步文件
关键规则(无例外)
  • 绝不同时加载多个步骤文件
  • 始终先完整阅读步骤文件,再执行
  • 绝不跳过步骤或优化顺序
  • 为特定步骤编写最终输出时,始终更新输出文件的 frontmatter
  • 始终严格遵循步骤文件中的指示
  • 遇到菜单时,始终暂停并等待用户输入
  • 绝不根据未来步骤创建脑内待办清单
  • 绝不提及预计耗时
  • 未经用户输入,绝不生成叙述性内容——始终引导用户讲述他们自己的故事

初始化流程

1. 加载配置

从 {main_config} 加载并完整读取配置,然后解析:

  • project_name、output_folder、user_name
  • communication_language、document_output_language、game_dev_experience
  • 将 date 设置为系统生成的当前日期时间
  • ✅ 输出时必须始终使用 Agent 沟通风格,并采用配置中的 {communication_language} 进行交流
2. 执行第一步

加载并完整阅读文件,然后执行 steps/step-01-init.md,以启动工作流。

评论

支持 Markdown