这个 Skill 能做什么,适合哪些场景?
这是一个面向 DOCA 应用开发者的 Agent Skill,专注于 DOCA Arg Parser 的实际 CLI 工作。它指导用户添加、删除或重命名参数,按正确顺序接入 Arg Parser 生命周期,并使用标准 DOCA 选项和 JSON 配置。技能还覆盖参数类型选择、版本检测及常见 DOCA_ERROR 错误排查。它要求本机已安装 DOCA SDK,因此不适合用于 DOCA 安装或一般 DOCA 介绍。
指导代理读取本地 DOCA 安装,通过 pkg-config doca-argp 检测 Arg Parser,并检查 /opt/mellanox/doca/{lib,include,samples,applications}。它帮助用户在应用中按 doca_argp_init、注册参数、doca_argp_start、doca_argp_destroy 的顺序接入库,选择六种公开参数类型,维护 --device、--representor、--rep-list、--json、--sdk-log-level 等标准选项,并诊断 BAD_STATE、INVALID_VALUE、NOT_SUPPORTED 和 IO_FAILED。
- 正在修改 DOCA 样例的开发者,需要添加自定义 CLI 参数并保留标准设备选项。
- 编写 DOCA 应用的 C/C++ 开发者,需要正确安排 Arg Parser 初始化、注册、解析和清理流程。
- 希望用 `--json <path>` 驱动复杂配置、减少长命令行输入的应用维护者。
- 遇到参数类型不匹配、未知 JSON 键或 Arg Parser 生命周期错误的 DOCA 调试人员。
- 为 Rust、Go 或 Python FFI 封装 DOCA Arg Parser C ABI 的开发者。
如何安装这个 Skill?
- 未执行任何命令;不能据此确认 DOCA API、错误映射或工作流在目标版本上可运行。
- 参数类型说明存在文档间不一致,实施前应以本地安装的 doca_argp.h 和 pkg-config 结果为准。
- 技能涉及 DOCA 设备环境,但没有充分说明用户确认、回滚和硬件影响边界。
- 对中国大陆网络可达性没有明确保证;核心参考资料可能依赖海外服务。
- Shell / 命令行
- 本地文件系统
DOCA SDK installed at /opt/mellanox/docaLinux with Ubuntu 22.04/24.04 or RHEL/SLESBlueField DPU or ConnectX NICpkg-config
使用仓库 README 支持的 skills CLI 安装指定技能:npx skills add nvidia/skills --skill doca-argp --yes。CLI 会提示安装位置;无需克隆仓库或手动复制目录。安装前应确认目标 Linux 主机已在 /opt/mellanox/doca 安装 DOCA SDK,并连接 BlueField DPU 或 ConnectX NIC。
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/NVIDIA/skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/doca-argp" ~/.claude/skills/
rm -rf "$tmp"根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。
如何使用这个 Skill?
安装后,在相关任务中直接触发技能,例如:add a custom flag to a DOCA sample while preserving --device and --sdk-log-level。也可以询问 BAD_STATE registering a new param、my JSON config key is rejected 或 my sample's --json is ignored。具体的 configure、build、modify、run、test、debug 步骤位于技能引用的 TASKS.md;参数能力和错误分类位于 CAPABILITIES.md。
这个 Skill 有哪些优点和局限?
- 覆盖 DOCA Arg Parser 的参数注册、生命周期、标准 CLI、JSON 配置和错误分类。
- 明确区分六种公开参数类型,并强调注册参数必须早于 `doca_argp_start`。
- 可为 C/C++ 以及通过 FFI 使用同一 C ABI 的其他语言提供语言无关的规则。
- 明确划定范围,能够将 DOCA 安装、DOCA Core、日志内部机制及变长参数等问题转交其他技能。
- 要求 DOCA SDK 已安装在标准路径,并要求特定 Linux 平台及 NVIDIA 硬件。
- 技能本身不提供预写代码、独立构建清单、samples、bindings 或 reference 子树。
- 给定材料未提供 `TASKS.md`、`CAPABILITIES.md` 的具体内容,因此完整操作步骤和测试证据不可直接评估。
- 不覆盖 DOCA 安装、子命令、变长参数、Shell 补全、DOCA Core context 或 DOCA Log internals。
这个 Skill 与同类方案有什么区别?
与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| DOCA Arg Parser CLI 技能 本页 ✓ NVIDIA · 官方 | 55 · 谨慎使用 | ★ 3.8k | 今天 | Apache-2.0 |
| DOCA DMA 编程助手 ✓ NVIDIA · 官方 | 54 · 谨慎使用 | ★ 3.8k | 今天 | Apache-2.0 |
| DOCA AES-GCM 加速开发技能 ✓ NVIDIA · 官方 | 57 · 谨慎使用 | ★ 3.8k | 今天 | Apache-2.0 |
| DOCA Telemetry Exporter 开发技能 ✓ NVIDIA · 官方 | 55 · 谨慎使用 | ★ 3.8k | 今天 | Apache-2.0 |
| DOCA 擦除编码开发技能 ✓ NVIDIA · 官方 | 49 · 谨慎使用 | ★ 3.8k | 今天 | Apache-2.0 |
与 getopt、argparse 或自定义解析相比,该技能明确建议 DOCA-using 应用复用 DOCA Arg Parser,以保留标准 DOCA CLI 表面;但它没有提供这些替代方案的详细实现或性能比较。
FollowSkills 如何评估这个 Skill?
文档明确限定本地 DOCA 安装、声明无需凭据,并主要建议读取安装信息和先检查再修改;但缺少统一的用户确认、变更回滚、硬件影响确认和完整数据流说明,因此扣分。
生命周期、错误分类、失败排查和测试步骤写得较完整;但 SKILL.md、CAPABILITIES.md 与 TASKS.md 对参数类型范围的表述不完全一致,且未执行验证,静态证据不足,因此扣分。
受众、触发短语、适用场景和拒绝范围清楚;但依赖 Linux、已安装 DOCA、BlueField 或 ConnectX,且文档依赖的 NVIDIA 海外资料对中国大陆可达性未说明,因此扣分。
采用 SKILL.md、CAPABILITIES.md、TASKS.md 分层,并提供相关技能路由、许可证和维护入口;但版本、变更记录、作者责任和发布元数据不完整,SKILLCARD 中还存在 TBD 字段及许可证不一致,因此扣分。
围绕添加参数、生命周期、JSON 配置和错误诊断提供了可直接采用的流程;但不含可运行代码或模板,实际结果仍依赖用户本地硬件和安装,BENCHMARK.md 也未提供可复核数据集,因此扣分。
文档包含命令、错误映射、评估文件和基准摘要,具备有限审计线索;但没有执行本身、第三方复核或覆盖关键路径的 CI 测试证据,基准数据集不可用,因此扣分。
点击维度查看打分理由
证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。
查看完整评分方法 →