DOCA Arg Parser CLI 技能
帮助开发者为 DOCA 应用构建和调试标准命令行界面。
文档明确限定本地 DOCA 安装、声明无需凭据，并主要建议读取安装信息和先检查再修改；但缺少统一的用户确认、变更回滚、硬件影响确认和完整数据流说明，因此扣分。
生命周期、错误分类、失败排查和测试步骤写得较完整；但 SKILL.md、CAPABILITIES.md 与 TASKS.md 对参数类型范围的表述不完全一致，且未执行验证，静态证据不足，因此扣分。
受众、触发短语、适用场景和拒绝范围清楚；但依赖 Linux、已安装 DOCA、BlueField 或 ConnectX，且文档依赖的 NVIDIA 海外资料对中国大陆可达性未说明，因此扣分。
采用 SKILL.md、CAPABILITIES.md、TASKS.md 分层，并提供相关技能路由、许可证和维护入口；但版本、变更记录、作者责任和发布元数据不完整，SKILLCARD 中还存在 TBD 字段及许可证不一致，因此扣分。
围绕添加参数、生命周期、JSON 配置和错误诊断提供了可直接采用的流程；但不含可运行代码或模板，实际结果仍依赖用户本地硬件和安装，BENCHMARK.md 也未提供可复核数据集，因此扣分。
文档包含命令、错误映射、评估文件和基准摘要，具备有限审计线索；但没有执行本身、第三方复核或覆盖关键路径的 CI 测试证据，基准数据集不可用，因此扣分。
- 未执行任何命令；不能据此确认 DOCA API、错误映射或工作流在目标版本上可运行。
- 参数类型说明存在文档间不一致，实施前应以本地安装的 doca_argp.h 和 pkg-config 结果为准。
- 技能涉及 DOCA 设备环境，但没有充分说明用户确认、回滚和硬件影响边界。
- 对中国大陆网络可达性没有明确保证；核心参考资料可能依赖海外服务。
这个 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 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？
使用仓库 README 支持的 skills CLI 安装指定技能：npx skills add nvidia/skills --skill doca-argp --yes。CLI 会提示安装位置；无需克隆仓库或手动复制目录。安装前应确认目标 Linux 主机已在 /opt/mellanox/doca 安装 DOCA SDK，并连接 BlueField DPU 或 ConnectX NIC。
如何使用这个 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 与同类方案有什么区别？
与 getopt、argparse 或自定义解析相比，该技能明确建议 DOCA-using 应用复用 DOCA Arg Parser，以保留标准 DOCA CLI 表面；但它没有提供这些替代方案的详细实现或性能比较。