SuperAPI AI 工具集

oodle-o11y-review

部署与运维

查看项目

更新于 10-16 02:39

技能介绍

用途:在编写或代码评审阶段,以资深 SRE 的视角审查代码变更中的遥测,而非教授如何埋点。适用于新增或修改指标、span、日志的变更,或 PR 触及带请求上下文(租户/账户/用户)或可度量工作(I/O、循环、连接池)的代码;纯文档或外观变更可跳过。

主要能力:先做后端发现,按能力与工具形态解析可用的可观测性后端,不硬编码服务器名;优先按功能发现工具(如 find monitors、query metrics、search traces)。若匹配 Oodle 形态(monitors、PromQL query、logs、traces 及 load_skill__* 工作流),走 Oodle 紧路径并加载匹配的 load_skill__*;其他厂商 MCP 用其等价物;无后端时执行检查 1–3 并明确将检查 4 标记为降级。

四项检查:1)业务上下文与基数放置——低基数(route、method、status class、region、tier、queue name)放指标标签,高基数(tenant_id、account_id、user_id、order_id、request_id)放 span 属性与日志字段;循环/批处理需带迭代或批次标识。2)无重复遥测——每个新增信号须有独立职责,重叠则建议移除或说明独特用途。3)性能覆盖模式——请求处理器用 RED,资源池用 USE,异步工作看队列饱和,扇出/N+1 需批处理调用或测量循环的 span。4)告警驱动审查——解析守护被改代码的告警与 SLO,要求存在调试该告警所需的遥测,记录 guarded-by 并提升风险等级,盲点写入 gaps。

输出纪律:只报告高置信发现,标记 critical/important/minor,避免告警疲劳;结果写入清单的 telemetry、guarded-by、watch、gaps 字段;具体修复交接给 oodle-monitors、oodle-drop-rules、oodle-log-metrics 等技能。

限制:仅审查 diff 而非整个仓库;无后端时检查 4 降级并建议作者手动确认;不对未触及代码要求覆盖。