DOCA 环境设置技能
帮助开发者验证、配置和排查 DOCA 开发与运行环境，并选择合适的部署路径。
文档明确要求最小权限、用户确认、避免自动重启、披露全局 hugepages/eswitch/安装变更影响，并禁止 --privileged 绕过；但仍提供 sudo、全局状态修改和外部 NGC 路径，回滚步骤不完整，且 SKILL.md 的 Apache-2.0 与 skill-card 的 Apache 2.0 AND CC-BY-4.0 存在元数据不一致，因此扣分。
分层的 recognize→configure→test→debug 流程、停止条件和错误分类较完整；但仅静态阅读，未执行关键命令，部分内容依赖大量未提供的其他技能，且基准报告缺少原始数据，因此按静态上限保守扣分。
触发条件、适用场景和明确的非适用范围清楚，并覆盖主机、DPU、容器和裸机形态；但未提供中文交互支持，也未评估 NGC/Docker 等海外服务在中国大陆网络中的可达性，因此扣分。
信息架构、渐进式加载、依赖说明、示例问题、限制和责任归属较充分；但缺少清晰的版本变更记录和维护更新路径，BENCHMARK 还记录了缺少 Instructions/Examples/Author 及非标准文件的问题，且许可证声明不一致。
技能为安装验证、环境准备、故障分层和部署路径选择提供了可直接采用的命令与路由规则，核心任务价值明确；但它是薄 loader，关键结果依赖其他技能和现场环境，静态审查无法证明命令实际完成任务，因此不超过静态上限。
包含可审计的命令、路径、交叉引用、公开文档链接和一份基准报告；但基准数据集不可用、没有可核验的提交测试覆盖关键路径，也未进行本次执行复现，因此仅给有限分数。
- 建议统一许可证和版本信息，并补充作者、变更记录、维护入口及可执行测试。
- 涉及 hugepages、switchdev、mlxconfig、安装和重启的建议必须在明确确认、记录当前状态并提供回滚方案后执行。
- NGC/Docker 路径依赖外部服务；应在中国大陆网络环境中单独验证可达性，并准备本地或镜像替代方案。
- 不要将 benchmark 报告中的百分比视为本次静态审查已复现的测试证据。
这个 Skill 能做什么，适合哪些场景？
这是一个面向 NVIDIA DOCA 环境工作的 Agent Skill，覆盖安装健康检查、构建环境准备、运行时前置条件和环境类故障诊断。它处理 pkg-config、头文件、库路径、hugepages、devlink、representor 等环境问题，也能为尚未安装 DOCA 的用户引导至 NGC DOCA 容器。部署问题会先判断主机、BlueField 和硬件状态，再转向容器或裸机部署技能。它不负责 DOCA 库 API、示例程序改造、程序构建细节或 DOCA_ERROR_* 程序级调试。
读取 SKILL.md 及其 TASKS.md、CAPABILITIES.md 伴随文件，按问题类型将请求分类为环境、部署、编程或知识路由问题；在具备目标主机命令通道时指导用户检查 DOCA 安装、pkg-config、头文件、库路径、hugepages、devlink、representor 和内核模块前置条件；根据系统形态路由到容器部署、裸机部署或无安装环境流程；对环境变更应用验证和安全约束，并要求返回目标主机的准确命令输出。
- 拥有 BlueField 或 DOCA 工作负载、但不确定应采用容器还是裸机部署的开发者。
- DOCA 已安装，但需要确认 DOCA Flow、pkg-config、头文件和运行库是否可用的工程师。
- 构建环境无法找到 doca-*.pc 文件、头文件或运行库的开发者。
- 在真实 DPU 主机上运行程序前，需要检查 hugepages、devlink 和 representor 的用户。
- 使用 macOS、Windows 或未安装 DOCA 的 Linux 主机，想通过 NGC 容器学习或构建 DOCA 的用户。
这个 Skill 有哪些优点和局限？
- 覆盖 DOCA 安装、构建和运行时环境的完整排查链路。
- 明确区分容器、裸机和无硬件学习路径，减少错误路由。
- 包含对 hugepages、eswitch 模式、mlxconfig 和硬件变更的安全约束。
- 对没有 DOCA 安装的主机提供 NGC DOCA 容器 Stage-1 路径。
- 它是薄加载器，实质内容依赖 TASKS.md 和 CAPABILITIES.md 等伴随文件。
- 真实硬件验证要求目标主机命令通道或用户提供准确输出，不能仅凭本地环境推断。
- 不处理 Flow、RDMA 等库 API，也不负责程序级构建、示例改造或 DOCA_ERROR_* 调试。
- 提供的源材料没有展示具体验证命令、测试套件或平台覆盖结果。
如何安装这个 Skill？
使用 NVIDIA 技能集合的 CLI 安装指定技能：npx skills add nvidia/skills --skill doca-setup --yes。README 未要求克隆仓库或手工复制技能目录；安装目标由 CLI 处理。
如何使用这个 Skill？
安装后，在相关任务中触发技能，例如：“我刚拿到一台 BlueField，下一步怎么做？”、“DOCA Flow 在这台机器上是否可用？”或“pkg-config 找不到 doca-flow，缺什么？”技能会先区分环境、部署和编程问题，再执行或指导相应的检查与路由。目标主机命令通道不能假定存在；如无通道，应让用户运行命令并返回原始输出。