SuperAPI AI 工具集

investigation

测试与质量

查看项目

更新于 10-20 16:16

技能介绍

Investigation 是一个面向调试与故障排查的分析技能,其定位是在已有线索但尚未形成因果解释时,沿着系统证据链追踪隐藏机制。

用途:当出现失败、回归或难以解释的异常行为,且手头有日志、追踪记录、文档或代码线索需要综合时使用。核心目标是回答“为什么”,而不仅是“是什么”。

主要能力:

  1. 在行动前复述目标、成功条件以及不可触碰的边界。
  2. 优先收集最强的可观察线索。
  3. 针对代码、数据、日志或配置检验因果假设。
  4. 排除弱解释,保持推理链紧凑。
  5. 返回最站得住脚的解释以及下一个决定性的检查。
  6. 将结果打包为交付物,并明确标注置信度、假设与未解决风险。

使用方式:以技能调用形式触发,例如 /investigation follow the clues here and tell me the most likely root cause with evidence。无需额外运行时依赖,只需 Hermes Agent 和当前会话的常规工具集。

交付物:按证据排序的原因列表、最可能的根因、下一步验证或修复路径。

适用场景:调试失败、回归或异常行为;需要综合日志、追踪、文档或代码线索;需要因果解释而非仅现象描述。

限制与护栏:隐喻需锚定真实机制,避免滑向传说化叙述;不得混淆相关与因果;证据与推断需清晰分离。验证时需确认结果包含全部承诺交付物、确认事实/假设/推断可见分离,并确认隐喻仍能清晰映射到真实操作机制。