SuperAPI AI 工具集

bmad-os-root-cause-analysis

通用与其它

查看项目

更新于 10-15 17:27

技能介绍

用途:分析一个缺陷修复提交或 PR,产出结构化的根因分析(RCA)报告。触发方式为用户说“run RCA on [commit/PR]”“root cause analysis”或“analyze what caused this bug”。

主要能力:识别修复提交/PR;读取修复 diff、PR/issue 讨论,并用 blame/log 定位引入缺陷的提交;收集时间线;应用 5 Whys 分析并归类根因;识别促成因素;检查仓库实际配置(CI 工作流、linter 配置、测试设置)评估防护措施为何未拦截该缺陷;生成报告并写入 _bmad-output/rca-reports/rca-{YYYY-MM-DD}-{slug}.md,同时在对话中呈现执行摘要。

报告结构包含:标题、日期、修复链接或 SHA、严重程度、根因类别(需求/设计/代码逻辑/测试缺口/流程/环境配置)、执行摘要、问题是什么、何时发生(含引入、检测、修复时间与检测延迟)、谁引入、如何发生、为何发生(5 Whys)、失败防护分析表、解决方案、纠正与预防措施表。

使用方式:先执行预检,验证 gh auth status 并确认处于 git 仓库中,任一失败则停止并给出明确信息。随后接受用户提供的 commit SHA、PR、issue 或描述,解析到具体修复提交/PR;若有歧义则询问;确认该变更确为缺陷修复后再继续。

原则:直接归因,报告会点名引入缺陷的个人,刻意偏离行业无责复盘惯例,要求直接、基于事实、非指责;若无法确信确定作者则说明。金字塔式沟通,执行摘要须传达完整信息。

限制:需要 gh 认证与 git 仓库环境;无法确定作者时需明确说明;资料未提供具体安装命令、收费或平台信息。