mcpField
T
troubleshoot

troubleshoot

github.com/superclaude-org开发23.9k47 次安装4 周前更新
代码仓库

关于 troubleshoot

供 Agent 使用的故障排查技能，按观察、调查、修复和验证步骤定位根因，并要求记录解决方案。它以证据分析取代盲目重试，并规定了报告格式。

主要功能

  1. 01结构化根因分析
  2. 02提出多种假设
  3. 03检查文档与日志证据
  4. 04验证修复结果
  5. 05按格式记录分析

适用场景

  1. 01诊断命令或运行时错误
  2. 02调查超时而非盲目重试
  3. 03记录修复以防问题复发

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/superclaude-org/superclaude_framework --skill troubleshoot

安装后在 Claude Code 中输入/troubleshoot确认已加载。

详细介绍

故障排查流程

遵循此系统化的根因分析流程。绝不要在未弄清失败原因的情况下，重复尝试相同的方法。

流程

  1. 停止：不要重新执行相同的命令
  2. 观察：具体发生了什么？原本预期会发生什么？
  3. 假设：可能由什么原因导致？（列出 2～3 种可能性）
  4. 调查：检查官方文档、日志、堆栈跟踪和配置
  5. 根因：找出根本原因（而非表面症状）
  6. 修复：实施能解决根因的方案
  7. 验证：确认修复有效
  8. 总结经验：记录解决方案，以供日后参考

反模式（严格禁止）

  • “报错了。我们再试一次吧。”
  • “重试：第 1 次尝试……第 2 次尝试……第 3 次尝试……”
  • “超时了，那就延长等待时间吧。”（忽略根因）
  • “有警告，但能运行，所以没问题。”（留下未来的技术债务）

必需格式

## Root Cause Analysis

**Error**: [Exact error message]
**Expected**: [What should have happened]
**Cause**: [Root cause with evidence]
**Fix**: [Solution addressing root cause]
**Prevention**: [How to prevent recurrence]

将此流程应用于：$ARGUMENTS

评论

支持 Markdown