SuperAPI AI 工具集

atb-ops-to-aclnn-migration-workflow

编程与开发

查看项目

更新于 10-24 04:38

技能介绍

ATB OPS→ACLNN 迁移标准化工作流是一个面向 ATB 算子的迁移流程模板,核心用途是把算子从 OPS 接口迁移到 ACLNN 接口,在 910B/950 设备上启用 ACLNN 加速,同时保持对其他设备的兼容性。资料说明其典型调用场景包括 {xxx}Quant、{xxx}Norm、Softmax 等算子的 OPS→ACLNN 迁移。

主要能力是按 7 个阶段组织迁移工作,并设置 Human in the Loop 用户确认机制。各阶段为:Phase 0 前置知识学习,产出前置知识总结文档(如 quant_basics.md);Phase 1 设计文档生成,调用 atb-aclnn-operator-replacement-designer 生成包含 7 个章节的替换设计文档,需通过 Gate 1 用户确认;Phase 2 CSV 用例设计,调用 atb-csv-testcase-generator,产出 {op}_func.csv(正例+反例)与 {op}_perf.csv(性能)两个独立文件,可选合并的 {op}_test.csv,需通过 Gate 2 用户确认;Phase 3 实际迁移(TDD),调用 atb-aclnn-operator-migration,实现继承 AclnnRunner 的新 runner,包括 BuildAclnnVariantPack、SetAclNNWorkspaceExecutor、LaunchAclnnKernel、LoadMethod 四大方法,并用 GetSingleton<Config>().Is910B() 与 Is950() 做设备检测;Phase 4 编译验证,最多 3 次尝试,失败时调用 atb-debug-guide;Phase 5a 小范围验证,前台运行功能 CSV(不指定 -t,默认约 1 次,秒级完成),后台 subagent 用 -n N:N 逐个运行性能 CSV(默认 400 次,不阻塞主流程);Phase 5b 全量回归,运行所有相关 CSV 并通过 Gate 5b;Phase 6 交付报告,自动聚合前序阶段输出生成标准化报告。

使用方式上,模板强调禁止跳步规则与 Phase 依赖矩阵:缺少接口文档时禁止进入设计阶段,用户未确认设计文档前禁止写 CSV,用户未确认 CSV 用例前禁止写代码,用例未设计完禁止测试,全量回归未通过禁止交付。Agent 启动时需先执行 git log、检查 working_files 目录,判断当前所处阶段并校验下一阶段前置 Gate。接口文档获取失败时禁止从代码反推,需由用户提供文档。

适用场景为 ATB 算子在 910B/950 设备上的 OPS→ACLNN 接口迁移及配套测试验证。限制方面,资料未提供具体实现代码细节、适用算子范围之外的性能数据与效果保证;相关环境路径(如 ATB_REPO_PATH、CANN_PATH)与接口文档链接需使用者自行提供,未提供时无法执行对应阶段。