SuperAPI AI 工具集

logging-observability

部署与运维

查看项目

更新于 10-20 09:05

技能介绍

用途 该技能用于审查代码中的日志记录与错误处理是否规范,核心目标是保证 sentry-mcp 代码库中的错误分类与日志上报行为一致:4xx 错误(用户可自行纠正)绝不应创建 Sentry 问题;5xx 错误(系统故障)必须创建 Sentry 问题。

主要能力 技能内置错误层级与日志函数对照规则。API 错误中,ApiClientError 及其子类(权限 403、未找到 404、校验 400/422、认证 401、限流 429)属于 4xx,不应提交 Sentry;ApiServerError 属于 5xx,应提交 Sentry。应用错误中,UserInputError、ConfigurationError、LLMProviderError 不创建 Sentry 问题。日志函数方面,logDebug、logInfo、logWarn、logError 不创建 Sentry 问题,logIssue 会创建带 Event ID 的问题。

技能可识别多类反模式:用 logIssue 记录 4xx、5xx 只用 logError 导致漏报、直接使用 console 方法、不加区分地捕获所有错误、缺少结构化上下文、直接调用 captureException。对每类问题给出严重级别与修正动作,如将 logIssue(ApiClientError) 改为 logWarn、为 ApiServerError 补充 logIssue。

使用方式 以代码审查清单形式使用,逐项核对错误分类、日志函数选择、结构化上下文(loggerScope、contexts、extra)、错误处理模式(工具处理器让错误冒泡、Agent 工具使用 agentTool 包装、5xx 向用户返回 Event ID)。同时提供正确模式示例,如带降级的错误区分处理,以及错误格式化的参考文件路径(logging.ts、errors.ts、error-handling.ts、agents/tools/utils.ts、docs/error-handling.md)。

适用场景 适用于审查处理错误、调用日志函数或捕获异常的代码,尤其适合 MCP 工具处理器与内嵌 Agent 工具的错误处理评审,以及减少 Sentry 噪声、确保系统故障可被发现的可观测性治理。

限制 资料聚焦 sentry-mcp 代码库的具体错误类型与日志函数,规则与其他项目的通用日志规范可能不同;未说明安装方式、收费、平台支持或效果指标,这些暂未提供。