gds-quick-dev

Quick Dev New Preview 工作流

目标： 将用户意图转化为经过强化、可供审查的产物。

关键： 如果某个步骤要求“完整阅读并遵循 step-XX”，就必须完整阅读并遵循 step-XX。没有例外。

约定

• 裸路径（例如 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
• implementation_artifacts

步骤 5：问候用户

用 {communication_language} 问候 {user_name}。

步骤 6：执行后置步骤

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

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

开发就绪标准

当规格说明满足以下条件时，即为“开发就绪”：

• 可执行：每项任务都有文件路径和具体操作。
• 逻辑清晰：任务按依赖关系排序。
• 可测试：所有 AC 均使用 Given/When/Then 格式。
• 完整：没有占位符或 TBD。

范围标准

规格说明应聚焦于 单个面向用户的目标，长度为 900–1600 个 token：

• 单个目标：一个连贯的功能，即使它涉及多个层或文件。多目标是指包含至少 2 个 顶层、彼此独立、可交付的成果 — 每个成果都可以作为单独的 PR 进行审查、测试和合并，且不会破坏其他成果。绝不能根据表面动词、“and”连接词或名词短语来计数。绝不能拆分同一用户目标中的跨层实现细节。
  • 应拆分：“添加深色模式切换开关 AND 将身份验证重构为 JWT AND 构建管理后台”
  • 不应拆分：“添加验证并显示错误”／“支持拖放、粘贴和重试”
• 900–1600 个 token：这是便于大模型处理的最佳范围。少于 900 个 token 可能导致含糊；超过 1600 个 token 则可能使实现 Agent 的上下文逐渐失效。
• 两个限制都不是门槛。 两者都是建议，用户可以覆盖。

工作流架构

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

• 微型文件设计：每个步骤自成一体，并须严格遵循
• 即时加载：仅加载当前步骤文件
• 顺序执行：按顺序完成步骤，不得跳过
• 状态跟踪：通过规格说明的 frontmatter 和内存变量保存进度
• 仅追加构建：逐步构建产物

步骤处理规则

1. 完整阅读：执行前先阅读整个步骤文件
2. 遵循顺序：按顺序执行各部分
3. 等待输入：在检查点暂停并等待人工输入
4. 加载下一步：收到指示后，完整阅读并遵循下一个步骤文件

关键规则（无一例外）

• 绝不同时加载多个步骤文件
• 始终在执行前完整阅读步骤文件
• 绝不跳过步骤或优化顺序
• 始终严格遵循步骤文件中的指示
• 始终在检查点暂停并等待人工输入

初始化流程

1. 加载配置

加载并完整阅读 {main_config} 中的配置，并确定以下内容：

• project_name、planning_artifacts、implementation_artifacts、user_name
• communication_language、document_output_language、game_dev_experience
• date 为系统生成的当前日期和时间
• sprint_status = {implementation_artifacts}/sprint-status.yaml
• project_context = **/project-context.md（若存在则加载）
• CLAUDE.md / 记忆文件（若存在则加载）

你必须始终使用 Agent 沟通风格，并以配置中的 {communication_language} 输出。

2. 执行第一步

完整阅读并遵循：./step-01-clarify-and-route.md，以启动工作流。