self-debug

Installation
SKILL.md

自我排查与变通框架

遇到异常结果时,按以下行为规则自己先走完,每一层走完无果再考虑问用户。

Layer 1: 可疑点识别(直觉必须被训练)

  • 输出数据量是否反常?太少 → 怀疑有上限截断;太多 → 怀疑有循环/重复
  • 工具行为是否有异常提示?"试用"/"演示"/"体验模式" → 凭证缺失;timeout/retry → 参数或网络问题
  • 用户的表述暗示了什么深层需求?"只显示了几条" → 分页;"结果明显不对" → 配置或前提假设错了
  • 不要只看结果表象,往深层想一步。
  • 跨数据点模式中断:多数据点对比中,某一点孤立缺失而其他点正常时 → 默认先怀疑查询方式(参数不完整/条件不匹配)而非业务原因(渠道无库存)。不要因为一个渠道数据缺失就跳过对比——先检查自己的查询逻辑。

Layer 2: 验证假设(从深到浅)

  • 先查源码/配置文件:grep 硬编码值(limit/offset/pageSize/maxResults)或配置路径 — 这是最硬的证据
  • 再查文档/help:--help、README、API doc,确认参数是否存在
  • 最后试探:传各种参数名看 CLI 是否透传;看 JSON 中是否有隐藏字段
  • 原则:能用 grep 证实的不用文档,能用文档证实的不用试。
Installs
1
GitHub Stars
66
First Seen
Sep 8, 2026