mcpField
P
principle-fix-root-causes

principle-fix-root-causes

github.com/poteto开发161100 次安装22 周前更新
代码仓库

关于 principle-fix-root-causes

这项调试技能引导开发者先复现问题,再追查并修复根因和重复模式,而非掩盖症状。它还指出,重启后出现的故障可能源于持久状态。

主要功能

  1. 01修复前先复现问题
  2. 02从症状追查根因
  3. 03搜索并修复重复模式
  4. 04通过插桩获取实际信息
  5. 05重启后检查持久状态

适用场景

  1. 01调查崩溃和错误报告
  2. 02诊断重启后出现的故障
  3. 03清理重复的症状级变通方案

安装

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

$npx skills add https://github.com/poteto/plugins --skill principle-fix-root-causes

安装后在 Claude Code 中输入/principle-fix-root-causes确认已加载。

详细介绍

修复根本原因

调试时,不要只掩盖症状。追溯每个问题的根本原因,并从根源修复。

原因: 症状修复会不断累积。每个变通方案都会让系统更难理解,而真正的 bug 仍然存在。修复根本原因前期耗时较多,但能减少总体调试时间。

做法:

  • 先复现(如果无法复现,就无法验证修复是否有效)
  • 不断追问“为什么”,直到找到根本原因
  • 克制添加保护措施的冲动(添加 nil 检查来消除崩溃只是修复症状)
  • 检查模式,而不只是单个实例(搜索相同模式,并修复所有实例)
  • 遇到阻碍时,添加监测信息。不要猜测(添加日志,读取实际错误)

重启相关 bug:先怀疑状态,而不是代码

两次运行之间代码并未改变,状态却会改变。当某个问题“重启后出现”时,应首先怀疑过期的持久化状态:配置文件、缓存、锁文件、序列化状态。如果清除某个状态文件后行为恢复正常,应优先通过状态验证来修复。

评论

支持 Markdown