DOCA 调试
帮助定位并分层排查 NVIDIA DOCA 的构建、链接、运行时与程序问题。
文档强调先只读采集、单变量变更、公开来源脱敏和记录变更，也声明无凭据需求并提供Apache-2.0许可与NVIDIA归属；但对gdb、模块重载、eswitch或其他硬件相关变更缺少一致的用户确认、权限边界和可验证回滚步骤，且依赖安全审查不充分，因此扣分。
七层梯子、五阶段循环、容器限制和失败后的升级路径描述较完整，指令之间总体一致；但存在跨文件路由依赖、平台与版本假设，部分命令可用性未由测试覆盖，且基准数据集不可得。静态评估限制分数不超过10，故扣分。
触发条件、非适用范围、环境类别与容器边界写得清楚，能区分env-class、program-class和library-specific问题；但没有中文交互或本土化说明，且对不同发行版、权限和硬件拓扑的适配证据有限，因此扣分。
信息架构清晰，采用SKILL.md、CAPABILITIES.md和TASKS.md分层，包含依赖说明、示例问题、已知边界、许可证、所有者和版本/评估记录；但SKILL元数据缺少作者，变更历史和正式维护更新责任仍不完整，基准报告还记录了结构性缺项，因此扣分。
内容提供可直接采用的分层诊断、日志控制、状态采集和升级流程，能覆盖核心DOCA跨层调试任务；但大量关键内容依赖未纳入评分路径的伴随文件和其他技能，部分建议需用户结合实际版本修正，且没有可独立核验的代表性输出。按静态上限7计，故扣分。
内部链接、命令、版本门槛和评估报告提供了一定可追溯性；但基准测试的原始数据集不可用，报告无法独立复现，且没有真实CI与提交测试套件覆盖关键路径。静态上限为5，故扣分。
- 执行涉及gdb、valgrind、内核模块、eswitch、hugepages或mlxconfig的建议前，应明确获得用户确认、记录当前状态并提供适用于目标环境的回滚步骤。
- 不要把BENCHMARK.md或skill-card中的百分比视为独立验证；报告明确未提供原始评估数据集。
- 核心流程依赖CAPABILITIES.md、TASKS.md及多个其他技能，单独安装或缺少匹配DOCA版本时可能无法完整工作。
- 文档未说明中文输出策略，也未证明所有外部NVIDIA文档或论坛在中国大陆网络环境中稳定可达。
这个 Skill 能做什么，适合哪些场景？
DOCA 调试技能面向编译失败、doca_* 链接错误、DOCA_ERROR_* 返回值、程序无输出、数据包未上线路以及崩溃转储等跨库问题。它使用安装、版本、构建、链接、运行时、程序和驱动的分层排查路径。技能还覆盖日志详细度、跟踪构建、容器内可观测性以及为 NVIDIA DOCA Developer Forum 收集复现状态。它是一个薄加载器，主要将用户引导至 CAPABILITIES.md、TASKS.md 及相关技能。
读取用户描述的 DOCA 症状，帮助判断其所属调试层；引导查看 CAPABILITIES.md 和 TASKS.md；提供或指向 --sdk-log-level、DOCA_LOG_LEVEL、doca-{lib}-trace 等可观测性入口；指导收集可复现状态并路由至 NVIDIA DOCA Developer Forum；在环境类、程序类或库内部问题上转交 doca-setup、doca-programming-guide 或对应库技能。
- DOCA 开发者遇到 undefined reference to doca_*，需要判断是否属于链接层问题。
- DOCA Flow 程序没有有用输出，需要提高日志详细度。
- 在 NGC DOCA 容器中调试，想判断容器内哪些运行时状态可观察。
- 准备提交 DOCA Developer Forum 问题，需要收集可复现环境和运行状态。
- 看到 DOCA 程序的 stack trace、valgrind 输出或 core dump，需要确定优先排查层。
这个 Skill 有哪些优点和局限？
- 覆盖安装、版本、构建、链接、运行时、程序和驱动的统一调试路径。
- 明确区分跨库调试与环境类、程序类、库特定调试。
- 提供日志、跟踪、容器调试和问题报告收集方面的入口。
- 读取技能本身不要求安装 DOCA。
- 实质性调试内容依赖未随提示提供的 CAPABILITIES.md 和 TASKS.md。
- 验证步骤要求 /opt/mellanox/doca 下存在可用 DOCA 安装。
- 不负责 DOCA_ERROR_* 错误分类、环境专属 pkg-config 或 hugepages 问题，也不覆盖 Flow、RDMA QP 或 Comch 的库特定调试。
- 来源未提供平台测试矩阵或独立测试套件信息。
如何安装这个 Skill？
使用默认 skills CLI 安装整个 NVIDIA 技能集合：npx skills add nvidia/skills。也可以列出技能后选择 doca-debug：npx skills add nvidia/skills --list。来源未提供该技能的单独无提示安装命令示例。
如何使用这个 Skill？
安装后，在相关任务中直接描述 DOCA 症状，例如：“ld says undefined reference to doca_flow_init—which layer?” 或 “My DOCA Flow program is silent—where do I get more log output?” 技能会按分层调试路径引导后续操作。