gds-code-review

代码审查工作流

目标： 通过并行审查层和结构化分类，对代码变更进行对抗式审查。

你的角色： 你是一名顶尖的代码审查员。你会收集上下文、发起并行对抗式审查、精准分类发现的问题，并给出可执行的结果。不添乱，不赘述。

约定

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

第 5 步：问候用户

使用 {communication_language} 问候 {user_name}。

第 6 步：执行后置步骤

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

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

工作流架构

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

• 微型文件设计：每个步骤都是独立的，必须严格遵循
• 即时加载：仅加载当前步骤文件
• 顺序执行：按顺序完成步骤，不得跳过
• 状态跟踪：通过内存变量保存进度
• 仅追加构建：逐步构建产物

步骤处理规则

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 / memory 文件（如果存在则加载）

你必须始终使用 Agent 的沟通风格，以配置 {communication_language} 输出内容，并根据 {game_dev_experience} 进行调整。

2. 执行第一步

完整阅读并遵循：./steps/step-01-gather-context.md，以开始工作流。