DOCA DPA 高级追踪器
捕获并解码 BlueField DPA 编程事件，定位内核行为、通信延迟与追踪异常。
文档明确限定为诊断观察工具，要求限制捕获窗口、避免生产持续运行、保留配置与 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 覆盖关键路径，公共来源仅作为指针存在，因此证据可核查性有限。
- 不要把 benchmark 的 PASS 或品牌 provenance 当作可靠性、有效性或安全性的独立证明；报告明确称原始评测数据集不可用。
- 执行前必须核对已安装版本的 --help、权限、模式令牌、JSON 键和 ELF 匹配关系；trace 文件可能包含敏感工作负载信息。
- 应解决 SKILL.md 与 SKILLCARD.yaml 的许可证元数据不一致，并补充版本、变更记录和可复现测试覆盖。
这个 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 有哪些优点和局限？
- 针对 DPA 编程事件提供清晰的捕获、解码和排障流程。
- 覆盖 TRACE/CRIT 的细节与观测开销权衡。
- 明确区分 DPA 侧追踪、主机侧 doca-dpa 控制和原始周期分析。
- 涵盖文件限制、捕获窗口、ELF 匹配和版本兼容性等常见失败点。
- 依赖已安装的 DOCA SDK、DOCA DPA Tools、BlueField DPA 和正在运行的工作负载。
- 技能本身不包含示例 trace、解析器、包装脚本或 samples/reference 子树。
- 提供的材料没有完整 JSON 配置、解码命令或全部事件名称；需依赖安装版本的 --help 和公共文档。
- 追踪是有边界的调试手段，不应作为生产观测方案。
如何安装这个 Skill？
使用 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 工作负载。
如何使用这个 Skill？
先确认问题属于 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 追踪与原始周期级分析、主机侧 doca-dpa 调试以及 DPA 内核编程区分开来；这些是不同的技能或工具路径。