| name | external-gitcode-ascend-atb-csv-tester |
| description | 运行 ATB (Ascend Transformer Boost) CSV 测试。当用户需要执行 CSV 格式的 ATB 测试用例、 验证算子正确性、或运行任何ATB下的 CSV 测试文件时调用此技能。 需配合 CANN 环境和已编译的 ATB 测试框架使用。
|
| keywords | ["atb","csv","test","csv-test","ascend-transformer-boost","昇腾","算子测试"] |
| metadata | {"author":"ascend-transformer-boost-team + Claude Code + deepseek-v4-pro","version":"1.6.0","created":"2026-04-17","updated":"2026-04-29","skill-type":"test","allowed-tools":"Bash(docker|bash|cd|ls|grep|find|echo|cat) Read(*)","gates":[{"id":"gate-5","description":"全量回归门控","trigger":"Phase 5b 完成后,所有相关 CSV 必须全部通过,方可进入 Phase 6 交付"}]} |
| hooks | {"PreToolUse":[{"matcher":"Write|Edit|Bash","hooks":"[Truncated]"}],"PostToolUse":[{"matcher":"Write|Edit","hooks":"[Truncated]"},{"matcher":"Bash","hooks":"[Truncated]"}],"Stop":[{"hooks":"[Truncated]"}]} |
| original-name | atb-csv-tester |
| synced-from | https://gitcode.com/Ascend/agent-skills |
| synced-date | 2026-05-26 |
| synced-commit | 1f7666e7768a0ceb21bb1d40ce4b5179fcb6f1d6 |
| license | UNKNOWN |
ATB CSV Tester
功能概述
运行 ATB CSV 测试用例,验证算子正确性。需配合 CANN 环境和已编译的 ATB 测试框架。
路径约束
必须从用户处获取以下路径:
<CANN_PATH>: CANN 安装路径(如 /usr/local/Ascend/ascend-toolkit/latest)
<ATB_REPO_PATH>: ATB 仓库路径
若路径无效,立即停止并报错。
调用时机
- 运行 ATB CSV 测试(如
linear.csv)
- 验证已迁移算子的正确性
- CANN 环境下的算子级别功能测试
设备支持说明
当前测试环境仅支持 Ascend910B 设备。
运行规则
- 执行测试时仅运行 SocVersion 包含 Ascend910B 的用例(测试框架自动匹配当前设备 SocVersion)
- CSV 测试用例生成时,已根据设备差异分离设计(参见
atb-csv-testcase-generator 的多设备测试设计原则)
910B/950 差异用例分离要求
⚠️ 当 910B 和 950 在以下任何方面存在差异时,必须拆分为独立用例、各自指定 SocVersion:
| 差异维度 | 拆分要求 |
|---|
| dtype 支持 | 各自支持的 dtype 分别设计正例和反例 |
| format 支持 | 各自合法的 format 分别测试 |
| 参数约束 | 各自合法/非法参数值分别验证 |
| 维度限制 | 各自边界值/UB 上限分别设计 |
| ExpectedError | 同一输入可能触发不同错误码,分别设计反例 |
| 性能基准 | 性能测试分别标记各自 SocVersion |
严禁将存在功能差异的用例合并为 Ascend910B;Ascend950——合并 SocVersion 仅限两个设备完全一致的场景。
910B 测试完成后的提示
Ascend910B 测试全部通过后,必须提示用户:
"910B 测试已全部完成。CSV 测试用例中已包含针对 Ascend950 的独立用例(SocVersion 不含 910B),请在 Ascend950 设备上手动运行 CSV 测试以验证 950 兼容性:"
cd <ATB_REPO_PATH>/tests/framework/python/CsvOpsTestTool
python3 atb_csv_ops_test.py -i <CSV_FILE_PATH>
- 950 设备测试命令相同,用户仅需将测试环境切换至 Ascend950 机器后重新执行
- 950 测试中若有失败,应对比 910B 结果分析是否为设备差异导致的预期行为
Gate 5: 全量回归门控
强制规则:进入 Phase 6 交付前,所有与目标算子相关的 CSV 文件必须全部运行并通过。
相关 CSV 枚举
以目标算子名称(如 layer_norm)为基准,枚举所有相关 CSV:
find <ATB_REPO_PATH>/tests/apitest/opstest/csv/ -name '{op_name}*.csv' - f |