用途:为难以排查的 bug 和性能回归提供一套纪律化诊断循环,依次经过构建反馈回路、复现、假设、插桩、修复与回归测试。仅在明确说明理由时可跳过阶段。探索代码库时,建议使用项目领域词汇表建立模块心智模型,并查看所涉区域的 ADR。
主要能力:第一阶段要求优先构建快速、确定性、可由代理运行的通过/失败信号,可用失败测试、curl/HTTP 脚本、CLI 快照对比、无头浏览器脚本、回放抓取轨迹、一次性最小化环境、属性/模糊测试、二分测试、差分循环,最后才用人工脚本。回路本身需持续优化速度、信号锐度与确定性。对非确定性 bug,目标是提高复现率而非追求干净复现。若确实无法构建回路,应停止并说明尝试过的方法,向用户请求可复现环境、抓取产物或临时生产插桩许可,不得在无回路时进入假设阶段。
使用方式:第二阶段运行回路并确认复现的是用户描述的同一故障;第三阶段先列出 3–5 个可证伪且带预测的排序假设,再向用户展示(不阻塞);第四阶段让每个探针映射到具体预测,一次只改一个变量,优先调试器/REPL,日志需统一前缀如 [DEBUG-a4f2],性能分支先建立基线再二分;第五阶段先在有正确接缝时写失败回归测试再修复,若无正确接缝应记录为架构发现;第六阶段要求原复现不再出现、回归测试通过或记录缺失、清理所有调试插桩与临时原型,并在提交信息中写明正确假设,随后可考虑架构改进移交。
限制与合规:该技能属于 AIX skill pack,用户侧别名为 aix-diagnose;生成的产物写入 .aix/ 目录,写入前需执行 mkdir -p .aix,默认可覆盖,除非明确要求否则不写入项目根目录。资料中未提供具体价格、平台支持范围及版本信息。