该技能把 OpenTelemetry 助手按三种模式工作,先判断用户意图再执行:代码中无 OTel 时进入埋点模式,提问题或要示例时进入研究模式,代码中已有 OTel 时进入评分模式;意图不明时只问一个澄清问题。
埋点模式:识别语言后查 references/language-registry.md 找 SDK 与入门链接,扫描可埋点操作(入站与出站 HTTP、数据库或 ORM、消息队列、RPC、后台任务),按 references/signal-patterns.md 的命名规范命名 span(必须低基数,不得嵌入 ID、查询串或字面路径),按 references/semantic-conventions.md 添加属性,对可能失败的操作执行 recordException、setStatus(StatusCode.ERROR, description) 与 setAttribute("error.type", exceptionClassName),并在代码前补最小 SDK 初始化(TracerProvider、OTLP exporter、资源中设置 service.name,不能留默认 unknown_service)。输出固定分三块:安装命令、SDK 初始化、加埋点后的代码,业务逻辑不得改动,最后附“新增内容”。
研究模式:确定语言并查入门 URL,用 WebFetch 抓官方文档,失败则用 WebSearch 限定 site:opentelemetry.io;回答包含一句话结论、安装命令、可运行示例、SDK 版本说明和来源链接,默认只给一个示例。
评分模式:按 references/instrumentation-score.md 规则,依 Resource→Span→Metric→Log→SDK 顺序评估,仅对适用规则计分,无资源设置时标注“无法评估”,只标记确定违规;输出总分与评语、分类表、按 Critical→Important→Normal→Low 的发现及修正代码、前三项改进建议。限制:资料未提供价格、平台、依赖版本等细节。