DOCA 能力探测器
以只读方式检查 DOCA 在当前主机上发现的设备、库和硬件能力。
文档明确将 doca_caps 限定为只读、无持久副作用，并要求不要修改二进制、不要臆造参数；数据流主要是读取本机硬件和安装信息，未要求凭据。扣分在于设备枚举可能需要安装配置所要求的权限，未定义用户确认、输出中 PCIe/网络标识的敏感数据处理、回滚机制；SKILLCARD、仓库许可证和题给 license metadata（NOASSERTION）之间也存在归属与许可证不一致。
SKILL.md、CAPABILITIES.md 和 TASKS.md 对安装缺失、PATH、版本、权限、驱动、空输出和退出码提供了较细的诊断路径，并强调以已安装 --help 为准。扣分在于没有提交测试套件或可复现的关键路径，部分命令和行为依赖未提供的 DOCA 安装、公共指南及其他技能；基于静态审查，按校准不超过 10 分。
触发条件、适用用户、五类能力查询、非适用范围和路由关系描述清楚，且支持 Ubuntu、RHEL、SLES、x86/Arm 主机及 BlueField 场景。扣分在于核心功能完全依赖 Linux、DOCA SDK、特定硬件和本机二进制；未说明中文交互支持，也未提供中国大陆网络可达性证据，公共 NGC/文档依赖可能造成环境限制。
文档结构清晰，采用 SKILL.md、CAPABILITIES.md、TASKS.md 分层，并提供示例问题、任务动词、错误分类、相关技能、维护入口和版本边界。扣分在于 SKILL.md 的许可证为 Apache-2.0，而 SKILLCARD 标为 Apache-2.0 AND CC-BY-4.0；版本仍为 TBD-at-sign-time，签名和扫描信息为占位符；BENCHMARK.md 记录了发现项，且未明确本技能的直接维护责任和变更日志。
该技能对“读取 DOCA 设备、代表器、库和能力并保存快照”的核心任务给出了直接命令和路由规则，且输出应来自真实主机而非固定样例。扣分在于没有随技能提供可执行封装、结构化输出或样例结果，最终结果依赖用户环境和外部文档；BENCHMARK.md 声称有效性较高但未提供评测数据集，因此静态证据不足，按校准不超过 7 分。
源文件包含命令、错误分类、版本约束、任务评测文件和一份基准报告，提供了一定审计线索。扣分在于公共指南、CI、测试套件和评测数据集未在本次材料中提供，基准报告无法独立复核，SKILLCARD 的签名、扫描运行 ID 和版本字段仍是 TBD；因此只能给予有限静态可验证性。
- 执行前确认目标主机、DOCA 版本和所需权限；该技能虽声明只读，但设备与网络标识可能出现在未脱敏快照中。
- 不要把空输出自动解释为硬件不支持；应结合退出码、驱动、容器设备映射、版本和 PCIe 范围，并以已安装 --help 和实际工具输出为准。
- 核对实际发布包的许可证、来源仓库、版本签名和维护入口；当前 SKILL.md、SKILLCARD、仓库许可证及题给 metadata 不完全一致。
- 核心命令依赖 Linux、DOCA SDK、BlueField/ConnectX 硬件和本地安装；中文支持及中国大陆网络可达性未被材料证明。
这个 Skill 能做什么，适合哪些场景？
doca-caps 是一个用于调用 NVIDIA doca_caps 命令行工具的 Agent Skill。它帮助用户枚举 DOCA 设备、PCIe 地址和 representor，检查操作系统可用的 DOCA 库，并查询特定设备和库的能力。该工具也可生成无副作用的能力快照，用于安装冒烟测试或调试。它不负责 DOCA 安装、库内部能力矩阵、遥测或修改二进制。
在已安装 DOCA 的 Linux 主机或公共 NGC DOCA 容器中调用 /opt/mellanox/doca/tools/doca_caps，读取 pkg-config doca-common 以确认安装，并执行设备、representor、库、库能力和日志器相关查询；可按 PCIe 地址限定结果，也可保存能力快照。
- 外部开发者安装 DOCA 后，想确认 BlueField 或 ConnectX 设备是否被 DOCA 发现。
- 平台运维人员需要列出当前主机可用的 DOCA 库及每个设备支持的能力。
- 开发者想按 PCIe 地址检查某个设备是否支持特定库能力，例如 Flow hairpin。
- 运维人员需要枚举 pf0 的 VF representor。
- 调试或安装冒烟测试需要保存设备、库和能力信息快照。
这个 Skill 有哪些优点和局限？
- 只读、无副作用，适合安装验证和调试前取证。
- 覆盖设备、representor、库、库能力和日志器五类信息。
- 支持按 PCIe 地址限定查询，并可生成能力快照。
- 明确区分硬件可见性查询与 DOCA 安装及库内部能力问题。
- 要求 DOCA SDK 至少为 2.6.0，并安装在固定路径 /opt/mellanox/doca。
- 仅适用于指定的 Linux 发行版及 BlueField DPU 或 ConnectX NIC 环境。
- 提供内容没有包含完整的 TASKS.md、CAPABILITIES.md 或实际输出示例，采用前需要查阅这些伴随文件或实时指南。
- 技能本身不包含脚本、包装器、解析器或 samples/reference 子树。
如何安装这个 Skill？
使用 NVIDIA/skills 集合的 skills CLI 安装：npx skills add nvidia/skills --skill doca-caps --yes。README 未提供将该技能单独复制到指定目录的步骤；安装后，相关 Agent 在加载技能并遇到匹配任务时使用它。
如何使用这个 Skill？
在已满足 DOCA 环境要求的主机上，让 Agent 执行与以下意图相符的请求："检查这台主机上 DOCA 实际看到的设备和库"、"枚举 pf0 的 VF representor" 或 "按 PCIe 地址检查 Flow 能力"。具体 doca_caps 调用和快照流程应按该技能引用的 TASKS.md；提供的材料未包含这些命令的完整参数。