DOCA PCC ZTR RTTCC 拥塞控制技能
帮助在 BlueField-3 上部署、调优和验证 NVIDIA 的 RoCE RTT 拥塞控制参考算法。
文档声明最小化修改、版本匹配、参数范围检查和安全策略路由，也未发现凭据窃取或恶意外传；但目标是可能影响生产 RoCE 流量的硬件部署，缺少明确的用户确认、具体回滚步骤和完整数据流/权限说明，且许可证与 SKILL.md 元数据的 NOASSERTION 不一致，因此扣分。
安装、构建、修改、测试和调试路径较完整，并提供错误分类；但关键命令、参数和行为依赖未提供的 companion skills、已安装 SDK 和硬件环境，且 set-params 调用签名在文件间存在不一致，静态检查无法验证可运行性，因此受限于静态上限并扣分。
触发条件、受众、适用场景和明确的非适用范围写得清楚，覆盖显式和隐式问题；但主要面向特定 BlueField-3/DOCA 环境，中文支持未说明，核心公共文档依赖海外 NVIDIA 服务，未证明中国大陆网络可达，因此扣分。
采用 loader、CAPABILITIES.md 与 TASKS.md 的分层结构，包含示例、依赖、限制、路由和维护入口；但 SKILL.md 缺少推荐的 Instructions/Examples 章节，版本、签名和签署信息仍为 TBD，许可证信息互相矛盾，缺少清晰 changelog 和明确维护责任，因此扣分。
针对部署接线、变体选择、参数调整和故障诊断提供了可直接照做的流程，具有明确的边界和路由；但没有可独立复现的代表性输出或实际执行证据，且大量结果依赖现场硬件、SDK 和其他技能，静态评估不能确认最终任务完成度，因此扣分。
文件包含 API、构建步骤、错误分类和一份 benchmark 报告；但 benchmark 数据集不可用，报告仅提供汇总指标，没有可核验的 CI/测试套件覆盖关键路径，也没有第三方复现证据，因此仅给有限分数。
- 执行或重建前应获得用户明确确认，并先在非生产流量上验证；文档没有给出具体可执行的回滚流程。
- 核对 SKILL.md、CAPABILITIES.md 和 TASKS.md 中 doca_pcc_dev_set_ztr_rttcc_params 的完整签名及实际安装头文件，避免按不一致示例操作。
- 许可证、路径和版本信息存在冲突或 TBD 状态；发布前应统一元数据并补充可复现测试证据。
- 核心依赖包括特定 DOCA/DPACC/BlueField-3 环境及海外文档服务，应确认中国大陆网络和本地安装包可达性。
这个 Skill 能做什么，适合哪些场景？
该技能面向在 BlueField-3 DPU 上部署 NVIDIA 随 DOCA 提供的 Zero-Touch RoCE RTT-based Congestion Control 参考算法的开发者。它指导用户将算法接入随附的 DOCA PCC C 示例，选择 DPA 构建时变体，并从主机调整参数。它还覆盖算法加载失败、状态错误以及流量未被调节等问题的排查。该技能不是独立 PCC 程序，也不用于从头编写自定义算法或只读查看计数器。
检查 /opt/mellanox/doca 下的 DOCA 库、头文件和 PCC 应用目录，并读取 pkg-config 模块 doca-pcc-ztr-rttcc-algo。指导用户在随附的 PCC 示例中接入 doca_pcc_dev_ztr_rttcc_algo，使用 DPACC 构建 DPA 侧程序，选择 vanilla、路径迁移、RX-rate、多路径或 window-probeless 等变体，并通过 doca_pcc_dev_set_ztr_rttcc_params 调整主机侧参数。它还指导用户结合 PCC 计数器确认 RoCE-v2 流量是否受到调节，并分层诊断 DOCA_PCC_DEV_STATUS_FAIL 和 DOCA_ERROR_* 返回值。
- BlueField-3 上已有 RoCE-v2 流量，用户希望先采用无需配置的 ZTR RTTCC 基线。
- DOCA PCC 示例已经运行，用户需要把 shipped 算法接入用户算法回调和指定算法槽位。
- 用户需要在 vanilla、路径迁移、RX-rate、多路径或 window-probeless 变体之间做选择。
- 算法已加载但拥塞下计数器或流量速率没有明显变化，用户需要验证和排查。
- 用户需要从主机调整 RTTCC 参数，而不重新构建 DPA 侧镜像。
- 参考算法无法满足特定延迟、公平性或收敛要求，用户需要评估是否改写自定义算法。
这个 Skill 有哪些优点和局限？
- 明确限定在 NVIDIA 随 DOCA 提供的 ZTR RTTCC 参考算法，适合实际部署和评估。
- 覆盖接入示例、DPA 构建、变体选择、主机参数调整、运行验证和分层排错。
- 清楚区分算法库、主机侧 doca-pcc 框架和只读计数器工具的职责。
- 仅适用于具备特定 DOCA、DPACC、BlueField-3、固件和 RoCE-v2 前提的环境。
- 技能本身是薄加载器，不包含算法实现、独立 PCC 应用或完整变体数学说明。
- 不适合从头设计自定义 PCC 算法、通用 PCC 理论或单纯读取计数器。
- 提供的材料没有展示该特定技能的运行基准或实际硬件测试结果。
如何安装这个 Skill？
使用 NVIDIA/skills 的默认 Skills CLI 安装指定技能：npx skills add nvidia/skills --skill doca-pcc-ztr-rttcc-algo --yes。按技能要求准备 DOCA SDK、匹配版本的 DPACC、启用 custom-PCC 固件槽位的 BlueField-3，以及正在传输 RoCE-v2 流量的端口。源材料没有提供 DOCA SDK 或 DPACC 的具体安装命令；未安装 DOCA 时应先使用 doca-setup 技能。
如何使用这个 Skill？
将技能安装到目标 Agent 后，在相关任务中提出例如“如何把 doca_pcc_dev_ztr_rttcc_algo 接入现有 DOCA PCC 示例并选择 multipath 变体？”或“算法加载成功但 RoCE 流量没有被调节，如何排查？”。执行任务时先阅读 TASKS.md；查询能力、变体、参数、计数器、错误分类或安全策略时阅读 CAPABILITIES.md。仅查看计数器的任务应转交 doca-pcc-counters。
这个 Skill 与同类方案有什么区别？
它明确将自身与 DOCA PCC 主机侧框架、doca-pcc-counters 计数器工具以及从头编写的自定义 PCC 算法区分开来；参考算法与自定义算法的选择是其主要采用决策。