DOCA BlueField-4 部署技能
指导运维人员通过 BMC 完成 BlueField-4 首日装机、固件更新与启动故障排查。
文档明确标示固件烧录、ISO 重刷、断电重启和 BMC 重置的不可逆风险，要求维护窗口、回滚计划、逐步确认、不泄露凭据、使用占位符并验证 OOB 访问；但回滚细节由外部 doca-hardware-safety 承担，最小权限、凭据生命周期、数据流和依赖安全未充分展开，因此扣分。
流程结构一致，包含前置条件、六层故障分类、任务状态、版本和介质状态检查；但关键 Redfish 端点、版本兼容性和具体环境前提依赖外部文档，缺少本技能覆盖的可执行测试与完整异常反馈，静态评估不超过 10 分，故保守给 8 分。
受众、BF4 日一 bring-up 场景、触发短语和 BF3/应用/机群编排等非适用边界描述清楚；但未提供中文使用支持，也未证明大陆网络可达性，且核心流程依赖公开 NVIDIA 下载和文档服务，故扣分。
信息架构、加载顺序、任务动词、相关技能、风险和依赖说明较完整，并有 Apache-2.0 元数据及 NVIDIA 维护归属线索；但缺少作者字段、正式变更日志和清晰更新路径，BENCHMARK 还报告缺少 Instructions/Examples 推荐章节，且 skill-card 的 CC-BY-4.0 表述与 SKILL.md 元数据不完全一致，因此扣分。
文档覆盖三种安装方式、PLDM 更新、cloud-init、验证和分层调试，输出目标明确且具有直接操作价值；但它明确是 thin loader，关键内容依赖 companion files、现场版本和外部公开文档，未提供静态可验证的完整代表性结果或替代方案比较，因此按静态上限保守给 6 分。
存在提交的 benchmark 报告、静态验证发现、评测指标和可追踪的命令/状态检查；但评测数据集不可用，未提供真实 CI 与覆盖关键路径的测试套件，公共标准和文档仅被概述性引用，无法独立复现，故给 4 分。
- 所有固件、重刷、断电和 BMC 重置操作都可能造成设备不可用或变砖；必须先加载 doca-hardware-safety，核对目标版本、OOB 访问、维护窗口和可验证回滚方案，并逐项取得用户确认。
- 不要将占位符、示例 URI、EID、任务 ID 或命令参数直接当作现场值；Redfish、dpu-bmc、固件布局和公开版本要求需依据目标设备的当前文档确认。
- 技能未证明中文体验或大陆网络可达性；依赖 NVIDIA 下载/文档服务时应准备可达性验证和本地合规替代路径。
这个 Skill 能做什么，适合哪些场景？
该技能面向通过 BMC 初始化全新 BlueField-4 DPU 的外部运维人员。它覆盖将 BlueField/DOCA bundle ISO 安装到 Grace、通过 PLDM 更新 BMC、NIC 固件、SBIOS 和 ERoT，以及安装带可选 cloud-init 的 Grace Ubuntu 镜像。支持 UEFI HTTP Boot、PXE Boot 和 Redfish Virtual Media 三种安装方式。涉及固件烧录、ISO 重刷、断电重启和 BMC 出厂重置等可能不可逆的硬件操作，必须配合 doca-hardware-safety、维护窗口、回滚方案和逐项确认。
指导代理通过 UEFI HTTP Boot、PXE Boot 或 Redfish Virtual Media 安装 BlueField/DOCA bundle ISO；通过 Redfish UpdateService multipart endpoint 推送 .fwpkg，并使用 Redfish Task、FirmwareInventory 和 pldmtool 监控及核验 PLDM 固件更新；通过 Redfish Virtual Media 安装 Grace Ubuntu 镜像和可选的 CIDATA cloud-init 配置 ISO；使用 BMC SSH 与 obmc-console-client 访问带外串口控制台；检查 /etc/mlnx-release，并诊断 ISO 启动、虚拟介质、固件任务、激活、cloud-init 和启动循环问题。
- 运维人员拿到一台全新的 BlueField-4，需要通过 BMC 安装 Grace OS。
- 管理员需要在维护窗口内通过 Redfish UpdateService 更新 BMC、NIC 固件、SBIOS 或 ERoT。
- 工程师需要比较 UEFI HTTP Boot、PXE Boot 和 Redfish Virtual Media 的适用场景。
- 运维人员遇到固件 Task 长时间处于 Running、报告 Exception 或待激活镜像未生效。
- 管理员需要通过虚拟介质安装 Grace Ubuntu，并使用 cloud-init 完成初始配置。
- 现场人员需要通过带外串口控制台排查 ISO 无法启动、虚拟介质未挂载或设备陷入启动循环。
这个 Skill 有哪些优点和局限？
- 覆盖 BlueField-4 首日平台 bring-up 的完整主要路径。
- 同时处理 OS 安装、PLDM 固件更新、控制台观测和分层故障诊断。
- 明确区分 BF4 bring-up 与 BF3、应用部署、环境准备和规模化编排。
- 对可能造成设备损坏或中断的操作设置逐项确认和安全边界。
- 只面向 BlueField-4，不覆盖 BlueField-3。
- 不负责已运行 BlueField 上的应用启动、DOCA 工具安装或库 API 使用。
- 要求用户已有可访问的 BMC、镜像、HTTP/HTTPS 托管服务及目标版本信息。
- SKILL.md 本身是薄加载器，主要内容依赖同目录的 CAPABILITIES.md、TASKS.md 和 references/details.md。
- 来源材料未提供具体硬件平台测试矩阵或独立测试套件证据。
如何安装这个 Skill？
使用仓库 README 中的 skills CLI 安装指定技能：
npx skills add nvidia/skills --skill doca-bf4-deployment --yes
README 未说明该技能的其他专用安装方式。安装后，代理在加载技能并遇到相关任务时使用它；不需要手动克隆仓库或复制技能目录。
如何使用这个 Skill？
安装后，可使用类似“通过 BMC 启动一台新的 BlueField-4”“BlueField ISO 无法通过 BMC 的 HTTP Boot 启动”“通过 Redfish 挂载 BF4 虚拟介质”或“BF4 固件 Task 一直处于 Running”的请求触发。处理任何 PLDM 烧录、ISO 重刷、断电重启或 BMC 出厂重置前，必须同时加载 doca-hardware-safety，展示确切命令及影响范围，并取得该项操作的明确确认。具体 bring-up 合同见 CAPABILITIES.md，逐步流程见 TASKS.md。
这个 Skill 与同类方案有什么区别？
技能明确比较并覆盖三种安装方法：推荐的 UEFI HTTP Boot、PXE Boot 和 Redfish Virtual Media；不提供与其他厂商或非 NVIDIA 工具的比较。