SuperAPI AI 工具集

debug-mantra

编程与开发

查看项目

更新于 10-16 09:44

技能介绍

用途:debug-mantra 为任何调试会话提供四步纪律框架,要求在首次回复中逐字背诵口诀,然后按顺序执行,减少过早提修复、凭空猜测根因的问题。

主要能力:

  1. 复现:先构建可运行的复现物,如失败测试、curl 脚本、CLI 调用、回放工具。偶发问题先提高触发率(循环、并发、加压、收窄时间窗、注入 sleep),仅 1% 偶发不可调试;完全无法复现则停止并明确说明,向用户索取环境访问、捕获物(HAR、日志、core)或插桩许可。目标为 1–5 秒、确定性的通过/失败信号,固定时间、随机种子、冻结网络、隔离文件系统。
  2. 定位失败路径:优先挂调试器单步到失败点;无调试器则做源码追踪并枚举可影响结果的所有旋钮(配置、环境变量、功能开关、分支条件、输入形态、时序、并发、构建选项),一次只翻转一个;外部旋钮无效再在代码内插桩,用唯一前缀(如 [DBG-a4f2])标记探针便于 grep 清理。
  3. 证伪假设:检查候选根因能否端到端解释症状,先运行最简洁的反证;若存活即为真。同时生成 3–5 个排序假设,避免锚定单一想法。
  4. 面包屑账本:记录每次实验的改动、结果与排除项;新假设须与全部既往观察一致,矛盾则修正或丢弃。必要时设计单一决定性实验。

使用方式:每个调试会话首次回复逐字背诵口诀,不中途重复;用户说“skip the mantra”时跳过背诵但仍静默执行四步。顺序约束:未满足可靠复现不提修复;未收窄失败路径不测试假设;未尝试证伪不确认为正确;未对照全部面包屑不判定假设成立。若发现自己在无可靠复现时提修复,应停下回到第一步。

适用场景:缺陷排查、偶发故障定位、回归分析等需要严谨流程的调试工作。

限制:资料未提供价格、平台支持范围等运行环境细节,暂未提供。