DOCA SPCX 可编程拥塞控制
帮助开发者在 BlueField 上加载、评估和回滚 SPCX 拥塞控制算法。
文档明确要求最小化生产暴露、先在副本验证、具备带外管理、分批发布、可回滚到工厂PCC，并披露现场链路、固件、算法和参数等数据流；但加载自定义拥塞控制会直接影响实时RDMA fabric，用户确认步骤、权限边界、回滚具体命令和敏感数据处理仍不完整，因此扣8分。
SKILL.md、CAPABILITIES.md和TASKS.md在触发范围、依赖检查、错误分类和异常分流上基本一致；但命令行细节多次要求以安装版本的--help和公开指南为准，缺少可复现命令、完整失败输出和实际测试覆盖。静态校准下不超过10分，因此扣12分。
目标用户、典型问题、非适用范围、触发短语、SPCX/PCC/工厂PCC路由和现场争用前提描述清楚；但依赖特定BlueField、DOCA、DPACC和可控RDMA fabric，且未提供中文支持或中国大陆网络可达性说明，扣3分。
文档分为入口、能力、任务和评估文件，具备渐进披露、相关技能路由、限制和安全政策；但版本、变更历史、维护责任和签名均为TBD或不清晰，SKILLCARD中的仓库路径和许可证元数据与给定对象存在不一致，且基准报告称源数据不可用，因此扣8分。
对于已有匹配硬件、安装和算法镜像的操作者，决策树、准备-冒烟-争用评估、调试和发布门禁能覆盖核心任务；但技能不提供脚本、固定命令、样例输出或可执行测试，结果依赖外部公开文档和现场系统，静态校准下不超过7分，因此扣9分。
源文件提供了较完整的内部交叉引用、错误分类、证据字段和评估报告；但基准数据集不可用，报告中的执行结果无法由给定材料独立复核，且没有本技能专属的可执行测试或CI证据。静态校准下不超过5分，因此扣6分。
- 这是高风险的实时拥塞控制工具指导；不要在生产fabric上直接加载，除非副本验证、可观测性、带外路径、分批计划和回滚演练均已完成。
- 命令、角色、探测包格式和指标可能随DOCA版本变化；必须以本机doca_spcx_cc --help和官方指南核对，不能把文档中的示例当作完整CLI接口。
- 给定材料未证明中国大陆网络可达性，也未提供中文操作材料；依赖的公开指南或外部服务可能需要额外验证。
- SKILLCARD的许可证、仓库路径、版本和签名字段与评估对象存在不一致，发布前应由维护者校正。
这个 Skill 能做什么，适合哪些场景？
该技能面向使用 NVIDIA DOCA 的外部开发者、平台运维人员和 AI 代理，通过主机侧 doca_spcx_cc CLI 管理 BlueField DPA 上的 SPCX 可编程拥塞控制算法。它覆盖算法加载、参数配置、启动、观测、停止，以及 SPCX 与 doca-pcc、固件工厂 PCC 之间的选择。评估要求连接真实 RDMA/RoCE 链路并产生可控竞争，技能强调先在非生产副本验证、建立观测证据并演练回滚。它不负责 DPA 侧算法编写、工厂 PCC 配置、通用 DOCA 安装或底层二进制调试。
指导代理检查 DOCA、BlueField DPA、固件 custom-PCC 插槽和 DPACC 版本匹配情况；使用 /opt/mellanox/doca/tools/ 下的 doca_spcx_cc 进行 SPCX 算法的加载、参数化、启动、状态与运行时观测、停止；根据 SPCX 与 doca-pcc 的决策树选择路径；在非生产 RDMA/RoCE fabric 上执行准备、冒烟和有竞争力的评估；按安装、设备绑定、固件插槽、DPA 镜像、算法前置条件、链路前置条件、运行时和版本层次诊断错误；依据观测证据、影响范围和回滚计划判断是否适合推进到生产。
- CC 研究人员已用 DPACC 编译 SPCX 算法，需要在 BlueField 上加载并进行主机侧运行控制。
- 平台运维人员在非生产 RoCE fabric 上制造可控竞争，比较自定义 SPCX 算法与工厂 PCC 的行为。
- 开发者的会话显示加载成功，但吞吐量或延迟曲线没有变化，需要排查是否缺少真实竞争或实际仍由工厂算法控制。
- 团队需要判断某个 SPCX 算法能否进入生产，并核验观测、带外访问、影响范围和 factory-PCC 回滚证据。
- 运维人员遇到 DOCA_PCC_PS_ERROR，需要区分安装、设备、固件、DPA 镜像、版本或运行时原因。
这个 Skill 有哪些优点和局限？
- 覆盖 SPCX 与 doca-pcc、工厂 PCC 的路由决策。
- 包含非生产副本、竞争场景、运行时观测和生产回滚的安全门槛。
- 提供分层错误分类和版本匹配检查，适合运维评估与故障分流。
- 明确区分主机侧工具使用与 DPA 侧算法编写。
- 依赖特定的 DOCA SDK、BlueField DPA、固件 custom-PCC 插槽和匹配的 DPACC 编译器。
- 必须连接有实际竞争的 RDMA/RoCE fabric；无竞争时算法可能没有可见信号。
- 不提供具体拥塞控制算法、样例输出、脚本、包装器或调优结论。
- SKILL.md 未给出具体参数和子命令，实际 CLI 细节需查看安装版本的 --help。
- 不适用于工厂 PCC 配置、通用 DOCA 安装、DPA 算法开发或原始 DPA 周期分析。
如何安装这个 Skill？
使用仓库 README 提供的 skills CLI 安装指定技能：npx skills add nvidia/skills --skill doca-spcx-cc --yes。安装后，在代理下一次加载相关技能时可用。运行环境还必须安装位于 /opt/mellanox/doca 的 DOCA SDK，并具备 SPCX 可选组件、启用 custom-PCC 插槽的 BlueField 固件、版本匹配的 DPACC 编译器和可用于评估的非生产 RDMA/RoCE fabric。
如何使用这个 Skill？
在已满足硬件、固件、软件和链路前置条件的主机上，向代理提出例如“我有一个 DPACC 编译的 SPCX 算法和非生产 BlueField 对，如何进行有竞争力的评估？”或“doca_spcx_cc 启动时报 DOCA_PCC_PS_ERROR，如何分层排查？”。技能按 configure、run、test、debug 和 use 等任务流程提供指导。具体参数、子命令、探测包格式和指标名称应以已安装的 doca_spcx_cc --help 及公开 DOCA 指南为准；源材料未提供可直接复制的完整运行命令。
这个 Skill 与同类方案有什么区别？
该技能明确比较三条路径：SPCX 是新一代可编程拥塞控制表面；doca-pcc 是既有的主机侧 PCC 路径；工厂 PCC 则由固件配置，不需要 doca_spcx_cc 或主机侧库。选择取决于安装环境、算法支持、固件 custom-PCC 插槽、DPACC 与 DOCA 版本匹配，以及用户是在编写算法还是消费已有算法。