用途：该技能面向生成式 AI 应用的可观测性埋点，覆盖从完全没有 OpenTelemetry 到已有生产 collector 的各种成熟度，支持任意语言、模型供应商与框架。它负责添加 gen_ai.* OpenTelemetry span、让应用跑起来，并验证 span 在 Coralogix AI Center 中正确渲染。
主要能力：按四阶段流程工作——评估（Assess）、埋点（Instrument）、运行（Run）、验证（Verify）。评估阶段分析仓库依赖与 OTel 现状，确定成熟度路径（M1 无 OTel、M2 有 OTel 无 GenAI span、M3 已有 gen_ai span 或用户仅要求验证），并最多提出四个由用户决定的问题。埋点阶段按“研究阶梯”选择 span 来源（Coralogix 栈行、开源生态、薄封装、流量咽喉点即网关、手写 span），仅使用开源埋点（OpenLLMetry、OTel contrib GenAI instrumentor 或手写 gen_ai.* span），不使用专有 SDK。运行阶段执行真实交互生成带唯一标记的探针 span。验证阶段执行 12 项 MUST/SHOULD/IF-APPLICABLE 门禁检查（G1–G12），并给出结论。
使用方式：需先阅读完整技能文件，查阅最新 Coralogix 与 OTel GenAI semconv 文档后再写代码；配置 cx.application.name 与 cx.subsystem.name 资源属性；通过环境变量或 gitignored .env 配置密钥与内容捕获；使用 cx CLI 查询 archive 层数据（AI Center 只读 archive 层）。验证需以本次运行的 archive 查询证据为准，计数须用聚合查询而非列表。
适用场景：为无 GenAI span 的应用补齐埋点；审计或拉取已有 span；为某技术栈选择产生 span 的库或网关；排查 span 渲染异常（对话为空、成本为零、所有模型显示同一供应商）。
限制：不覆盖 AI 调用路径之外的整服务 APM、Code Agents 屏幕（Claude Code/Cursor CLI 遥测）、零代码 eBPF 捕获；collector 部署需使用 opentelemetry-collector / opentelemetry-instrumentation。密钥不得粘贴到对话中。