# @dash0/agent-skills 中文文档

规范地址：https://npmcn.com/package/%40dash0/agent-skills/

版本：1\.3\.6
npm 元数据更新时间：2026-08-07T15:52:00.354Z
中文译文更新时间：2026-11-11T12:27:11.424Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40dash0/agent-skills
原文对照：https://npmcn.com/package/%40dash0/agent-skills/?lang=original
项目主页：https://github.com/dash0hq/agent-skills
源码仓库：https://github.com/dash0hq/agent-skills

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：568 kB，51 个文件
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-07-30T16:30:09.072Z
- 最新版本发布：2026-08-07T15:51:59.953Z
- 近 30 天下载量：13757（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：6（近 12 个月 6 个）

## 中文简介

AI 编码助理的 OpenTelemety 技能和参考文件

## 安装

```sh
npm install @dash0/agent-skills
```

也可以使用：`pnpm add @dash0/agent-skills`、`yarn add @dash0/agent-skills`、`bun add @dash0/agent-skills`

## README

# AI 编码代理器的开放远程技术

供应商中性技能,教AI编码代理如何与"OpenTeleomet"(OpenTeleometry)进行仪器应用. 涵盖跨语言的SDK设置,语义常规,收集管,和OTTL转换. 使用任何OTLP相容后端.

