这个 Skill 能做什么,适合哪些场景?
这是面向外部开发者的 DOCA Erasure Coding 编程指导技能,适用于 BlueField DPU、ConnectX NIC 或主机上的实际开发。它覆盖 N 个数据块加 K 个冗余块模型,以及 create、recover、update 三类任务。技能帮助用户查询设备能力、配置矩阵和块大小、设置 mmap 权限,并诊断 DOCA_ERROR_* 返回值。它要求本地已安装 DOCA SDK,不负责安装 DOCA,也不提供可直接构建的应用源码。
引导代理读取 TASKS.md 和 CAPABILITIES.md,检查本地 DOCA 安装、pkg-config 模块和 /opt/mellanox/doca 下的库、头文件、样例及应用。它指导调用 doca_ec_cap_* 查询任务支持、最大块大小和最大缓冲区列表长度,并通过 doca_ec_matrix_create() 检查矩阵构造是否成功。它还指导配置 doca_ec 上下文、create/recover/update 任务、doca_mmap 源和目标权限,运行已安装的 C 样例,执行已知向量恢复验证,并按生命周期、参数、矩阵、权限和队列压力分层排查错误。
- 分布式存储开发者要用 N 个数据块和 K 个冗余块构建 RAID-6 风格或对象存储容错布局。
- BlueField 或 ConnectX 开发者需要确认设备是否支持指定任务、矩阵、N+K 上限和块大小。
- 存储系统中单个数据块变化,开发者希望用 update 增量刷新冗余,而不是重新编码全部数据。
- 磁盘或块丢失后,开发者需要验证最多 K 个缺失块能否通过 recover 重建。
- C/C++ 或 FFI 绑定开发者需要确认 DOCA EC 生命周期、能力发现、mmap 权限和错误处理规则。
如何安装这个 Skill?
- 不要把 BENCHMARK.md 的通过结论视为独立复现;其数据集未随材料提供。
- 修复 TASKS.md 中 `_get_max_num_blocks` 与真实能力查询符号不一致的问题,并核对所有 DOCA API 断言。
- 执行前应明确用户授权、设备范围、存储数据范围、失败恢复和不可恢复数据损失处理。
- 统一 SKILL.md、SKILLCARD.yaml、skill-card.md 与发布元数据中的仓库路径、许可证和版本签名。
- Shell / 命令行
- 本地文件系统
DOCA SDK at /opt/mellanox/docaLinuxBlueField DPU or ConnectX NICpkg-confignpx skills CLI for installation
使用 NVIDIA/skills 集合中的 skills CLI 安装:
npx skills add nvidia/skills --skill doca-erasure-coding --yes
也可以安装整个集合:
npx skills add nvidia/skills
安装后,代理在遇到相关任务时加载该技能。源材料没有说明 DOCA SDK 的具体安装命令;它要求 SDK 已位于 /opt/mellanox/doca。
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/NVIDIA/skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/doca-erasure-coding" ~/.claude/skills/
rm -rf "$tmp"根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。
如何使用这个 Skill?
安装后,把下面任意一句发给 Agent 即可触发:
- 在 BlueField 上配置 doca_ec_task_update,为一个发生变化的数据块刷新 parity,并检查设备能力和 mmap 权限。
安装后,可用类似以下提示触发:"在 BlueField 上配置 doca_ec_task_update,为一个发生变化的数据块刷新 parity,并检查设备能力和 mmap 权限。"
对于具体工作流,技能要求进一步查看 TASKS.md;对于能力、权限、错误分类和路径选择,查看 CAPABILITIES.md。提供的源材料未包含这两个伴随文件的具体步骤,因此不能据此补充完整构建或运行命令。
这个 Skill 有哪些优点和局限?
- 针对 DOCA Erasure Coding 的 create、recover、update 生命周期提供明确路由。
- 覆盖能力查询、矩阵选择、N+K 和块大小限制、mmap 权限及 DOCA_ERROR_* 调试。
- 明确区分擦除编码、复制、网络 FEC 和其他 DOCA 加速库,适合分布式存储场景。
- 支持通过公共 C ABI 指导 C/C++ 及其他语言的 FFI 使用。
- 必须预先安装 DOCA SDK,并具备 BlueField DPU 或 ConnectX NIC;技能不负责安装。
- SKILL.md 本身是薄加载器,关键操作细节位于未提供的 TASKS.md 和 CAPABILITIES.md。
- 不包含预写 EC 应用源码、独立构建清单、绑定、样例子树或预计算 parity 表。
- 源材料没有证明具体 DOCA 版本、硬件型号或非 C 绑定已经实际测试。
这个 Skill 与同类方案有什么区别?
与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| DOCA 擦除编码开发技能 本页 ✓ NVIDIA · 官方 | 49 · 谨慎使用 | ★ 3.6k | 13 天前 | Apache-2.0 |
| DOCA AES-GCM 加速开发技能 ✓ NVIDIA · 官方 | 57 · 谨慎使用 | ★ 3.6k | 13 天前 | Apache-2.0 |
| DOCA Compress 硬件压缩开发技能 ✓ NVIDIA · 官方 | 58 · 推荐 | ★ 3.6k | 13 天前 | Apache-2.0 |
| DOCA SHA 加速开发技能 ✓ NVIDIA · 官方 | 56 · 谨慎使用 | ★ 3.6k | 13 天前 | Apache-2.0 |
| DOCA Arg Parser CLI 技能 ✓ NVIDIA · 官方 | 55 · 谨慎使用 | ★ 3.6k | 13 天前 | Apache-2.0 |
它将 DOCA Erasure Coding 与 CPU 擦除编码库、纯复制、磁盘 RAID-6、网络 FEC 以及其他 DOCA 库区分开来:DOCA EC 面向存储容错;复制适合保留多个完整副本;网络 FEC 和非 Reed-Solomon 编码不属于本技能范围。
FollowSkills 如何评估这个 Skill?
证据显示该技能限定为本地 DOCA 环境,要求能力查询、源/目标 mmap 权限、用户确认参数,并明确不处理密钥或秘密;但执行会接触硬件、设备和用户存储数据,缺少完整的最小权限模型、明确的执行前同意边界、通用回滚方案和数据流说明,因此扣分。
文档覆盖配置、构建、运行、测试和错误分类,且提供已知向量 smoke 流程;但静态材料未包含可核验的关键路径测试套件,存在将不存在的 `_get_max_num_blocks` 写入测试步骤等自相矛盾,且部分 API/硬件断言无法在文件内复现,因此受静态上限限制并扣分。
受众、触发短语、适用的存储场景和非适用的网络 FEC、复制及非 Reed-Solomon 方案定义清楚;但没有中文交互或本地化指导,语言支持边界主要依赖代理推断,环境适配证据有限,因此扣分。
SKILL.md、CAPABILITIES.md、TASKS.md 分层明确,包含安装前提、参数、示例问题、限制、相关技能、维护入口和 benchmark;但版本、签名和扫描字段仍为 TBD,技能卡与提示中的仓库、路径和许可证元数据不一致,且 benchmark 自称存在若干结构规范缺陷,因此扣分。
内容能直接指导能力发现、create/recover/update 选择、权限排查和 smoke 测试,benchmark 也报告了较高的技能辅助效果;但它是薄加载器,不提供可直接构建的代码或模板,修改流程还依赖用户本地样例并注明 renderer 尚未提供,输出仍需较多人工核验,因此未给满分。
材料包含评估报告、评估任务和技能卡中的质量声明,提供了一定审计线索;但评估数据集不可用,未提供覆盖关键路径的可复现 CI 与测试证据,且核心技术结论主要由技能文本自身陈述,因此仅给有限分数。
点击维度查看打分理由
证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。
查看完整评分方法 →