一、基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 正式名称 | otel-collector（合集仓库子技能，完整标识见下） | 合集仓库子目录名 |
| 所属合集仓库 | ollygarden/opentelemetry-agent-skills | GitHub API |
| 作者/维护者 | OllyGarden（ollygarden.com）；主要贡献者 jpkrohling 曾任 OpenTelemetry Collector 项目 approver/maintainer，2025 年 4 月转为 emeritus、专注创业 | GitHub 贡献者列表 + 公开 PR 记录交叉验证 |
| 来源链接 | https://github.com/ollygarden/opentelemetry-agent-skills/tree/main/skills/otel-collector | — |
| 许可证 | Apache-2.0 | GitHub API |
| 合集仓库整体 Stars/Forks | 81 / 7（该数字属整个合集仓库，不代表本技能自身热度） | GitHub API |
| 该技能自身活跃度 | 按路径过滤提交历史，2026-05-18 至 2026-08-03（含当日）共 49 次专属提交；全仓库累计 198 个 PR | GitHub API（按路径过滤的提交历史 + PR 搜索） |
| 最新版本 | 无正式版本号（不发 Release/Tag，随主干滚动更新） | GitHub API |
| 安装方式 | skills.sh 一条命令，或 Claude Code 插件市场 | 官方 README |
二、功能介绍与亮点
otel-collector 是 OllyGarden 出品的 OpenTelemetry Collector 组件配置技能，覆盖 receiver / processor / exporter / connector / extension 五类组件的配置项、默认值、校验规则、支持的信号类型（trace/metric/log/profile）与逐信号稳定性等级。
- 渐进式披露架构：每个组件先给一份精简
README.md（元数据 + 主要用例 + 细节索引），再按需展开configuration.md/verification.md/advanced.md/quirks.md四类详情文件，避免一次性把大量文档塞进上下文 - 内置验证工作流：给出
telemetrygen造数据命令配合debug/fileexporter 的组合配方，能实际跑一遍配置、核对行为是否符合文档所述，而非停留在纸面配置 - 主动追踪组件重命名：记录 v0.146.0–v0.154.0 间多个组件批量 snake_case 重命名（如
logdedup→log_dedup）及废弃别名，避免依赖训练数据中的过时配置键名 - 稳定性等级颗粒度到信号：同一组件不同信号（如
redaction对 traces 是 Beta、对 logs/metrics 是 Alpha）分别标注，用于判断是否适合生产环境 - 供稿要求 PR 附带“同一 prompt 在前沿模型上有无本技能的对比”作为收录证据，仓库设有 CI 校验脚本、贡献者 CLA、行为准则与安全策略
三、适用场景
固定分类：DevOps 与基础设施
面向编写、评审或调试 OpenTelemetry Collector YAML 配置的后端 / SRE / 平台工程师——例如新增一个 receiver 但不确定默认端口是否会漏收容器化流量、给多个 processor 排序时不确定 memory_limiter 该放第几位、或升级 Collector 版本后想确认某个组件名是否已被改名。
四、跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | README 明确给出 /plugin marketplace add + /plugin install 插件市场安装步骤 |
| Codex | 未验证 | 已抓取材料未提及 Codex 专属安装方式 |
| OpenClaw | 未验证 | 已抓取材料未提及 |
| Hermes Agent | 未验证 | 已抓取材料未提及 |
（另有 npx skills add 通用安装方式，按 Agent Skills 规范面向兼容该规范的工具，但未在材料中看到对 Codex/OpenClaw/Hermes Agent 的具名确认。）
五、推荐理由
OpenTelemetry Collector 的配置面复杂且演进快——组件会被重命名、稳定性等级因信号而异、Alpha/Beta 组件行为可能随版本变化。Agent 若只凭训练数据里的旧知识作答，很容易给出过时或语义有歧义的配置（如 timeout=0 到底是“立即过期”还是“永不过期”）。这个技能把这类易变的知识点从“内嵌记忆”改为“按需查询权威索引 + 跑一遍验证配方”，并显式追踪组件改名与逐信号稳定性，帮工程师更快配对、少踩坑。
六、评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | 所属合集仓库整体 81 stars/7 forks（不计入本技能个体分）；主要贡献者曾任 OpenTelemetry Collector 项目 approver/maintainer；第三方插件目录 claudepluginhub.com 已独立收录；同期出现由 Dash0 公司出品的对标技能（星数相近），印证该细分方向存在真实但尚属早期阶段的关注度 |
| 可用性 | 9 | npx skills add 一条命令或 Claude Code 插件市场安装，无需 API Key 或付费依赖；文档采用渐进式披露、覆盖 15 个组件且均为实质内容非占位；本技能子目录近 3 个月内已有 49 次专属提交，维护活跃 |
| 安全性 | 9 | 见下方安全检查清单 |
| 综合评分 | 8.0 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令与权限范围 | SKILL.md 本身不含可执行脚本；工作流建议运行 telemetrygen（上游官方 CLI）与 otelcol-contrib 做验证，均为用户自行安装运行的标准 OTel 生态工具，技能本身不自动执行 |
| ② 运行时联网外发 | 验证配方中的 Collector/telemetrygen 通信默认在本机完成，未发现数据外发指令 |
| ③ API Key/凭据 | 不涉及，纯配置知识查询，无需任何凭据 |
| ④ 可疑指令排查 | 已完整抓取并阅读 otel-collector 的 SKILL.md 及仓库 README，未发现 prompt injection 或隐藏指令迹象；全仓库仅 3 个脚本文件，均位于其他子技能目录（otel-semantic-conventions、otel-span-events-to-logs-migration、otel-weaver），otel-collector 目录本身零脚本 |
| ⑤ 作者/组织信誉 | OllyGarden（ollygarden.com）；主要贡献者曾任 OpenTelemetry Collector 项目 approver/maintainer |
| ⑥ License | Apache-2.0，仓库根目录明确声明 |
| ⑦ 最近维护 | 仓库整体持续提交，最近一次为 2026-08-03；本技能子目录近 3 个月内 49 次专属提交，全仓库累计 198 个 PR |
未给满分的原因：验证工作流会引导使用者运行 telemetrygen、otelcol-contrib 等外部命令行工具，而非纯文档/模板型技能。
七、跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本 skill 的差异 |
|---|---|---|
| dash0hq/agent-skills | 可观测性厂商 Dash0 出品的同类技能包，同样宣称厂商中立，覆盖 SDK 设置、语义约定、Collector 管道、OTTL 转换；星数与创建时间相近（80★，2026-02-24 创建） | 是同期出现的直接竞品，两者都指向 OpenTelemetry 上游文档而非自建知识库；本 skill 在 Collector 组件这一单点上采用“精简索引 + 按需详情文件 + 内置验证配方”的三层结构，并显式维护组件重命名与逐信号稳定性等级 |
| 传统方式：直接查 opentelemetry-collector-contrib 仓库文档 | 各组件 README 详略不一，缺少统一的稳定性/重命名/验证配方结构，agent 需要自行判断该信任哪个版本的说法 | 本 skill 把这些信息整理为统一格式的索引表并标注权威性，减少 agent 现场推理或臆造的空间 |
八、用户评价
该技能目前未发现来自 Reddit、Hacker News 等社区平台的具名用户评价。第三方 Claude 插件目录 claudepluginhub.com 已将其收录并列出组件级技能清单。
九、其他补充
同一合集仓库下还有 14 个姊妹技能，包括语言专属的 otel-go / otel-java / otel-js / otel-python / otel-dotnet / otel-browser，以及 otel-ottl、otel-declarative-config、otel-semantic-conventions、otel-collector-builder、otel-weaver、otel-telemetrygen、otel-sdk-versions、otel-span-events-to-logs-migration，安装机制与本技能相同。
十、安装使用方式
skills.sh（通用）：
npx skills add https://github.com/ollygarden/opentelemetry-agent-skills/tree/main/skills/otel-collectorClaude Code 插件市场：
/plugin marketplace add ollygarden/opentelemetry-agent-skills
/plugin install otel-collector@opentelemetry-agent-skills安装后注意事项：无需重启、无需额外配置。用“OpenTelemetry Collector 配置”“receiver / processor / exporter 怎么配”等关键词描述需求即可触发，Agent 会按组件类型自动加载对应文档。
十一、注意事项
- 明确排除的场景：OTTL 表达式本身的写法（对应 otel-ottl 技能）、SDK 端声明式配置（对应 otel-declarative-config 技能）、端到端管道设计选择，均不在本技能范围内，只覆盖单个组件的配置面
- 组件覆盖为精选而非全量（README 原文声明）：未被索引的组件需回退到上游 opentelemetry-collector-contrib 对应组件的 README
- License 为 Apache-2.0，企业分发需遵循署名、声明变更、无担保等条款
- 该技能是合集仓库中的一个子技能，来源链接与安装命令务必使用本报告给出的子目录级路径，而非仓库根链接
- Codex、OpenClaw、Hermes Agent 的兼容性尚无可验证材料，如需在其他 Agent 环境使用请自行测试