SuperAPI AI 工具集

figure-out

编程与开发

查看项目

更新于 10-16 00:00

技能介绍

figure-out 是一个跨域根因诊断工作流技能,用于排查代码 bug、数据对不上、指标异常和反复出现的问题。铁律是:找到根因之前不许修,让症状消失不等于解决问题。

主要能力与流程:一是复现并钉住症状,把反常变成可确定性观察(最小可反复运行的复现、用原始数据自己算、钉死统计口径与时间窗);二是假设生成,用第一性方式追问“症状成立必须有哪些事实为真”,每个假设写成可证伪形态(若是它我会看到 X,若不是会看到 Y),并把完整假设清单亮在可见输出中;三是证据采集,证伪优先、单变量、沿数据流向上游找“正确变错误”的交接点;四是根因对账,要求证据精确解释症状的量级与形态,并检查确认偏误、可得性偏误;五是修复与回归防线,修源头不修消费点,代码修复前先写一个会失败的测试钉住 bug,验证做逐笔对账;六是三振止损与元根因,同一症状三次修复失败即停手,并追问缺了哪道防线。

使用方式:非平凡诊断需落盘到工作区草稿目录 .issues/<YYYY-MM-DD-主题>/diagnosis.md,记录假设清单与判定、探针记录、根因对账、修复与验证。落盘前用 git check-ignore .issues 确认被忽略,不通过则把 .issues/ 追加进 .git/info/exclude(本地忽略,不动共享 .gitignore)并告知用户;非 git 环境直接写。该文件同时作为假设清单载体、三振计数器与会话中断后的工作记忆。一眼可定位的小问题可免。

限制与注意:动手仅指改变行为的修改,只读探针与为可测试性做的纯脚手架不算;出现“先改改试试”“让数字对上就能交”“加个重试兜底”“清单心里有数”“再试一次这个方向”“报错太怪先绕过去”等念头时应当停下。官方文档、收费与平台支持等信息暂未提供。