OpenTelemetry 代理技能包
为编码代理注入准确、最新的 OpenTelemetry 知识，按需检索上游权威来源而非复制文档。
- Star 数
- ★ 112
- 最近更新
- 2 天前
- License
- Apache-2.0
- 主语言
- Go
- FA 评分
- 54/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude CodeChatGPT（部分支持）
- 费用
- 免费，无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 使用 Claude Code 的工程师在为新 Go 服务接入 OpenTelemetry 时，加载 otel-go 技能获得 otelconf 声明式配置、otelhttp/otelgrpc 等 contrib 库以及 otelc 编译期零代码注入要点。
- 不适合
- 使用不支持 Agent Skills 规范的编码代理的团队
- 希望直接获得带主观推荐配置（预设约定）的用户
这个 Agent 能做什么，适合哪些场景？
ollygarden/opentelemetry-agent-skills 是一套遵循 Agent Skills 规范的开源技能集合，面向 Claude Code、Cursor、Codex、GitHub Copilot 等编码代理，提供 Go、Java、JavaScript、Python、.NET、Ruby 及浏览器端的 OpenTelemetry SDK 设置、Collector 配置、OTTL、语义约定与升级知识。仓库按语言无关与语言特定两类组织技能，每个技能是 skills/ 目录下自包含的文件夹，含 SKILL.md 与 references/ 或 components/ 等参考数据，Collector 技能还按组件类型提供渐进式披露的 README 与细节文件。技能强调非主观立场与令牌高效，通过小型取数表、查找索引和脚本指向上游真实来源，而不是把文档复制进上下文。安装方式包括 skills.sh 的 npx skills add、Claude Code 的插件市场注册与安装，以及在 Cursor、Codex、GitHub Copilot 上用 -a 指定代理。仓库自带 bin/validate-skill.sh、bin/check-skill-inventory.py 校验脚本与 tools/ 下的生成工具，贡献需签署 OllyGarden CLA 并提交对照 harness 结果。
技能以 SKILL.md 加参考文件夹的形式提供可被代理加载的知识单元：otel-collector 通过 components/<type>/README.md 渐进披露 Collector 组件的配置键、默认值、校验、信号支持与稳定性；otel-collector-builder 覆盖 OCB 构建清单与版本对齐；otel-declarative-config 指向 otelconf、OTEL_CONFIG_FILE、file_format 的上游模式与环境变量替换规则；otel-ottl 用于编写和调试 transform、filter、routing、tail_sampling 处理器语句；otel-profiles 指导在 Linux 主机和 Kubernetes 上部署 otelcol-ebpf-profiler 并导出 OTLP profiles；otel-semantic-conventions 通过捆绑查询脚本查找发布的语义约定属性与 span 命名规则；otel-span-events-to-logs-migration 按 OTEP 4430 把 AddEvent、RecordException 迁移到 Logs API；otel-telemetry-emissions 提供按版本生成的遥测清单以对比组件或 SDK 的发射变化；otel-telemetrygen 生成 telemetrygen 命令；otel-upgrade 与 otel-weaver 分别评估升级风险与编排 Weaver registry、Jinja2 模板和 weaver registry check/generate/diff。语言技能则给出各语言 SDK 的初始化、零代码注入、contrib 库目录与破坏性变更审计要点。
- 使用 Claude Code 的工程师在为新 Go 服务接入 OpenTelemetry 时，加载 otel-go 技能获得 otelconf 声明式配置、otelhttp/otelgrpc 等 contrib 库以及 otelc 编译期零代码注入要点。
- 负责可观测性平台的团队在编写 Collector 的 OTTL transform 或 tail_sampling 规则时，用 otel-ottl 技能调试语法与语义并避免常见错误。
- 运维工程师需要在 Kubernetes 上启用连续性能分析，使用 otel-profiles 技能部署 eBPF profiler、验证数据到达并按错误信息排查。
- 正在升级 Collector 或某个 SDK 的团队，借助 otel-telemetry-emissions 与 otel-upgrade 对比各版本遥测发射变化并评估兼容性与回滚风险。
- 维护语义约定的开发者用 otel-semantic-conventions 的捆绑查询脚本核对属性名与 span 命名是否符合已发布规范。
- 在 Codex、Cursor 或 GitHub Copilot 中通过 npx skills add … -a 指定代理安装技能，让不同代理共享同一套 OpenTelemetry 知识。
如何安装或部署这个 Agent？
通过 skills.sh 安装全部技能：
npx skills add https://github.com/ollygarden/opentelemetry-agent-skills或只安装单个技能，例如 otel-go：
npx skills add https://github.com/ollygarden/opentelemetry-agent-skills/tree/main/skills/otel-goClaude Code 需先注册插件市场再安装技能：
/plugin marketplace add ollygarden/opentelemetry-agent-skills
/plugin install otel-go@opentelemetry-agent-skillsCursor、Codex、GitHub Copilot 等代理用 -a 指定：
npx skills add ollygarden/opentelemetry-agent-skills -a cursor运行仓库自带的校验门（Agent Skills 规范符合性）：
./bin/validate-skill.sh
./bin/check-skill-inventory.py如何使用这个 Agent？
把技能安装到代理后，直接用自然语言提出 OpenTelemetry 相关问题，代理会按需读取对应技能的 SKILL.md 与 references/。例如请求“给这个 Python 服务加声明式 SDK 配置”，会命中 otel-python；请求“这段 transform 处理器报错，帮我改”会命中 otel-ottl。
需要更细的 Collector 组件信息时，技能会渐进读取 components/<type>/README.md 及按需细节文件。
贡献新技能时，先按规范创建目录结构：
skills/
otel-go/
SKILL.md # name: otel-go
references/并在提交前运行：
./bin/validate-skill.sh
./bin/check-skill-inventory.py新增或实质修改技能的 PR 必须附上 harness 结果，对比前沿模型在有无技能两种情况下的表现；首次提交需签署 OllyGarden CLA。
这个 Agent 有哪些优点和局限？
- 严格供应商中立，明确不预设约定，避免把某家偏好强加给使用者
- 设计上令牌高效：小型取数表、查找索引与生成工件指向上游来源，减少上下文浪费
- 覆盖广：7 种语言 SDK 加 Collector、OTTL、语义约定、Weaver、升级等语言无关技能
- 遵循 Agent Skills 规范，同一套技能可用于 Claude Code、Cursor、Codex、GitHub Copilot 等多种代理
- 自带 bin/validate-skill.sh 与 check-skill-inventory.py 校验门，与 CI 一致，可在本地复现
- 贡献流程要求 harness 对照结果与 CLA，对技能有效性有可审计要求
- 技能只提供知识与检索路径，不直接安装或运行 OpenTelemetry，实际配置仍需使用者自行落地
- 安装依赖 npx / Node.js 与代理本身对 Agent Skills 规范的支持，老版本代理可能无法加载
- 非主观立场意味着不给出开箱即用的推荐配置，选型与约定仍需自行决策
- 技能质量依赖向上游文档和源码的引用，网络不可用时部分检索能力受限
- 部分语言技能仅以 references/ 形式提供，目录结构未在 README 中逐项展开
这个 Agent 与同类方案有什么区别？
README 提到 OllyGarden 另有一个带主观倾向的 skills 包（github.com/ollygarden/skills），并说明本仓库技能与之的关系；此外 Agent Skills 规范本身有 agentskills.io 规格与 vercel-labs/skills CLI 作为参照。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| OpenTelemetry 代理技能包 当前 | 54 · 缺口较多 | Agent 插件 / 技能免费 | ★ 112 | 2 天前 | Go | Codex · Claude Code |
| Judgeval | 40 · 缺口较多 | 代码库 / SDK免费 + 模型费 | ★ 1.1k | 17 天前 | Python | OpenAI API |
| cc-skills-golang：Go 语言智能体技能包 | 35 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 3.5k | 17 天前 | Go | ChatGPT · Codex · Claude Code |
| Monocle GenAI 追踪框架 | 58 · 缺口较多 | 代码库 / SDK免费 + 模型费 | ★ 342 | 17 天前 | Python | — |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：CI 工作流显式设置 permissions: contents: read，checkout 使用 persist-credentials: false，第三方 action 均以 commit SHA 固定（actions/checkout、astral-sh/setup-uv、golangci-lint-action），CLA 工作流也固定到不可变 SHA，依赖安全处理得较好，故 dependency_security 给 2。source_attribution 给 2：README 明确指向 agentskills.io 规范、上游 OpenTelemetry 文档与 ollygarden.com 目录，并声明技能“非意见化、以上游为准”。扣分点：least_privilege 仅 1，因为技能本身会指导 agent 执行 npx skills add、安装插件、运行 OCB/telemetrygen 等命令，仓库未提供任何权限范围声明或沙箱约束；user_confirmation 为 0，全文没有任何要求 agent 在执行安装、构建、生成或修改配置前征求用户确认的机制；data_flow_transparency 仅 1，README 提到“token 高效检索”“指向上游而非复制文档”，但没有说明技能运行时会读取哪些本地文件、向哪些上游端点发起请求；sensitive_data_handling 仅 1，otel-browser 技能提到 PII 权衡，但仓库层面没有敏感数据（凭据、遥测内容、用户数据）处理规范；external_effects 仅 1，安装与构建类技能会产生真实副作用（写入 agent 配置目录、拉取依赖、构建二进制），但未声明影响范围或幂等性；rollback 为 0，没有任何卸载、回滚或恢复说明。
self_consistency 给 2：README 的技能清单、目录结构说明与 CI 中的 validate-skill.sh / check-skill-inventory.py 门禁相互一致，命名与路径描述自洽。dependency_availability 仅 1：技能依赖 npx skills CLI、uv 安装的 skills-ref 校验器、Go 工具链与上游 OpenTelemetry 文档站点，这些外部依赖的可用性、离线行为与失败降级均未说明。failure_messages 仅 1：otel-profiles 提到“按错误信息排障”，但仓库层面没有统一的错误处理或诊断输出约定，CI 失败信息也依赖外部 action 默认行为。
audience_and_scenarios 给 3：README 明确面向 Claude Code、Cursor、Codex、GitHub Copilot 等编码 agent，并为每个技能给出“Use When”场景表，覆盖 Go/Java/JS/Python/.NET/Ruby/浏览器及 Collector、OTTL、语义约定、升级等，场景界定充分。capability_boundaries 给 2：明确声明“非意见化、不规定约定”，并说明技能只做检索与指向上游，边界表述清楚，但未说明技能不覆盖哪些 OpenTelemetry 领域（如后端存储、采样策略设计）。trigger_precision 给 2：每个技能有 name 字段与 Use When 描述，符合 Agent Skills 规范的触发语义，但缺少触发/不触发的反例与冲突消解规则。environment_fit 给 2：安装路径覆盖 skills.sh、Claude Code 插件市场与 -a 指定 agent，适配面广，但未说明各 agent 的版本要求、操作系统差异或离线环境适配。
information_architecture 给 3：README 结构清晰，含技能总表、安装、仓库结构树、贡献指南，目录按 skills/、bin/、docs/、tools/ 分层，信息组织良好。install_notes 给 3：给出 skills.sh、Claude Code 插件市场、Cursor/Codex/Copilot 三种安装方式及具体命令，安装说明充分。naming_stability 给 2：技能名与目录名一致并声明遵循 agentskills.io 规范，但未给出命名变更或重命名兼容策略。examples_and_faq 仅 1：README 只有安装命令示例，缺少技能使用示例、输入输出样例与 FAQ。known_limitations 仅 1：仅提到“非意见化”和“实验性 metrics/logs、browser-sdk”等零散限定，没有集中的已知限制章节。license 给 3：Apache-2.0 全文随仓库提供，README 徽章与 LICENSE 一致。versioning_changelog 为 0：没有 CHANGELOG、版本号或发布记录，技能与上游版本的对应关系也未在仓库层面声明。maintenance_responsibility 给 2：README 指向 CONTRIBUTING、SUPPORT、治理政策、安全政策与 CLA，维护路径明确，但发布者身份未经验证，且未指定具体维护者或响应时限。
output_usability 给 2：技能设计为 token 高效检索、小 fetch 表与查询脚本，输出面向 agent 直接使用，方向合理，但仓库未展示任何实际输出样例，无法确认可用性。marginal_value 给 2：相对模型训练知识，技能强调“当前且准确”的上游信息与版本化遥测清单，具备增量价值，但价值大小依赖上游文档质量，且与直接查阅 OpenTelemetry 官方文档存在重叠。cost_benefit 给 2：安装成本低（npx 一条命令），但技能数量多、部分技能需要构建工具与生成数据，长期维护与上下文成本未量化。
claim_traceability 给 2：README 大量指向上游来源（agentskills.io 规范、OpenTelemetry 文档、OTEP 4430、ollygarden.com 目录），并声明技能以上游为准，可追溯性较好，但未逐条给出具体上游链接或版本锚点。cross_source_corroboration 仅 1：仓库内只有 README、LICENSE 与两个 CI 工作流可见，技能正文、bin 脚本、tools 代码均未提供，无法交叉验证 README 对技能内容与门禁行为的描述。fact_inference_separation 仅 1：README 中“准确、当前”“token 高效”“技能有帮助”等属于主张，仓库未提供 harness 结果或评测数据来区分事实与推断，贡献指南虽要求 PR 附 harness 结果，但本仓库未展示。
- 源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 发布者身份未经验证，仓库归属与维护承诺无法独立确认，采用前应自行核实来源。
- 技能会引导 agent 执行安装、插件注册、构建与配置修改等有副作用的操作，仓库未提供权限范围、确认机制或回滚/卸载说明。
- 仓库仅提供 README、LICENSE 与两个 CI 工作流，技能正文、bin 脚本与 tools 代码不可见，README 对技能内容与门禁行为的描述无法交叉验证。
- 缺少 CHANGELOG、版本号与技能到上游版本的映射，长期使用可能遇到上游漂移而难以定位变更。
- README 中“准确、当前”“技能有帮助”等为未经验证的主张，仓库未附 harness 结果或评测数据。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
First tagged release of OllyGarden Agent Skills for OpenTelemetry: 18 vendor-neutral skills for coding agents such as Claude Code, Cursor, Codex, and GitHub Copilot. Install: npx skills add ollygarden/opentelemetry-agent-skills Catalog: https://ollygarden.com/resources/agent-skills在 GitHub 查看 ↗