用途
Troubleshoot 是一个系统化故障排查协议,用于在用户报告错误、Bug 或异常行为时,引导执行者进行根因分析(Root Cause Analysis),而不是在没有理解失败原因的情况下反复重试。其核心原则是:绝不在不明白“为什么失败”的前提下重复同一种做法。
主要能力
该技能提供一套固定的排查流程:
- STOP:不要重新执行同一条命令。
- Observe:准确记录发生了什么,以及原本预期发生什么。
- Hypothesize:列出 2 到 3 种可能导致问题的原因。
- Investigate:检查官方文档、日志、堆栈跟踪和配置。
- Root Cause:识别根本原因,而不是表面症状。
- Fix:实施针对根因的解决方案。
- Verify:确认修复确实有效。
- Learn:记录解决方案,供未来参考。
同时,它明确列出严格禁止的反模式,包括:
- “出错了,再试一次吧”
- “重试:第 1 次……第 2 次……第 3 次……”
- “超时了,那就把等待时间调长一点”(忽略根因)
- “虽然有警告,但能跑,所以没问题”(积累未来技术债)
使用方式
该技能要求以固定格式输出排查结果:
Root Cause Analysis
Error: [确切的错误信息] Expected: [本应发生的情况] Cause: [有证据支撑的根本原因] Fix: [针对根因的解决方案] Prevention: [如何防止再次发生]
技能定义末尾包含 $ARGUMENTS 占位符,表示可将具体问题或参数传入该协议。
适用场景
适用于用户报告错误、Bug 或意外行为时的排查过程,尤其适合需要避免盲目重试、要求给出可验证根因和预防措施的开发与调试场景。
限制
资料未提供该技能的具体安装方式、依赖环境、支持平台、收费模式或与其他工具的集成细节,这些信息暂未提供。