DOCA Comm Channel 管理工具技能
只读扫描主机与 DPU 之间的 DOCA 通信通道服务器和连接。
证据显示工具被定义为只读扫描，并明确禁止凭空添加破坏性参数、要求先检查再进入其他路径的状态变更，也声明无凭据需求；但流程仍涉及sudo、resourcedump、驱动重载、RShim/BFB等高影响外部路径，未明确用户确认、最小权限矩阵、输出脱敏或可操作回滚。另有许可证与题设NOASSERTION元数据不一致，因此扣分。
证据包含分层诊断、版本检查、失败路由和重复检查规则；但SKILL.md、CAPABILITIES.md和TASKS.md反复描述不存在的list/inspect/drain/restart表面，虽用横幅解释其为概念动作，仍造成关键路径自相矛盾。测试报告称通过但测试数据不可用，静态审查不能验证实际命令或错误行为，因此仅给有限分数。
触发短语、受众、依赖环境、适用范围和排除范围写得较清楚，也说明主机与BlueField两侧差异；但中文用户支持未说明，核心依据依赖docs.nvidia.com和本地DOCA/MFT环境，未提供中国大陆网络可达性或离线替代方案，因此扣分。
文档分为SKILL.md、CAPABILITIES.md、TASKS.md，并提供加载顺序、边界、相关技能、许可证和部分评测材料；但缺少稳定的版本/变更历史和明确维护责任，SKILLCARD含TBD签名与版本，且许可证、路径和仓库身份存在不一致，示例与FAQ也不足，因此扣分。
核心目标——指导读取comch服务器和连接表——有清晰价值，且基准报告显示评测结果较好；但报告未提供原始数据，文档不给出可直接复用的真实命令、输出样例或解析器，且工作流使用不存在的子命令概念，用户仍需查本地--help和外部文档，故只认可核心任务部分完成。
存在提交的基准报告、evals.json、技能卡和明确的源码/文档指针，支持有限审计；但评测数据集不可用、没有本技能关键路径的提交测试套件或CI执行证据，外部来源未随本次材料提供，静态审查无法独立复现，因此按静态上限给5分。
- TASKS.md中的list/inspect工作流与SKILL.md声称二进制没有这些子命令相冲突；执行前必须以已安装二进制的--help和实际输出为准。
- 涉及驱动重载、BlueField模式变更、RShim/BFB或程序侧重连的建议应单独获得用户确认，并先建立可恢复方案；文档未给出完整回滚步骤。
- 不要把完整未脱敏输出直接写入日志或共享；输出可能包含PID、服务器名、PCIe地址等运行环境信息。
- 评测报告声称PASS但原始数据集不可用，不能视为独立复现证据。
这个 Skill 能做什么，适合哪些场景？
该技能指导代理使用 NVIDIA DOCA 的 doca_comm_channel_admin 命令行工具，盘点当前一侧可见的通信通道服务器与连接。工具会扫描支持 comch 的设备，通过 resourcedump 获取数据，并输出 SERVERS 与 CONNECTIONS 两张表。它是单次、只读的扫描工具，不负责重置、排空或重启通道。适合已安装 DOCA、需要从程序外部核验 BlueField 通道状态的运维人员和开发者。
在当前主机或 BlueField Arm 侧扫描所有 doca_dev，筛选支持 comch 的设备，并对每个设备调用 MFT 的 resourcedump。随后输出服务器名称、PID、使用数/最大数以及 PCIe 地址等服务器和连接信息。每次调用只执行一次库存扫描；支持 ARGP 默认选项，包括 --help、--version、--log-level、--sdk-log-level 和 --json。
- BlueField 运维人员需要查看当前可见的 comch 服务器和连接。
- Comch 应用开发者看到程序报告 CONNECTED，但需要从外部核对通道状态。
- 平台团队在服务上线前采集一份无副作用的通道快照。
- 管理员需要判断空表是确实没有通道，还是设备绑定、权限、版本或发现问题。
这个 Skill 有哪些优点和局限？
- 只读且无副作用，适合运行时核验和故障排查。
- 一次扫描当前一侧所有支持 comch 的设备。
- 明确区分工具盘点职责与程序侧通道控制职责。
- 不能创建、重置、排空或重启通道。
- 依赖已安装的 DOCA SDK、Comm Channel 工具和 MFT resourcedump。
- SKILL.md 不包含脚本、解析器或预生成示例输出。
- 非空表需要活动的主机↔DPU comch 通道；空输出不一定代表安装损坏。
如何安装这个 Skill？
先确保 Linux 环境已安装 DOCA SDK，且 Comm Channel tooling 子包提供 /opt/mellanox/doca/tools/ 下的命令。安装该代理技能可运行：npx skills add nvidia/skills --skill doca-comm-channel-admin --yes。源材料未提供 DOCA SDK 本身的安装命令。
如何使用这个 Skill？
向代理提出“列出这台 BlueField 上的 comch 服务器和连接”或“核对管理工具是否看到与程序相同的通道”。在已满足环境要求的主机上运行 /opt/mellanox/doca/tools/doca_comm_channel_admin；该二进制不接受 list、inspect、drain 或 restart 子命令。非空结果需要当前一侧存在由 doca-comch 库创建的活动主机↔DPU 通道。
这个 Skill 与同类方案有什么区别？
与 doca-comch 库相比，本技能用于从程序外部只读盘点服务器和连接；doca-comch 负责程序侧的通信通道生命周期。通道状态变更应转向 doca-comch、doca-setup、doca-hardware-safety 或 BFB/RShim，而不是本工具。