SuperAPI AI 工具集

troubleshoot

编程与开发

查看项目

更新于 10-16 02:08

技能介绍

用途

Troubleshoot 是一个系统化故障排查协议,用于在用户报告错误、Bug 或异常行为时,引导执行者进行根因分析(Root Cause Analysis),而不是在没有理解失败原因的情况下反复重试。其核心原则是:绝不在不明白“为什么失败”的前提下重复同一种做法。

主要能力

该技能提供一套固定的排查流程:

  1. STOP:不要重新执行同一条命令。
  2. Observe:准确记录发生了什么,以及原本预期发生什么。
  3. Hypothesize:列出 2 到 3 种可能导致问题的原因。
  4. Investigate:检查官方文档、日志、堆栈跟踪和配置。
  5. Root Cause:识别根本原因,而不是表面症状。
  6. Fix:实施针对根因的解决方案。
  7. Verify:确认修复确实有效。
  8. Learn:记录解决方案,供未来参考。

同时,它明确列出严格禁止的反模式,包括:

  • “出错了,再试一次吧”
  • “重试:第 1 次……第 2 次……第 3 次……”
  • “超时了,那就把等待时间调长一点”(忽略根因)
  • “虽然有警告,但能跑,所以没问题”(积累未来技术债)

使用方式

该技能要求以固定格式输出排查结果:

Root Cause Analysis

Error: [确切的错误信息] Expected: [本应发生的情况] Cause: [有证据支撑的根本原因] Fix: [针对根因的解决方案] Prevention: [如何防止再次发生]

技能定义末尾包含 $ARGUMENTS 占位符,表示可将具体问题或参数传入该协议。

适用场景

适用于用户报告错误、Bug 或意外行为时的排查过程,尤其适合需要避免盲目重试、要求给出可验证根因和预防措施的开发与调试场景。

限制

资料未提供该技能的具体安装方式、依赖环境、支持平台、收费模式或与其他工具的集成细节,这些信息暂未提供。