bmad-sprint-planning

概述

你是一位即将采纳此方案的高级开发者。按顺序执行两步：首先像怀疑论者审阅交接文档那样审视规划——现在发现的缺口成本很低，构建中途才发现则不然。然后把机械性工作交给脚本：解析史诗、推导键、合并状态以及写入 sprint-status.yaml 都是确定性任务，而非需要判断的决策。你的判断力应放在脚本无法胜任之处：判断哪些文件是史诗、权衡就绪状态，以及调和脚本标记的任何问题。

激活时

1. 解析自定义配置：uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow。

   • 找不到脚本：此处未设置 BMad。提议运行 bmad 技能的安装流程，如果你还没有 bmad，请先安装(npx skills add bmad-code-org/BMAD-METHOD --skill bmad)，然后再次运行该命令。
   • 任何其他失败：直接读取 {skill-root}/customize.toml 并使用默认值。

2. 按顺序执行 {workflow.activation_steps_prepend} 中的每一项。

3. 将 {workflow.persistent_facts} 中的每一项视为本次运行其余部分的基础上下文。以 file: 为前缀的条目是 {project-root} 下的路径或 glob——将引用的内容作为事实加载。所有其他条目按原文作为事实。

4. 解析配置：uv run {project-root}/_bmad/scripts/resolve_config.py --project-root {project-root} --key core.project_name --key modules.bmm.planning_artifacts --key modules.bmm.implementation_artifacts --key modules.bmm.project_knowledge。{date} 是当前系统日期时间。

5. 向用户问候，检测意图，并仅加载该意图所需内容：

   • readiness —— 仅检查实现就绪状态：加载 references/readiness-gate.md，运行门禁，报告，停止
   • sprint-planning —— 完整流程(也是现有 sprint-status.yaml 的刷新路径)：加载 references/readiness-gate.md，然后在 PASS 时加载 references/generate-tracking.md
   • status —— "显示冲刺状态"、"我们进行到哪里了"：跳过门禁，加载 references/status-view.md
   • validate —— 检查跟踪文件的格式：加载 references/validate.md
   • fix —— 修复或重建损坏的 sprint-status.yaml：加载 references/fix-sprint-status.md

   如果是交互式且不明确，请询问；无头行为参见 ## 无头模式。

按顺序执行 {workflow.activation_steps_append} 中的每一项。

激活已完成。如果 activation_steps_prepend 或 activation_steps_append 非空，请确认每一项都已按顺序执行，然后再继续。

如果脚本失败

此规则涵盖所有意图：当 sprint_plan.py 报错或文件处于其无法处理的状态时，不要停在错误处，也不要静默猜测。自行读取文件，以最佳判断交付相同的结果，告知用户确定性路径失败及其原因，并提供修复流程(references/fix-sprint-status.md)以恢复脚本可处理的文件。

完成时

无论何种意图，都按加载的参考文档收尾，然后如果 {workflow.on_complete} 非空则运行它；将字符串标量视为一条指令，将数组视为一个序列。

无头模式

以无头模式调用时，不要询问。运行门禁，除非意图仅为就绪状态，否则生成跟踪。交互流程会通过询问来解决的歧义(重复的史诗版本、未调和的孤儿项、未确认的修复)将中止并返回 blocked 状态，而不是猜测。以 JSON 响应结束：

{
  "status": "complete",
  "intent": "sprint-planning",
  "gate": "PASS",
  "status_file": "{implementation_artifacts}/sprint-status.yaml",
  "findings": [],
  "warnings": []
}

gate 为 PASS、CONCERNS 或 FAIL；在 FAIL 时包含 findings 以及已写入的发现文件路径(若已写入)，并省略 status_file。intent 为 "readiness"、"sprint-planning"、"status"、"validate" 或 "fix" —— 对于 status 和 validate 意图，省略 gate 并在 report 键下传递脚本的 JSON(不要用 status，该名称表示运行状态)。

参考资料

• scripts/sprint_plan.py — 确定性的解析器/生成器/合并器；子命令 generate、status、validate。其 JSON 输出是本技能读取的契约；argparse 错误也是 JSON
• references/readiness-gate.md — PASS/CONCERNS/FAIL 闸门：工件清单与可实施性问题
• references/generate-tracking.md — epic 发现、generate 命令，以及根据其 JSON 报告采取行动
• references/status-view.md — 状态视图：计数、风险、待办行动项、下一步建议操作
• references/fix-sprint-status.md — 重建损坏的跟踪文件：收集证据的子代理、用户确认、原始状态重新生成
• references/validate.md — 对现有 sprint-status.yaml 的格式验证
• sprint-status-template.yaml — 记录在案的文件格式与状态词汇表；脚本内嵌同一代码块，测试套件将两份副本绑定在一起