关于 principle-fix-root-causes
这项调试技能引导开发者先复现问题,再追查并修复根因和重复模式,而非掩盖症状。它还指出,重启后出现的故障可能源于持久状态。
主要功能
- 01修复前先复现问题
- 02从症状追查根因
- 03搜索并修复重复模式
- 04通过插桩获取实际信息
- 05重启后检查持久状态
适用场景
- 01调查崩溃和错误报告
- 02诊断重启后出现的故障
- 03清理重复的症状级变通方案
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ poteto/ plugins --skill principle-fix-root-causes安装后在 Claude Code 中输入/principle-fix-root-causes确认已加载。
详细介绍
修复根本原因
调试时,不要只掩盖症状。追溯每个问题的根本原因,并从根源修复。
原因: 症状修复会不断累积。每个变通方案都会让系统更难理解,而真正的 bug 仍然存在。修复根本原因前期耗时较多,但能减少总体调试时间。
做法:
- 先复现(如果无法复现,就无法验证修复是否有效)
- 不断追问“为什么”,直到找到根本原因
- 克制添加保护措施的冲动(添加 nil 检查来消除崩溃只是修复症状)
- 检查模式,而不只是单个实例(搜索相同模式,并修复所有实例)
- 遇到阻碍时,添加监测信息。不要猜测(添加日志,读取实际错误)
重启相关 bug:先怀疑状态,而不是代码
两次运行之间代码并未改变,状态却会改变。当某个问题“重启后出现”时,应首先怀疑过期的持久化状态:配置文件、缓存、锁文件、序列化状态。如果清除某个状态文件后行为恢复正常,应优先通过状态验证来修复。
评论
支持 Markdown