这个 Skill 能做什么,适合哪些场景?
该技能面向从主机端使用 DOCA DPA 库的开发者,覆盖 DPA 上下文、应用镜像、线程、内核启动和完成通知等生命周期。它还指导使用 doca_dpa_cap_* 检查硬件与安装版本能力,并分析 doca_dpa_* 返回的 DOCA_ERROR_*。技能提供 configure、build、modify、run、test 和 debug 工作流。它不负责安装 DOCA、编写 DPA 侧内核本身,也不重新定义 DPA-Comms 或 DPA-Verbs 的设备侧编程指南。
指导代理检查 /opt/mellanox/doca 中的库、头文件、样例和应用目录,读取 pkg-config --modversion doca-dpa 及已安装 dpacc 版本;规划创建 doca_dpa Core 上下文、加载 dpacc 生成的 doca_dpa_app 镜像、创建 doca_dpa_thread、通过 doca_dpa_kernel_launch_update_* 启动内核并排空 doca_dpa_completion;使用 doca_dpa_cap_* 查询能力,并按层次诊断 DOCA_ERROR_*。
- BlueField 应用开发者需要从主机加载 DPA 应用镜像并启动带参数的 DPA 内核。
- 开发者需要确认当前 BlueField 代际和 DOCA 安装是否暴露所需的 DPA 能力。
- 主机端 launch 调用返回 DOCA_ERROR_NOT_SUPPORTED、DOCA_ERROR_DRIVER 或其他 doca_dpa 错误,需要定位故障层。
- 开发者需要让 DPA 内核中的线程通过 DPA-Comms 进行同一处理器上的消息协调。
- 开发者需要评估是否可在 DPA 内核中通过 DPA-Verbs 直接执行远程 RDMA。
如何安装这个 Skill?
- 不要把该技能当作已验证的可运行实现;必须在目标 BlueField 上独立确认 DOCA、DPACC、硬件能力和 API 语义。
- SKILL.md 对 DPA-side comms/verbs 编程的范围相互矛盾,调用前应明确路由到对应公共指南。
- BENCHMARK.md、SKILLCARD.yaml 和 SKILL.md 的仓库路径、许可证和评测元数据不一致;不要把评测 PASS 当作本次修订的独立证明。
- 运行涉及真实硬件和异步内核;应先执行低风险 smoke test,并准备停止、清理和失败恢复步骤。
- Shell / 命令行
- 本地文件系统
DOCA SDK at /opt/mellanox/docaBlueField DPU with a host-visible DPA processorMatching DPACC compilerLinux: Ubuntu 22.04/24.04, RHEL, or SLES
使用仓库 README 支持的 Skills CLI 安装:
npx skills add nvidia/skills --skill doca-dpa --yes
也可指定 Codex:
npx skills add nvidia/skills --skill doca-dpa --agent codex --yes
源材料未说明该命令具体将目录安装到哪个本地路径;CLI 会提示或按目标代理处理安装位置。
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/NVIDIA/skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/doca-dpa" ~/.claude/skills/
rm -rf "$tmp"根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。
如何使用这个 Skill?
安装后,把下面任意一句发给 Agent 即可触发:
- 从主机程序加载 dpacc 生成的 DPA 镜像,启动带缓冲区和长度参数的内核,并诊断没有 completion 的情况。
让代理提出具体的主机端 DOCA DPA 任务,例如:"从主机程序加载 dpacc 生成的 DPA 镜像,启动带缓冲区和长度参数的内核,并诊断没有 completion 的情况。"
使用时应先确认 DOCA 已安装在 /opt/mellanox/doca、BlueField 的 DPA 对主机可见,并且 DOCA 与 DPACC 版本符合兼容策略。需要执行任务时查看 TASKS.md;需要能力矩阵、版本、错误分类或安全前置条件时查看 CAPABILITIES.md。
这个 Skill 有哪些优点和局限?
- 覆盖主机端 DPA 生命周期和六类常见工程工作流。
- 明确区分 BlueField 硬件能力、DOCA 安装能力及 DOCA/DPACC 版本匹配。
- 覆盖 DPA-Comms、DPA-Verbs 与 host-side doca-comch、doca-rdma 的边界。
- 支持以 C、C++ 或其他主机语言编写绑定,只要 DPA 镜像由 dpacc 单独构建。
- 要求已有 DOCA SDK、匹配的 DPACC 编译器和具备 DPA 的 BlueField 环境。
- 不提供可直接构建的样例源码、构建清单、bindings 或 reference 子目录。
- 不覆盖安装 DOCA、DPACC 内部机制或 DPA 侧内核编写的完整指南。
- 源材料没有提供测试平台矩阵或该单项技能的独立测试结果。
这个 Skill 与同类方案有什么区别?
与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| DOCA DPA 主机端开发助手 本页 ✓ NVIDIA · 官方 | 48 · 谨慎使用 | ★ 3.8k | 今天 | Apache-2.0 |
| DOCA PCC 自定义拥塞控制 ✓ NVIDIA · 官方 | 51 · 谨慎使用 | ★ 3.8k | 今天 | Apache-2.0 |
| DOCA RDMA Initiator ✓ NVIDIA · 官方 | 57 · 谨慎使用 | ★ 3.8k | 今天 | Apache-2.0 |
| DOCA Flow DPA Provider 技能 ✓ NVIDIA · 官方 | 53 · 谨慎使用 | ★ 3.8k | 今天 | Apache-2.0 |
| DOCA Compress 硬件压缩开发技能 ✓ NVIDIA · 官方 | 58 · 推荐 | ★ 3.8k | 今天 | Apache-2.0 |
它不是 doca-setup 的替代品:DOCA 或 DPACC 尚未安装时应先走安装路径。它也不是 DPA 侧内核、DPA-Comms 或 DPA-Verbs 的完整编程指南;这些内容应转到 doca-public-knowledge-map 指向的公共 DOCA 指南。
FollowSkills 如何评估这个 Skill?
文档明确限定主机侧范围、版本检查、能力发现、错误分层和反 partial-rebuild 规则,也未要求凭据或秘密;但未系统说明命令的权限边界、硬件操作确认、敏感数据处理、回滚方案或失败后的恢复流程,因此扣分。
TASKS.md 和 CAPABILITIES.md 提供了较完整的配置、构建、运行、测试和调试路径,并说明 PE progress、completion 和版本偏差等失败原因;但静态审查无法复现关键路径,且文档存在范围表述冲突和若干绝对化错误归因,因此按静态上限保守扣分。
受众、输入环境、触发短语和多个越界路由定义清楚,并说明 BlueField、DOCA、DPACC 依赖;但 Linux、标准安装路径、特定硬件和英文 API 生态限制明显,中文支持未体现,且 DPA-side 编程是否纳入范围存在冲突,因此扣分。
文档分层良好,SKILL.md、CAPABILITIES.md、TASKS.md、评测和相关技能链接齐全,且有 Apache-2.0 前置声明;但版本、变更记录、维护责任和发布元数据不一致,作者字段缺失,基准报告还包含路径和许可证不一致,故扣分。
该技能能直接提供 host-side DPA 生命周期、能力检查、错误排查和路由指导,核心任务覆盖较完整;但不提供可运行样例或模板,依赖用户本地 DOCA/DPACC 安装和其他技能,静态材料也没有可独立验证的代表性输出,因此未超过静态上限并扣分。
文件包含结构化工作流、符号名、评测摘要和外部参考入口,具备一定审计性;但评测数据集不可用,未执行测试,报告中的路径和元数据互相矛盾,也没有多来源或独立复现证据,因此仅给低分。
点击维度查看打分理由
证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。
查看完整评分方法 →