这个 Skill 能做什么，适合哪些场景？
这是 NVIDIA Agent Skills 集合中的一个工具型技能，面向已通过 doca-dpa 启动 DPA 工作负载的开发者和平台运维人员。它指导代理使用 doca_dpa_hl_tracer 捕获 DPA 侧的内核进入/退出、同步点、通信原语调用、RDMA WR 提交和完成排空等高级事件。技能涵盖 TRACE 与 CRIT 模式选择、JSON 配置、文件大小限制、线程优先级与核心绑定，以及使用匹配的 DPA ELF 解码。它不用于编写 DPA 内核、主机侧调试、原始周期级分析或生产遥测。
指导用户检查 DOCA、BlueField DPA、DPACC ELF 和运行中工作负载等前置条件；选择 TRACE 或 CRIT 捕获模式；配置日志/二进制文件大小限制、超限策略、线程优先级和核心亲和性；运行 doca_dpa_hl_tracer 并生成二进制 trace 文件和可读日志；将捕获结果与匹配的 DPA-side ELF 配对解码；按安装、设备绑定、镜像插桩、捕获窗口、解码、版本和观测开销等层次排查空捕获、噪声或解码失败。
- DPA 内核返回错误结果，但主机侧完成状态正常的开发者，用 DPA 侧事件流定位执行问题。
- 发现内核启动到首次通信调用、RDMA WR 提交到完成排空之间存在异常延迟的工程师。
- TRACE 模式使延迟明显上升、需要降低观测开销的平台运维人员。
- 二进制 trace 文件达到大小上限或中途截断，需要调整文件限制和超限策略的操作者。
- 工具成功写出文件但解析结果为空，需要区分未触发事件、镜像不匹配或安装问题的用户。
如何安装这个 Skill？
- 不要把 benchmark 的 PASS 或品牌 provenance 当作可靠性、有效性或安全性的独立证明；报告明确称原始评测数据集不可用。
- 执行前必须核对已安装版本的 --help、权限、模式令牌、JSON 键和 ELF 匹配关系；trace 文件可能包含敏感工作负载信息。
- 应解决 SKILL.md 与 SKILLCARD.yaml 的许可证元数据不一致，并补充版本、变更记录和可复现测试覆盖。
- Shell / 命令行
- 本地文件系统
DOCA SDKDOCA DPA ToolsBlueField device with an exposed DPA processorDPACC-built DPA-side ELFlive doca-dpa-launched workloadLinux: Ubuntu 22.04/24.04 or RHEL/SLES
使用 NVIDIA/skills 集合的 skills CLI 安装指定技能：
npx skills add nvidia/skills --skill doca-dpa-hl-tracer --yes
该命令只安装技能目录，不会替你安装 DOCA。实际使用还需要在 Linux 上安装 DOCA SDK 和可选的 DOCA DPA Tools，并准备 BlueField DPA、匹配的 DPACC ELF 及已运行的 doca-dpa 工作负载。
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/NVIDIA/skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/doca-dpa-hl-tracer" ~/.claude/skills/
rm -rf "$tmp"根据源仓库地址和 Skill 路径自动生成，只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式，请优先按作者说明操作；想只在当前项目中使用，把 ~/.claude/skills 换成项目里的 .claude/skills。
如何使用这个 Skill？
安装后，把下面任意一句发给 Agent 即可触发：
- 帮我用 doca_dpa_hl_tracer 分析 DPA 内核到首次 RDMA WR 提交之间的延迟，并检查 trace 文件是否被截断。
先确认问题属于 DPA 侧高级事件追踪范围，再配置捕获窗口和 JSON 配置。通常先使用 CRIT 降低开销，需要逐事件细节时再使用 TRACE。运行形式为：
doca_dpa_hl_tracer --mode <TRACE或CRIT> --config-file <配置文件> --output-file <输出文件>
随后使用与已加载 DPA 镜像匹配的 ELF 解码捕获结果。所提供材料未给出完整 JSON 示例、解码命令或全部参数，因此应以安装版本的 --help 和对应 DOCA DPA Tools 文档为准。可向代理提问：“帮我用 doca_dpa_hl_tracer 分析 DPA 内核到首次 RDMA WR 提交之间的延迟，并检查 trace 文件是否被截断。”
这个 Skill 有哪些优点和局限？
- 针对 DPA 编程事件提供清晰的捕获、解码和排障流程。
- 覆盖 TRACE/CRIT 的细节与观测开销权衡。
- 明确区分 DPA 侧追踪、主机侧 doca-dpa 控制和原始周期分析。
- 涵盖文件限制、捕获窗口、ELF 匹配和版本兼容性等常见失败点。
- 依赖已安装的 DOCA SDK、DOCA DPA Tools、BlueField DPA 和正在运行的工作负载。
- 技能本身不包含示例 trace、解析器、包装脚本或 samples/reference 子树。
- 提供的材料没有完整 JSON 配置、解码命令或全部事件名称；需依赖安装版本的 --help 和公共文档。
- 追踪是有边界的调试手段，不应作为生产观测方案。
这个 Skill 与同类方案有什么区别？
与相关 Skills 并排比较；分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| DOCA DPA 高级追踪器 本页 ✓ NVIDIA · 官方 | 50 · 谨慎使用 | ★ 3.8k | 今天 | Apache-2.0 |
| DOCA 环境设置技能 ✓ NVIDIA · 官方 | 57 · 谨慎使用 | ★ 3.8k | 今天 | Apache-2.0 |
| DOCA Telemetry Exporter 开发技能 ✓ NVIDIA · 官方 | 55 · 谨慎使用 | ★ 3.8k | 今天 | Apache-2.0 |
| DOCA 编程指南 ✓ NVIDIA · 官方 | 54 · 谨慎使用 | ★ 3.8k | 今天 | Apache-2.0 |
| DOCA 版本一致性助手 ✓ NVIDIA · 官方 | 53 · 谨慎使用 | ★ 3.8k | 今天 | Apache-2.0 |
它明确将高级 DPA 追踪与原始周期级分析、主机侧 doca-dpa 调试以及 DPA 内核编程区分开来；这些是不同的技能或工具路径。
FollowSkills 如何评估这个 Skill？
文档明确限定为诊断观察工具，要求限制捕获窗口、避免生产持续运行、保留配置与 ELF 校验，并提示 trace 可能包含 RDMA/工作负载敏感信息；未提供具体权限最小化、用户确认、回滚机制或数据脱敏流程，因此扣分。
任务流程、错误分类和异常反馈较完整，且要求以 --help 和实时文档复核版本化参数；但静态审查无法复现关键路径，命令与参数存在依赖外部版本的风险，TASKS.md 末尾还出现不完整条目，因此按静态上限保守扣分。
触发语句、适用场景和明确的排除范围较清楚，覆盖错误结果、延迟、截断和空捕获等问题；但未说明中文交互支持或中国大陆网络可达性，且核心流程依赖 NVIDIA 外部文档、DOCA、BlueField 和 DPACC 环境，因此扣分。
信息架构、加载顺序、依赖、限制、相关技能和维护入口较丰富；但版本、签名和扫描字段仍为 TBD，SKILL.md 的 Apache-2.0 与 SKILLCARD.yaml 的 Apache-2.0 AND CC-BY-4.0 不一致，缺少明确变更记录，且 benchmark 报告指出结构和推荐章节问题，因此扣分。
技能提供从配置、捕获、解码到诊断和交接的直接工作流，核心任务在目标环境中具有明确价值；但没有脚本、样本 trace 或可直接验证的输出，且用户仍需依赖现场二进制 --help 和外部文档，静态校准下不超过 7 分。
文件包含较详细的错误分类、参数说明和 benchmark 声称的结果，但 benchmark 数据集不可用，未提供可独立复现的测试套件或真实 CI 覆盖关键路径，公共来源仅作为指针存在，因此证据可核查性有限。
点击维度查看打分理由
证据充分度：低 — 主要依赖静态检查、作者材料或有限演示；适合发现线索，不适合做高风险决策。
查看完整评分方法 →