关联原任务 issue：https://gitcode.com/Ascend/pytorch/issues/3704

任务背景

torch.testing._internal.common_utils.skipIfRocm 是 PyTorch 官方测试装饰器：在 ROCm 环境下跳过被装饰的测试/函数，支持 @skipIfRocm 与 @skipIfRocm(msg="...") 两种用法，默认跳过消息为 "skipIfRocm: test doesn't currently work on the ROCm stack"。

官方用例检索结果

官方 test/test_testing.py 等使用该装饰器（如 TestImports.test_circular_dependencies），但未发现对其行为（运行路径、跳过路径、reason 消息、两种用法）的直接验证用例，也没有 NPU 专项覆盖。源码片段（官方装饰器定义）：

def skipIfRocm(fn=None, *, msg=None):
    ...
    return skipIf(TEST_WITH_ROCM, msg or "test doesn't currently work on the ROCm stack")(fn)

NPU 适配验证情况（四版本环境）

在 NPU 上补充直接验证（本地验证文件 test/test_skip_if_rocm.py）：NPU 上装饰器不跳过、正常执行；TEST_WITH_ROCM=True（mock）时按默认/自定义消息抛 unittest.SkipTest。运行命令与结果（v2.7.1 / v2.11.0 / v2.12.0 / master 四环境，Ascend 910B3 单卡）：

# v2.7.1（torch 2.7.1+cpu + torch_npu 2.7.1.post8）
python test/test_skip_if_rocm.py -v
Ran 5 tests in 1.092s
OK
（class decoration preserves TestCase subclass: False）

# v2.11.0（torch 2.11.0+cu130 + torch_npu 2.11.0）
python test/test_skip_if_rocm.py -v
Ran 5 tests in 1.077s
OK
（class decoration preserves TestCase subclass: False）

# v2.12.0（torch 2.12.0+cu130 + torch_npu 2.12.0）
python test/test_skip_if_rocm.py -v
Ran 5 tests in 1.091s
OK
（class decoration preserves TestCase subclass: False）

# master（torch 2.13.0+cpu + torch_npu 2.13.0.rc1）
python test/test_skip_if_rocm.py -v
Ran 5 tests in 1.090s
OK
（class decoration preserves TestCase subclass: True）

补充说明（类装饰器版本差异，纯 Python 行为、与设备无关）：master 的 skipIfRocm 基于 lazy_skip_if，对类目标原样返回类（类装饰用法有效，NPU 上正常执行）；v2.7.1 / v2.11.0 / v2.12.0 实现为 @wraps + wrapper，类装饰后返回函数包装器、类不再被 unittest 识别为 TestCase。

资料补齐

torch.testing._internal.common_utils.skipIfRocm 属 PyTorch 私有测试内部接口，master 文档树 docs/zh/api/native_api 下无对应 Native API 文档条目，按验收标准「PyTorch 私有接口不需要补充资料」，无需资料补齐。

结论

该 API 在 NPU 上行为与官方一致（装饰器仅在 ROCm 环境生效，NPU无关）；官方用例缺乏对该装饰器行为的直接覆盖，本 issue 已附运行日志与源码片段，按社区用例硬件解耦任务跟踪处理。

A2 补充实测（2026-09-10，Atlas A2 / 910B3 单卡，torch 2.9.0）

在 A2 环境（主机 6b99a1c1d57a，aarch64 / Ubuntu 22.04 / Python 3.11.15 / CANN 9.0.0）以 torch 2.9.0+cpu + torch_npu 2.9.0.post6 复跑同一验证脚本，结果与上述一致：

npu-smi 25.2.0：NPU 2 910B3  Health OK
torch: 2.9.0+cpu
torch_npu: 2.9.0.post6
device: 0
TEST_WITH_ROCM: False
(class decoration preserves TestCase subclass: False)

Ran 5 tests in 0.374s
OK
ALL_PASS

• 5 项断言全部通过：NPU 上 @skipIfRocm 装饰的函数正常执行（含真实 NPU 算子运算）；mock TEST_WITH_ROCM=True 时默认/自定义消息精确抛出 unittest.SkipTest；@skipIfRocm 与 @skipIfRocm(msg=...) 两种写法等价。
• torch 2.9.0 的 skipIfRocm 仍为 @wraps + wrapper 实现（类装饰返回函数包装器、不被识别为 TestCase），与 2.7.1 / 2.11.0 / 2.12.0 一致；master 改用 lazy_skip_if 属后续上游变更。
• 验证脚本：verify_skip_if_rocm.py（含 NPU 算子断言），运行环境 venv=/workspace/torchnpu26/venv。