DOCA Flow DPA 性能测量
帮助工程师在支持 DPA 的 NVIDIA 硬件上可靠测量 Flow 规则更新与禁用速率。
文件明确限定DPA硬件、VNF模式、PF/VF范围，要求用户确认配置、先小规模冒烟、避免生产使用，并披露设备绑定、流量验证和版本依赖；未充分说明回滚/恢复机制，工具会绑定设备、分配资源并编程路径选择器，且依赖安装环境与外部文档，故扣分。
TASKS.md与CAPABILITIES.md提供了配置、冒烟、测量、调试和分层错误分类，异常时有路由建议；但本次仅静态阅读，未复现关键命令，实际参数依赖安装版本的README和--help，缺少随技能提交的可执行测试，因此受静态上限限制并扣分。
受众、适用硬件、主动/被动设备拓扑、工作负载轴和明确的非适用范围写得清楚，且覆盖显式与隐式触发；未提供中文使用指导，也未证明从中国大陆访问公共DOCA文档的可达性，核心流程依赖用户本地安装和外部资料，故扣分。
采用SKILL.md、CAPABILITIES.md、TASKS.md分层，包含示例问题、任务路由、限制、依赖和安全规则；但缺少稳定发布版本、变更日志和明确维护承诺，SKILLCARD版本/签名仍为TBD，评估报告还显示结构规范告警，许可证元数据存在不一致，故扣分。
技能能把DPA性能测量拆成设备前置条件、工作负载选择、冒烟、统计解读和故障路由，预期可减少错误测量；但没有随技能提供脚本、固定输出或可复现夹具，实际结果仍依赖现场硬件、固件、DOCA版本和外部README，静态证据不足以支持满分。
文档提供内部交叉引用、四元组记录规则、迭代统计和可选tcpdump自测，并附有评估报告；但评估数据集不可用，未见覆盖关键路径的真实CI与提交测试，本次也未执行验证，因此只能给有限静态可审计分。
- 这是低置信度静态评估；未执行doca_flow_dpa_perf或其自测。
- 运行前必须核对安装版本的README和--help，不应仅依据技能中的工作负载默认值或参数描述。
- 该工具会触碰硬件并可能影响流量；应确认非生产环境、设备绑定范围和可恢复方案。
- 技能未证明中文文档体验或中国大陆网络可达性，外部DOCA文档访问可能成为实际阻塞点。
- SKILLCARD中的版本、签名和时间字段仍为TBD，且许可证信息存在不一致，应在发布前校正。
这个 Skill 能做什么，适合哪些场景？
这是一个用于调用 doca_flow_dpa_perf 的工具型 Agent Skill，面向 DPA 加速的 DOCA Flow 规则更新路径。它指导用户确认硬件、VNF Flow 模式、设备角色划分和工作负载参数，并通过小规模冒烟运行后再进行批量测量。它还帮助解读迭代统计、自测试结果和 Kops/sec 数据，并诊断配置、设备绑定、前置条件及测量可靠性问题。该 Skill 不适用于主机或 DPU-CPU Flow 性能路径、Flow 调优、DOCA 安装或 API 编程。
指导 Agent 检查 /opt/mellanox/doca 中的 DOCA 安装、pkg-config doca-flow、已安装的 doca_flow_dpa_perf 二进制及其 README；确认 ConnectX-7+ 或 BlueField-3 硬件、VNF Flow 模式和 PF/VF 使用条件；选择 burst、queue、completion threshold、workers、hash pipe 算法、工作策略、PSL 表等参数；执行小规模冒烟测试和评估循环；读取更新或 disable-enable 操作的迭代统计、自测试和可选 tcpdump 验证结果。
- 平台运营人员评估路径选择器规则是否适合迁移到 DPA，并与主机或 DPU-CPU 路径进行基准比较。
- 性能工程师在指定设备、DOCA 版本和工作负载下建立可复现的 DPA Kops/sec 基线。
- DOCA Flow 应用开发者测量已部署的 DPA 规则更新路径能达到的设备性能。
- 遇到零操作、挂起或自测试失败时，按分层错误分类定位问题。
- 需要同时报告 DPA Flow 性能和主机 Flow 性能，并明确两组数字来源时，使用统一记录规则。
这个 Skill 有哪些优点和局限？
- 明确区分 DPA-offloaded Flow 路径与主机或 DPU-CPU Flow 路径。
- 覆盖硬件前置条件、工作负载维度、迭代统计、自测试和故障分类。
- 强调冒烟测试、四元组记录和工具名称，降低误报性能数字的风险。
- 明确指出 BlueField-2 和更早 ConnectX 设备不受支持。
- 依赖已安装的 DOCA SDK、匹配的二进制、DPA 硬件和设备权限。
- 不提供脚本、解析器、样例目录或预置吞吐率数字。
- 材料未提供完整 CLI 参数、默认值或可直接复现的性能基线。
- 不负责 DOCA 安装、Flow API 编程或主机 Flow 性能测试。
如何安装这个 Skill？
使用 NVIDIA/skills 的 Skills CLI 安装指定 Skill：npx skills add nvidia/skills --skill doca-flow-dpa-perf --yes。CLI 会提示安装目标；无需手动克隆仓库或复制目录。安装后，Agent 在遇到相关任务时加载该 Skill。DOCA SDK、硬件和设备配置要求不由安装命令解决。
如何使用这个 Skill？
安装后向 Agent 提出具体任务，例如“在 ConnectX-8 上测量 DPA-offloaded Flow 的规则更新速率”。Agent 应先确认 DOCA 已安装、硬件和 VNF Flow 前置条件，再从 TASKS.md 的 configure、run、test 流程开始，并结合 CAPABILITIES.md 解读输出。具体 CLI 参数和默认值以用户安装版本的 README 或 doca_flow_dpa_perf --help 为准；提供的材料没有给出完整命令行示例。
这个 Skill 与同类方案有什么区别？
它明确将 doca-flow-perf 作为主机或 DPU-CPU Flow 路径的替代工具，并将 doca-flow-tune 定位为后续 Flow 调优工具。两者产生的性能数字不能在未注明工具名称的情况下直接互换。