mcpField
I
investigue

investigue

github.com/naiersaidane开发63500 次安装14 周前更新
代码仓库

关于 investigue

investigue 是面向编码 Agent 的调试技能,在修改代码前分阶段调查问题。它先确认实际症状和预期行为,再经用户逐步确认,从定位问题推进到最小修复。

主要功能

  1. 01确认症状与预期行为
  2. 02定位可能相关代码并复现问题
  3. 03排列三个可证伪的根因假设
  4. 04添加带标签日志检验首要假设
  5. 05确认原因后提出最小修复

适用场景

  1. 01修改代码前调查 Bug
  2. 02通过可观察结果缩小原因范围
  3. 03让调试步骤逐阶段接受用户审阅

安装

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

$npx skills add https://github.com/naiersaidane/claude-mastery --skill investigue

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

详细介绍

在开始之前,请确认你具备以下两项信息:

  • 症状:具体发生了什么(错误消息、观察到的行为、返回值……)
  • 预期行为:应该发生什么

如果缺少其中任何一项,请先明确询问,再继续。


进行任何修复之前,请按顺序完成以下 4 个阶段。每个阶段结束后都要停下来,等待我的确认。

阶段 1:定位并复现。

根据症状探索代码(必要时使用 Explore 子 Agent),找出最可能存在问题原因的 2~3 个位置。逐一列出,并各用一句话说明理由。然后用 3 行描述能稳定复现此错误的最简场景。如果无法可靠复现,请说明这一点,并提出实现可靠复现的计划。

阶段 2:按可能性排序的 3 个根因假设。

提出 3 个关于根本原因(而非症状)的假设,并按可能性从高到低排序。每个假设先用 1 句话说明,然后给出可证伪的预测——“如果此假设成立,我们会观察到 <具体观察结果>;如果观察到相反情况,就排除该假设”。

阶段 3:测试假设 #1。

添加有针对性的日志,以验证假设 #1。每条日志都以标签 [DEBUG-a4f2](4 个随机字符)作为前缀,以便之后批量删除。此阶段不要提出修复方案。告诉我需要观察什么才能确认或否定该假设。

3 次失败规则:如果 3 个假设都不成立,就停止。这不再是代码错误,而是架构问题。我们换个角度。

阶段 4:最小修复。

确认假设后,提出能够解决根因的最小改动。不做无关优化,也不趁机重构。撰写提交说明,解释根因,而不是症状。

评论

支持 Markdown