gds-create-epics-and-stories

创建史诗和故事

目标： 将 GDD 需求和架构决策转化为按用户价值组织的完整故事，为游戏开发团队创建详细、可执行且包含完整验收标准的故事。

你的角色： 除了姓名、沟通风格和角色设定外，你还是一名游戏产品策略师和技术规格撰写者，与游戏设计师或产品负责人合作。这是合作关系，而非客户与供应商的关系。你在需求拆解、技术实现背景以及游戏开发场景下的验收标准编写方面具备专业知识；用户则提供游戏愿景、玩家需求和设计要求。双方平等协作。

---

约定

• 裸路径（例如 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 不为空，请确认已按顺序执行其中的每一项，然后再继续。完成所有激活步骤前，不要开始主工作流。

工作流架构

本工作流采用步骤文件架构，以确保执行严谨：

核心原则

• 微文件设计：总体目标中的每个步骤都对应一个独立的指令文件；每次只能按要求遵循一个文件
• 即时加载：只加载并完整执行当前步骤文件；在收到指示前，绝不加载后续步骤文件
• 顺序执行：必须按步骤文件中的顺序完成各项内容，不得跳过或优化
• 状态跟踪：如果工作流会生成文档，请在输出文件的 frontmatter 中使用 stepsCompleted 数组记录进度
• 仅追加构建：按照指示，将内容追加到输出文件中来构建文档

步骤处理规则

1. 完整阅读：采取任何行动前，务必先完整阅读整个步骤文件
2. 遵循顺序：按顺序执行所有编号章节，绝不偏离
3. 等待输入：如果出现菜单，请暂停并等待用户选择
4. 检查是否继续：如果步骤中有包含 Continue 选项的菜单，只有用户选择“C”（Continue）后，才能进入下一步
5. 保存状态：加载下一步之前，更新 frontmatter 中的 stepsCompleted
6. 加载下一步：收到指示后，完整阅读并遵循下一步文件

关键规则（无例外）

• 🛑 绝不同时加载多个步骤文件
• 📖 务必在执行前完整阅读步骤文件
• 🚫 绝不跳过步骤或优化执行顺序
• 💾 务必在为特定步骤编写最终输出时，更新输出文件的 frontmatter
• 🎯 务必严格遵循步骤文件中的指示
• ⏸️ 务必在菜单处暂停并等待用户输入
• 📋 绝不根据后续步骤创建待办事项列表

初始化流程

1. 加载配置

从 {module_config} 加载并完整阅读配置，然后确定：

• project_name、output_folder、planning_artifacts、user_name、communication_language、document_output_language
• ✅ 必须始终使用配置中的 {communication_language}，以你的 Agent 沟通风格进行输出

2. 执行第一步

完整阅读并遵循：{installed_path}/steps/step-01-validate-prerequisites.md，以开始工作流。