DOCA 版本一致性助手
帮助验证 DOCA 版本来源、主机与 BlueField 的一致性，并诊断构建与运行时版本漂移。
内容强调版本探测、避免凭记忆编造版本、区分主机与运行时来源，并将安装、固件刷写等高影响操作路由到其他技能；但没有系统性的用户确认、权限边界、回滚流程或敏感数据处理说明，且包含可能改变系统状态的 apt 建议，因此扣分。
检测链、四路匹配规则、异常分类和失败后的路由较清晰，脚本与说明总体一致；但本次仅静态阅读，未执行关键命令，且对不同 DOCA 版本、发行版和工具路径的适配仍依赖环境，按静态上限扣分。
目标用户、触发短语、适用范围和转交边界定义较明确，覆盖 BlueField、主机和 NGC 场景；但中文支持、境内网络可达性和非标准安装环境未充分说明，且许多流程依赖 NVIDIA 文档、仓库或目标主机。
文档分为加载器、能力说明、任务流程、评测和卡片，具备渐进式披露、依赖说明、限制和维护线索；但 SKILL.md 缺少作者、推荐的 Instructions/Examples 章节，版本与许可证信息在 SKILL.md、skill-card.md 和仓库元数据之间不完全一致，更新路径也不够明确。
对于检测安装版本、识别构建运行时漂移和指导后续路由，内容提供了可直接执行的命令序列和诊断分支；但输出仍依赖用户现场执行和补充文件，版本矩阵数据未完整提供，静态审查无法验证实际结果，因此按上限给分。
有提交内的任务评测记录、样例断言、命令和 NVIDIA 文档引用，提供一定可审计性；但评测数据集不可用，没有本次审查中的执行复现，也缺乏独立的 CI/测试证据，因此未达到更高等级。
- 不要把技能文本中的版本、包名或工具路径直接当作目标主机事实；应先让用户执行并提供检测链输出。
- 在执行任何 apt 安装或升级前，应确认仓库来源、候选版本、操作权限、用户同意和可恢复方案；技能本身未完整定义这些控制。
- 评测报告称数据集不可用，且本次未执行命令，不能将其结果视为独立运行验证。
- 核心引用和部分能力依赖 NVIDIA 海外文档、仓库或 NGC；应确认中国大陆网络可达性及离线替代方案。
这个 Skill 能做什么，适合哪些场景？
这是 NVIDIA skills 仓库中的一个 DOCA 版本处理技能，专门覆盖版本检测、四方匹配、NGC 容器标签语义和版本相关故障诊断。它指导智能体核对主机安装、应用版本、DOCA 能力工具和 BlueField 发布版本。它也支持判断某项能力是否出现在已安装版本中，以及检查 apt 源是否可能导致意外升级。该技能是一个薄加载器，详细流程位于同目录的 CAPABILITIES.md 和 TASKS.md。
指导智能体读取 CAPABILITIES.md 和 TASKS.md；运行或要求用户提供 pkg-config --modversion doca-common、/opt/mellanox/doca/applications/VERSION、doca_caps --version、bfver 和 /etc/mlnx-release 的结果；验证四方版本匹配；检查 NGC 容器版本语义、版本矩阵、DOCA Compatibility Policy 路由和 apt 源一致性；诊断部分安装、主机与 BFB 不匹配、NGC 混用及构建时与运行时漂移。
- DOCA 开发者需要确认主机实际安装的版本，而文档版本与环境不一致。
- BlueField 用户需要核对主机 DOCA 版本与 BFB 版本是否兼容。
- 工程师遇到程序构建成功但运行时出现 DOCA_ERROR_NOT_SUPPORTED、符号缺失或数据面无动作。
- 容器用户需要理解 NGC 标签或检查容器内外版本是否混用。
- 维护者需要为新的 DOCA 库编写版本兼容性段落或更新版本固定值。
- 系统管理员准备升级、降级或安装 DOCA，并需要先检查 apt 源是否指向正确发行版。
这个 Skill 有哪些优点和局限？
- 覆盖主机、应用、能力工具和 BlueField 发布信息的统一版本核对。
- 明确区分版本处理与安装、库级 API、通用调试等其他技能的边界。
- 包含构建与运行时漂移、NGC 标签和 apt 源一致性等实际场景。
- README 表明仓库技能通过 NVIDIA 签名、评估数据集和同步流程进行发布治理。
- SKILL.md 本身是薄加载器，详细操作依赖未在本资料中提供的 CAPABILITIES.md 和 TASKS.md。
- 版本验证步骤要求目标环境存在 /opt/mellanox/doca 下的实时 DOCA 安装。
- 该技能不负责安装或选择 DOCA 包，也不替代库级 API 技能或通用调试技能。
- 源材料没有展示该单项技能的具体评估结果或测试用例内容。
如何安装这个 Skill？
使用仓库 README 中的 skills CLI 安装方式：npx skills add nvidia/skills --skill doca-version --yes。README 说明无需克隆仓库或手动复制技能目录；安装后，智能体在遇到相关任务时加载该技能。
如何使用这个 Skill？
安装后提出具体版本处理问题，例如“我实际安装了哪个 DOCA 版本？”、“pkg-config 显示 3.3.0 但 doca_caps 显示 3.2.0，是否一致？”或“我的程序构建成功但运行时不支持”。技能会将检测和操作流程引导至 TASKS.md，并将版本规则和安全政策引导至 CAPABILITIES.md。仅凭记忆不能推断版本字符串；验证流程需要可用的 /opt/mellanox/doca 安装。