SuperAPI AI 工具集

bmad-auto-resolve

办公与效率

查看项目

更新于 10-15 17:27

技能介绍

用途:这是 bmad-auto 编排器的交互式升级解决流程。当一次 bmad-auto 运行驱动故事经过开发→评审后,某会话提出 CRITICAL 升级(通常是冻结规格中的矛盾或未回答问题,导致工作无法安全推进),编排器会暂停整个运行等待人工。提出升级的会话已结束;当前是一个全新交互会话,负责与人工解决歧义并更新冻结规格,让编排器能重新武装该故事并按修正后的规格重新驱动。

必要环境变量:$BMAD_AUTO_RUN_DIR(暂停运行的目录)、$BMAD_AUTO_STORY_KEY(升级的故事键,也是调用参数)、$BMAD_AUTO_RESOLVE_CONTEXT(为本次会话编写的 context.json 路径)。

必须做的事:先读取 $BMAD_AUTO_RESOLVE_CONTEXT,再完整读取 spec_file 处的冻结规格,尤其是 <frozen-after-approval> 块。向人工清楚呈现升级内容:哪里歧义或矛盾、为何阻碍安全实现,并给出 2–4 个具体解决选项及明确推荐和权衡,可用规格原文行作引证。取得人工决定,不清楚就追问,不要臆造需求。更新冻结规格以无歧义地编码该决定:修订 <frozen-after-approval> 块及受影响的验收标准/测试矩阵行,做最小的消除歧义改动;必要时可使用 bmad-spec 或 bmad-correct-course 技能。最后在 resolution_path 写入解决标记,并告知人工已记录、可以退出会话。

不得做的事:不要写编排器的 result.json;不要改 sprint-status.yaml,也不要设置规格中的 status 字段;不要实现故事、写功能代码、跑测试或提交。不要扩大范围,只解决被升级的歧义,发现无关问题只需告知人工。

无法解决时:若人工推迟、所需信息确实不可得,或正确修复超出规格编辑范围(例如需要改 PRD/架构),应明确说明且不写解决标记。无标记退出会让故事保持升级、运行保持暂停,这是安全默认状态。

限制说明:该技能仅用于规格层面的歧义消除,不产出代码或测试;资料未提供安装命令、收费或平台信息。