Menu
将 RDMA verbs 代码迁移到 URMA API。当用户想要将 infiniband verbs 代码转换为 URMA，或在进行 RDMA/InfiniBand 迁移时，或用户提到 verbs API、ibv_*、rdma，或想要使用 URMA 替代传统 RDMA 时使用此 skill。此 skill 处理完整的迁移，包括 API 映射、数据结构转换和 URMA 特定优化。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Generate and maintain stable URMA GTest unit tests in umdk.
按 C 语言编程规范编写、检视或审阅 C/C++ 代码改动。
识别代码中可替换为CAM算子的DeepEP算子，基于实际运行参数校验约束，自动完成通信域转换（NCCL->HCCL）、设备适配（CUDA->NPU）及算子替换。
| 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 行，按需加载）