用途:该技能通过引导式工作流创建 project-context.md,集中记录 AI 代理在实现游戏代码时必须遵循的关键规则、模式与指南,重点是 LLM 容易忽略的不明显细节,以提升代码生成的一致性。触发场景为用户提到 project context 或 generate context。
主要能力与机制:工作流采用 micro-file 架构,各步骤为独立文件并内嵌规则,按顺序推进,每一步由用户控制是否继续;文档状态记录在 frontmatter 中。激活阶段包含解析 workflow 配置、执行前置步骤、加载持久化事实、读取 {project-root}/_bmad/gds/config.yaml 中的 user_name、communication_language、output_folder,并以对应语言问候用户,随后执行后置步骤。持久化事实中 file: 前缀的条目按路径或 glob 加载,其余按字面事实处理。
必要用法:激活时运行 uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow;若脚本失败,则按 base→team→user 顺序读取 {skill-root}/customize.toml、{project-root}/_bmad/custom/{skill-name}.toml、{project-root}/_bmad/custom/{skill-name}.user.toml 并手工合并(标量覆盖、表深度合并、按 code/id 键的表数组替换匹配项并追加新项、其余数组追加)。输出写入 {output_folder}/project-context.md,模板为 {skill-root}/project-context-template.md。执行从 steps/step-01-discover.md 开始。
限制:资料未提供费用、平台支持范围、运行时长或成功率的说明;路径解析依赖项目内 _bmad 目录结构与 uv 环境。