Menú
将 RDMA verbs 代码迁移到 URMA API。当用户想要将 infiniband verbs 代码转换为 URMA，或在进行 RDMA/InfiniBand 迁移时，或用户提到 verbs API、ibv_*、rdma，或想要使用 URMA 替代传统 RDMA 时使用此 skill。此 skill 处理完整的迁移，包括 API 映射、数据结构转换和 URMA 特定优化。
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
| name | verbs-to-urma-converter |
| description | 将 RDMA verbs 代码迁移到 URMA API。当用户想要将 infiniband verbs 代码转换为 URMA，或在进行 RDMA/InfiniBand 迁移时，或用户提到 verbs API、ibv_*、rdma，或想要使用 URMA 替代传统 RDMA 时使用此 skill。此 skill 处理完整的迁移，包括 API 映射、数据结构转换和 URMA 特定优化。 |
版本: 1.0 | URMA API 版本: 25.12.0
此 skill 将 RDMA Verbs (libibverbs) 代码迁移到 URMA (统一远程内存访问) API。
在以下情况触发此 skill：
以下约束贯穿迁移全过程，任何阶段不得违反：
urma_output/，保留原始目录结构，原始文件不得修改urma_api.h / urma_types.h 为准，与参考文档冲突时以头文件为准{0} 或 {.field = value} 指定初始化，未初始化字段导致未定义行为| RDMA Verbs 概念 | URMA 等价物 |
|---|---|
| PD (保护域) | URMA 中隐式存在 |
| MR (内存区域) | urma_target_seg_t 通过 urma_register_seg() |
| CQ (完成队列) | urma_jfc_t 通过 urma_create_jfc() |
| QP (队列对) | urma_jetty_t 或 urma_jfs_t + urma_jfr_t |
| SRQ (共享接收队列) | urma_jfr_t 带 share_jfr=1 标志 |
| 完成通道 | urma_jfce_t 通过 urma_create_jfce() |
| LID + GID | urma_eid_t (16字节端点ID，LID 已移除) |
| QPN | JPN (Jetty 对编号) |
| PSN | PSN (包序列号) |
mapping.md §1）| Verbs | URMA |
|---|---|
ibv_open_device() | urma_create_context() |
ibv_reg_mr() | urma_register_seg() |
ibv_create_cq() | urma_create_jfc() |
ibv_create_qp() | urma_create_jetty() |
ibv_modify_qp(RTR/RTS) | urma_import_jetty() + urma_bind_jetty() |
ibv_post_send() | urma_post_jetty_send_wr() |
目标: 理解源代码并建立完整的 API 映射。
必须交付物（阶段结束时必须产出）:
必须完成（阶段过程中的硬约束）:
/usr/include/ub/umdk/urma/参考查阅路径（建议，非强制）:
目标: 在 urma_output/ 目录中创建转换后的代码，原始文件保持不变。
必须交付物（阶段结束时必须产出）:
urma_output/ 目录，包含所有转换后的文件，保留原始目录结构转换约束（必须满足）:
urma_output/，原始文件不可修改每个文件的转换内容:
#include <infiniband/verbs.h> → #include <ub/umdk/urma/urma_api.h>wc.qp_num → cr.local_id）IBV_MTU_1024 → URMA_MTU_1024）lid:qpn:psn:gid → jpn:eid，查 mapping.md §地址交换格式决策）构建配置必须更新:
-libverbs → -lurma -lurma_commoninfiniband/verbs.h → ub/umdk/urma/urma_api.h-lurma -lurma_common）问题：阶段 1 产出映射计划后，阶段 2 逐文件转换时容易遗漏非核心路径的映射项（如
ibv_create_comp_channel → urma_create_jfce），因为验证只对照 patterns/pitfalls（通用知识），不对照阶段 1 的映射计划（项目特定清单）。
两层追溯机制：
文件级追溯（每个文件转换后立即核对）：
项目级追溯（所有文件转换后汇总核对）：
必须验证:
必须达到的状态:
输出方式: 逐项列出每章节的验证结果与判断依据，确保可审计。不得以"已验证"等笼统表述替代逐项检查。
目标: 编译、链接并验证转换后的代码。
必须交付物（阶段结束时必须产出）:
liburma.so 和 liburma_common.so）必须完成（阶段过程中的硬约束）:
常见编译错误与排查方向:
| 错误类型 | 可能原因 | 排查方向 |
|---|---|---|
| 未定义引用 | API 名称错误 | 查 urma_api.h 中的正确函数签名 |
| 没有名为 'jetty_id' 的成员 | 字段名错误 | cr.local_id 而非 cr.jetty_id（见 mapping.md） |
| 宏重定义 | 头文件中已存在该宏 | 删除自己定义的宏 |
| 类型不匹配 | 参数类型错误 | 匹配 urma_api.h 中的确切签名 |
| 缺少头文件 | 未包含正确头文件 | 添加 #include <ub/umdk/urma/urma_api.h> |
目标: 以项目视角检查跨文件语义问题，验证编译之外的正确性。
为什么不能只看单个文件: 资源生命周期跨文件（A 文件创建、B 文件销毁）、类型声明在 .h 中修改但 .c 引用未同步、Verbs 残留可能仅出现在"原样复制"的工具文件中——这些都不是单文件视角能发现的问题。
必须交付物（阶段结束时必须产出）:
urma_output/ 中无任何 ibv_* / verbs.h / infiniband 引用必须完成（阶段过程中的硬约束）:
ibv_cq *g_cq → urma_jfc_t *g_jfc），确认 .h 声明和所有 .c 使用一致urma_output/ 中无任何 Verbs 残留引用urma_import_* 是否都有对应的 urma_unimport_*；每个 urma_wait_jfc 是否都有 urma_ack_jfc修复并重编译，直到干净。
向用户展示以下信息：
强制性: 所有转换后的代码放入新目录。原始文件保持不变。
最终输出结构:
project/
├── (原始文件 - 不变)
└── urma_output/
├── (转换后的 .c 文件)
├── (转换后的 .h 文件)
├── (原样复制的非 verbs 文件)
└── Makefile
成功迁移后，你可能会发现新的映射、patterns 或 pitfalls。
步骤:
收集新发现:
向用户展示发现:
我在迁移过程中发现了以下新信息:
[清晰列出发现]
是否要将这些添加到参考文件中？
如果用户同意:
references/mapping.mdreferences/patterns.mdreferences/pitfalls.md如果用户拒绝:
这确保 skill 随着实际使用不断改进，但仅在用户同意时进行。
| 文件 | 用途 | Agent 使用场景 |
|---|---|---|
mapping.md | Verbs → URMA 查找表 | "X 的 URMA 等价物是什么？" |
patterns.md | 完整代码模式 | "展示如何编写 X" |
pitfalls.md | 已知问题和修复 | "为什么 X 失败？" |
urma_sample.md | 完整工作示例 (~1280 行) | 仅当 patterns.md 不够详细时按需阅读 |
推荐阅读顺序:
mapping.md - 学习 API 等价物patterns.md - 查看完整工作代码pitfalls.md - 避免常见错误urma_sample.md - 仅当需要完整参考实现时阅读（~1280 行，按需加载）Generate and maintain stable URMA GTest unit tests in umdk.
按 C 语言编程规范编写、检视或审阅 C/C++ 代码改动。
识别代码中可替换为CAM算子的DeepEP算子，基于实际运行参数校验约束，自动完成通信域转换（NCCL->HCCL）、设备适配（CUDA->NPU）及算子替换。