SuperAPI AI 工具集

investigate

通用与其它

查看项目

更新于 10-16 03:41

技能介绍

用途:用于调查生产环境问题。用户以参数形式提供 bug 报告,可以是日志、错误、描述、截图等任意内容。该技能以资深 SRE 视角推进排查,核心模式是先让 Codex 做首轮调查(使用 codex exec 命令,将结果输出到 /tmp/codex-investigation.md),再由使用者复核验证,而不是自己先动手。

主要能力:一是配置优先原则,外部服务问题通常源于配置而非代码,按顺序检查环境变量是否存在、是否有效(有无尾随空格、格式如 sk_、whsec_ 是否正确)、端点是否可达;二是多假设模式,当存在两个以上可能根因时可组建 3 至 5 名调查员的智能体团队,各认领一个假设进行证伪并相互质询,由负责人汇总共识根因;三是证据要求,声明修复前必须给日志、指标或数据库状态等可观测证据,否则标记为 UNVERIFIED;四是根因纪律,将每个假设分类为 ROOT(修复可消除根本原因)或 SYMPTOM(仅掩盖问题),优先调查根因。

使用方式:按给定命令调用;过程中维护 INCIDENT-{timestamp}.md 实时文档,记录时间线、证据、假设、动作、根因与修复。工具包括可观测性工具、Git、Gemini CLI 等;输出需设定上限,不可盲目全量导出生产日志。完成后可选生成可视化 HTML 摘要。

限制:具体平台、收费与效果暂未提供;可视化在会话过于简单、用户显式选择退出或无浏览器时跳过。