技能是可扩展代理能力、随 [代理技能](https://agentskills.io/) 格式. 维护者 [达什 0](https://www.dash0.com/)。 。 。 .

> \[TIP\] 这些技能通过下列方法得到了提高: [泰塞尔](https://tessl.io/)。 。 。 . 试试你自己的经纪人技能,这是值得的.

[![tessl](https://img.shields.io/endpoint?url=https%3A%2F%2Fapi.tessl.io%2Fv1%2Fbadges%2Fdash0%2Fagent-skills)](https://tessl.io/registry/dash0/agent-skills)

## 安装

**安装方式 [技能](https://skills.sh/) 国 际** (普遍性,与任何 [代理技能](https://agentskills.io/)\- 兼容工具 :

```bash
npx skills add https://github.com/dash0hq/agent-skills --all
# or a single skill:
npx skills add https://github.com/dash0hq/agent-skills --skill otel-semantic-conventions
```

工具专用安装指令(Claude Code, Cursor, Tessl等),参见 [总部](https://npmcn.com/package/%40dash0/agent-skills/INSTALL.md)。 。 。 .

**通过 npm 程序控制** (对于嵌入技能而不是将其安装到工具的代理运行时间):

```bash
npm install @dash0/agent-skills
```

包裹运送 `skills/` 目录树逐字——无代码。 在运行时解析技能位置, 例如 :

```js
const { createRequire } = require("node:module");
const path = require("node:path");

const pkgJson = createRequire(__filename).resolve("@dash0/agent-skills/package.json");
const skillDir = path.join(path.dirname(pkgJson), "skills", "otel-instrumentation");
```

## 如何使用

一旦安装,技能自动加载,当任务匹配时,代理员会接取.

**实例:**

```
Add OpenTelemetry instrumentation to my app
```

```
My traces are broken — spans show up as separate roots instead of a connected trace
```

```
Set up an OpenTelemetry Collector pipeline that forwards to Dash0
```

```
Write an OTTL expression to redact credit card numbers from log bodies
```

```
Ensure that my HTTP server spans have the correct attributes
```

```
Help me fix high-cardinality metrics that are blowing up my costs
```

## 为何供应商中立的开路测量

这些技能是围绕OpenTeleometry规格构建的,而不是任何单一后端. 输出为标准OTLP遥测,任何OpenTeleometry相容后端都可以摄取.

销售商在可观察性上的锁定来自专有物剂和属性计划. 此寄存器中的技能既避免:它们引导代理使用 OpenTelemetery SDKs 和 OpenTelemetery 收集器, 并跟踪上游 [语义公约](https://opentelemetry.io/docs/specs/semconv/) 用于属性、跨度和度量命名.

## 语义公约为何重要

[开元语义常规](https://opentelemetry.io/docs/specs/semconv/) 定义用于遥测属性的标准化名称、类型和语义、计量名称、横幅名称和状态代码. 追随它们,是您为可观察性品质所能做的单一最高杠杆.

当文书遵循语义公约时:

-   自动仪器库,仪表板,以及提醒规则在箱外工作.
-   服务地图,操作分组和误差跟踪在没有人工配置的情况下得出正确结果.
-   跨服务查询返回一致的结果,因为每个服务都说相同的属性语言.

当公约缺失或不一致时,这些能力悄悄地退化:没有出错,只是数据不完整,地形观点破碎,查询零散.

## 仪器分数

这些技能方面的指导符合 [仪器分数](https://github.com/instrumentation-score/spec) 规格,一种不偏重任何供应商的指南,以量化一项服务遵循OpenTeleometry最佳做法的情况. 该分类界定了跨资源、跨度、度量和日志的撞击加权规则. 遵循此指导帮助您获得更高的服务分数,这意味着下游的可观察性效果更好.

## 现有技能

### [电解器](https://npmcn.com/package/%40dash0/agent-skills/skills/otel-instrumentation/SKILL.md)

实施高质量,成本高效的开放遥测专家指导. 覆盖多语言的后端和浏览器仪器.

**使用时 :**

-   为新的服务建立可观察性
-   在应用程序中添加痕迹、度量或日志
-   调试仪器问题
-   优化遥测成本(心电图、取样)
-   连接浏览器跟踪到后端跟踪

**规则涵盖:**

-   遥测(信号概览和相关性)
-   资源(服务身份、环境、Kubernetes属性)
-   计量(仪器类型、命名、单位、主要)
-   日志(结构记录、严重程度、痕量关联)
-   节点.js(自动仪器、环境变量、Kubernetes)
-   Go( SDK 设置、 仪器库、 上下文传播)
-   Python (自动仪器,弗拉斯克, Django, FastAPI)
-   Java (javaagent, Spring Boot, JVM 系统属性)
-   .NET(自动仪器、ASP.NET核心、活动来源)
-   Ruby (SDK设置, 铁路, Sinatra)
-   PHP (自动仪器, Laravel, Symfony)
-   浏览器(OpenTeleometry JS, Dash0 SDK, 服务器相关性)
-   Next.js (App路由器,全高架仪表,普通取取取器)

**平台:**

-   节点.js (Express, fastify, NestJS等)
-   上(网/http、人参、回声、纤维等)
-   活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活
-   Java (Spring Boot, Servlet, JAX- RS等)
-   .NET(ASP.NET Core,实体框架等)
-   Ruby (Rails, Sinatra等) (英语)
-   PHP (Laravel, Symfony等) (英语)
-   浏览器(React, Vue, Next.js等)
-   任何 OTLP 兼容后端

### [电解-语义-常规](https://npmcn.com/package/%40dash0/agent-skills/skills/otel-semantic-conventions/SKILL.md)

关于选择、应用和审查OpenTeleometry语义公约的专家指南:用于遥测属性的标准化名称、类型和语义、跨名和地位代码.

**使用时 :**

-   选择跨度、度量或日志的属性
-   命名跨度或选择跨度类型
-   绘制 HTTP 状态代码以覆盖状态
-   审查语义公约遵守情况的遥测
-   从旧属性名称移入新属性名称
-   理解 Dash0 衍生属性

**规则涵盖:**

-   属性(注册、选择、放置、按域划分的共同属性、命名空间)
-   Spans (命名模式, 跨度类型, 状态代码映射)
-   版本(稳定水平、迁移、Dash0语义公约升级)
-   Dash0 (衍生属性, 特征依赖性)

### [收集器](https://npmcn.com/package/%40dash0/agent-skills/skills/otel-collector/SKILL.md)

配置和部署OpenTeleometer收集器以接收、处理和输出遥测的专家指导. 覆盖管道配置,部署模式,并转发到任何OTLP相容后端.

**使用时 :**

-   建立开放的远程采集管道
-   配置接收器、处理器或出口商
-   向库伯涅特或多克部署收集器
-   向任何OTLP兼容后端转发遥测
-   培养收集器的性能(记忆、分批、排队)

**规则涵盖:**

-   接收器(OTLP、Prometheus、文件日志、主机计量)
-   出口者(OTLP/gRPC、调试、认证、重试、排队)
-   处理器(记忆限制器、批量、资源检测、Kubernetes属性、订购)
-   管道(服务科、每个信号配置、连接器、风扇)
-   部署(特工对网关、守护程序、部署、多克编曲、健康检查)

### [缩写](https://npmcn.com/package/%40dash0/agent-skills/skills/otel-ottl/SKILL.md)

为OpenTeleometer Collectioner的变换和过滤处理器编写并调试OpenTeleometer变换语言(OTTL)表达式的专家指导.

**使用时 :**

-   写入 OTTL 表达式以转换、过滤或丰富遥测
-   从跨度、度量或日志校正敏感数据
-   在收藏器中配置转换或过滤处理器
-   调试OTTL 语法或运行时间出错
-   优化收集器管道性能

**能力:**

-   转换(修改属性和值)
-   过滤器( 丢弃不想要的遥测)
-   编辑(隐藏敏感信息)
-   Enrich( 添加背景元数据)
-   转换(更改数据类型和格式)

**背景情况 :** 资源、范围、跨度、跨度、度量、数据点、日志

## 用 Claude 代码自动化

您可以配置 [克劳德代码](https://docs.anthropic.com/en/docs/claude-code) 在交互式会议和无头的CI/CD管道中自动应用这些技能.

### 通过CLAUDE.md的项目指示

添加一个 `CLAUDE.md` 将文件存到您的寄存器根,并带有向 Claude Code 报告何时使用技能的指令. Claude Code 在每次会话开始时加载此文件 .

```markdown
# Observability

This project uses OpenTelemetry for observability.
When adding or modifying instrumentation, follow the guidance from the installed `dash0hq/agent-skills` skills.

When working on application code or deployment specs, use the `otel-instrumentation` skill.
When working on Collector configuration, use the `otel-collector` skill.
When choosing or reviewing telemetry attributes, use the `otel-semantic-conventions` skill.
When writing or debugging OTTL expressions, use the `otel-ottl` skill.
```

### CI/CD 无头模式

使用 `claude -p` 运行克劳德代码 不互动在管道. 这使自动仪器审查、技术指导代码生成和公关检查成为可能.

```bash
# Review instrumentation quality on a pull request
claude -p "Review the OpenTelemetry instrumentation changes in this PR. \
  Check for missing context propagation, incorrect span status handling, \
  and semantic convention violations." \
  --allowedTools "Read,Grep,Glob"
```

#### GitHub 动作示例

```yaml
name: Instrumentation review

on: [pull_request]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Install skills
        run: npx skills add dash0hq/agent-skills

      - name: Review instrumentation
        run: |
          claude -p "Review the OpenTelemetry instrumentation in this PR \
            for correctness and semantic convention compliance. \
            Post your findings as a summary." \
            --allowedTools "Read,Grep,Glob" \
            --output-format json > review.json

      - name: Comment on PR
        run: |
          findings=$(jq -r '.result' review.json)
          gh pr comment "$PR_NUMBER" --body "## Instrumentation review"$'\n\n'"$findings"
        env:
          PR_NUMBER: ${{ github.event.pull_request.number }}
```

## 技能结构

每种技能包括:

-   `SKILL.md` - 对代理人的指示
-   `rules/` - 重点指导文件
-   `README.md` - 人可读文件

## 捐款

见 [捐款额](https://npmcn.com/package/%40dash0/agent-skills/CONTRIBUTING.md) 用于编写规则和在当地运行evals以判断技能是否起作用.

## 常见问题

### @dash0/agent-skills 是什么？

AI 编码助理的 OpenTelemety 技能和参考文件

### 如何安装 @dash0/agent-skills？

在项目目录运行 npm install @dash0/agent-skills，或使用 pnpm add / yarn add / bun add。

### @dash0/agent-skills 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/dash0\_\_agent-skills 是否存在。

### @dash0/agent-skills 可以商用吗？

@dash0/agent-skills 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @dash0/agent-skills 的下载量有多少？

根据 npm 官方下载统计，@dash0/agent-skills 在 2026/10/12 – 2026/11/10 这 30 天内被下载 13,757 次，日均约 459 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @dash0/agent-skills 还在维护吗？

最新版本 1\.3\.6 发布于 2026/08/07（3 个月前）；至今共发布 6 个版本，其中过去 12 个月发布了 6 个；首次发布于 2026/07/31。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。