SuperAPI AI 工具集

lfm-retro

编程与开发

查看项目

更新于 10-26 16:36

技能介绍

一、用途 lfm-retro 用于对项目中的编码智能体反复出错的情况做一次回顾(retro)。它读取项目过去工作的记录,由工具自带的智能体对记录进行标注与判断,统计重复出现的原因及其次数,并输出证据和已核对的修复方案。工具强调:使用者不要自行判断某条记录,也不要编辑记录源文件或指令文件;是否修改由用户决定。

二、主要能力

  1. 统计窗口内的数字指标,给出本窗口、上一窗口与趋势(上升、下降、持平或未知),并说明哪个方向更差。
  2. 回顾过往修复是否奏效,区分“提议已核对、修复已应用、修复已发布、修复已生效”四种状态,并给出修复前后的数字与判定;对已接受但没有变更记录的修复会给出提示。
  3. 汇总重复出现的错误,列出其代价、复发频率、逐层追问的根因链,以及对应修复(修复须消除根因,而非掩盖症状)。
  4. 报告采用无责(blameless)方式,指向流程、规则、工具或检查的缺口,而非个人或智能体;若发现存在归咎或缺少根因链、缺少代价,工具会拒绝该发现。
  5. 输出 report.txt,并可按需把结果写入项目的已学技能分支,供用户审阅合并。
  6. 还提供 incident 模式,用于深挖单次失败:给出时间线、各根因及其 why 链与代价、为何没有检查拦住、如何避免,以及每个修复的负责人、优先级和截止日期。

三、使用方式 无需安装,直接运行:npx -y learn-from-mistakes-axi <command>。若项目中没有 .learn-from-mistakes.yaml,先运行 npx -y learn-from-mistakes-axi init。随后运行 npx -y learn-from-mistakes-axi doctor,按每条 fail 行下方的 fix 行修复后重跑 doctor。执行复盘:npx -y learn-from-mistakes-axi retro --wait 8m;运行期间可用 attach 或 status 查看进度。用 npx -y learn-from-mistakes-axi report 获取报告路径(report_txt)并阅读 report.txt。用户修改后,用 npx -y learn-from-mistakes-axi change applied --proposal <run>:<n> --ref <git sha> 记录变更,下次复盘会检验其是否生效。单次失败可用 npx -y learn-from-mistakes-axi incident "<what failed>" --evidence <path> --wait 8m,可重复 --evidence 提供文件、截图或链接;用 incident --status 查看各修复的检查结果与仍未关闭的修复。npx -y learn-from-mistakes-axi guide 打印当前版本步骤,--help 列出命令。

四、适用场景 适合需要从编码智能体反复出现的错误中提炼流程与规则改进的软件项目,也适合对某一次具体失败做根因分析。

五、限制与注意事项 智能体看不到截图,涉及截图时需请用户用文字描述。运行需要用户自行选择使用的智能体与模型,工具不会代为选择;当命令提示“ask the user which agent to use”时,需询问用户每个角色所用的智能体与模型,再按其回答运行 init 命令并重跑。worker 与 judge 始终运行,没有可省略它们的模式;若某次运行的智能体失败,该次不留判定结果。报告中的数字与原因只能来自 report.txt,不得自行添加。具体收费、价格与平台支持情况暂未提供。