用途:该技能面向 ATB 算子向 ACLNN 算子迁移场景,帮助开发者根据 ATB 与 ACLNN 接口文档自动生成结构化替换设计文档,减少手工整理参数映射与风险分析的工作量。
主要能力:
- 规模检测:在 ATB 仓库中查找目标算子的 *_aclnn_runner.cpp/.h 是否存在及其注册情况,决定使用轻量模板还是完整模板。
- 接口文档分析:解析 ATB 算子参数结构与 ACLNN 接口定义,提取参数和约束条件。
- 参数映射:建立 ATB 到 ACLNN 的参数映射关系,区分直接映射、计算映射、废弃参数和新增参数。
- 文档生成:完整模板包含需求详情、算子 IR 与参数配置、规格说明(DFX、规格约束、功能冲突)、开发自测(功能、反例、性能测试)、实现方案、风险评估与结论等 7 章;轻量模板仅保留文档信息、需求简述、参数映射、规格约束与风险评估。
- 确认检查点:生成文档保存至 {WORKING_DIR}/{op_type}_replacement_design.md,并给出确认检查表,等待用户确认后方可进入后续阶段。
使用方式:需要用户提供 ATB 算子接口文档链接、ACLNN 算子接口文档链接,可选提供算子类型(如 LayerNorm、Softmax、RmsNorm)。同时必须提供 CANN_PATH(CANN 安装路径)与 ATB_REPO_PATH(ATB 仓库路径),否则技能会报错停止。工具通过 WebFetch 获取文档内容,若任一 URL 获取失败(包括 404/403/超时),必须停止并向用户索取可访问的文档 URL、ACLNN 开源仓头文件路径或内容、CANN 安装目录下的接口定义,或手动提供的完整参数列表;禁止从既有 runner 代码或结构体反推接口参数。
适用场景:需要将 ATB 标准算子(如 LayerNorm、Softmax、RmsNorm 等)替换为 ACLNN 算子并撰写设计文档;已有 ATB 与 ACLNN 接口文档链接;变更涉及设备(如 910B/950)上的 OPS 到 ACLNN 路径切换。
限制:必须提供有效路径与接口文档链接;WebFetch 失败即阻断,不得以代码替代官方文档;未收到用户确认前不得进入 CSV 用例设计阶段;文档中涉及的具体参数、约束与风险内容需依据接口文档和仓库实际情况生成,资料未提供具体算子的参数细节。