mcpField
E
evidence-first-debugging

evidence-first-debugging

github.com/jamie-bitflight开发35 次安装
代码仓库

关于 evidence-first-debugging

面向软件调查的技能，帮助 Agent 以证据、因果验证和核验门槛组织调试或性能问题分析。通过统一模板、证据规则及领域扩展约束调查输出。

主要功能

  1. 01统一调查模板与证据编号
  2. 02记录观察并验证因果关系
  3. 03软件故障调查扩展
  4. 04性能回归调查扩展
  5. 05假设须包含可证伪测试
  6. 06按核验结果限定问题状态

适用场景

  1. 01整理软件崩溃调查结果
  2. 02分析延迟、吞吐量或内存回归
  3. 03区分已观察事实与待验证假设

安装

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

$npx skills add https://github.com/jamie-bitflight/claude_skills --skill evidence-first-debugging

安装后在 Claude Code 中输入/evidence-first-debugging确认已加载。

附带文件references/shared-references.md

详细介绍

以证据为先的调试

主要职责：记录观察结果、证据 ID、验证因果关系、设置验证关卡。

共享参考资料

在生成任何调查输出前，先加载这些参考资料。可查看参考资料索引，快速了解所有共享文件。

领域扩展

当调查类型符合条件时，加载适用的扩展。将扩展中的各节紧接在第 2 节（观察结果）之后插入。

flowchart TD
    Start([Identify investigation type]) --> Q1{Software bug or crash?}
    Q1 -->|Yes| Dbg["Load [Debugging Extensions](../../shared/extensions/debugging-extensions.md)<br>Adds: CALL STACK, RECENT CODE CHANGES, DEPENDENCY GRAPH after section 2"]
    Q1 -->|No| Q2{Latency, throughput, or memory regression?}
    Q2 -->|Yes| Perf["Load [Performance Extensions](../../shared/extensions/performance-extensions.md)<br>Adds: BASELINE METRICS, REGRESSION WINDOW, HOT PATH ANALYSIS, RESOURCE UTILIZATION after section 2"]
    Q2 -->|No| Neither[Proceed with base template only]

不可妥协的规则

每次调查输出都必须遵守以下规则，不得例外。

规则 1 — 事实 / 观察结果 / 结果中只写事实

只写直接观察到的信号。仅当因果关系关卡分类为 causal-supported 时，才允许使用因果性措辞。不得猜测、解读或推测。

规则 2 — 明确标注每个假设

每个假设都必须说明其预测内容，并包含可证伪的测试。使用以下格式：

H1: [specific causal mechanism]
  Prediction: If H1 is true, we would observe [specific outcome]
  Falsification test: [what would disprove H1]

规则 3 — 仅对已验证的结果使用 resolved-verified

只有当第 13 节（验证）包含一条通过验证且带有证据 ID 的命令时，才输出 status: resolved-verified。如果第 13 节缺失或为空，状态必须为 mitigated、unresolved 或 unknown。

规则 4 — 每项声明都引用证据 ID

事实或结果中的每条陈述都必须以方括号中的证据 ID 结尾，例如 [E3]。没有可引用证据 ID 的陈述必须标记为 UNKNOWN。

规则 5 — 披露所有截断内容

当任何输出经过缩略处理时，必须紧接在片段后添加截断披露块：

TRUNCATED
total lines: <N>
shown: <M>
method: head | tail | grep
fingerprint: <sha256 or key tokens>
command: <exact command used>

禁止静默缩略。

状态选项

每份调查输出只能选择一个状态。将其包含在调查模板的第 14 节中。

flowchart TD
    Start([Choose investigation status]) --> Q1{Is the issue resolved?}
    Q1 -->|No — still occurring| Unresolved[status: unresolved]
    Q1 -->|Partially — symptoms reduced but root cause unknown| Mitigated[status: mitigated]
    Q1 -->|Yes — fix applied| Q2{Does section 13 contain a passing verification command with evidence?}
    Q2 -->|Yes| Verified[status: resolved-verified]
    Q2 -->|No — verification missing or inconclusive| Unknown[status: unknown]

输出检查清单

生成任何调查输出前，核对以下所有项目。

  • 已加载共享参考资料（调查模板、证据规则、因果关系关卡）
  • 如适用，已加载领域扩展（调试或性能）
  • 所有事实和结果均引用方括号中的证据 ID
  • 所有假设均有明确标注，并包含证伪测试
  • 所有截断输出均包含截断披露块
  • 第 10 节中每项操作与结果关联均包含因果关系关卡分类
  • 状态恰为四个有效选项之一
  • 仅当第 13 节包含通过验证的证据时，才使用 resolved-verified

评论

支持 Markdown