ascend-ai-coding/awesome-ascend-skills/atb-aclnn-operator-replacement-designer

# 在 ATB 仓库中搜索目标算子的 ACLNN Runner 是否已存在
find <ATB_REPO_PATH>/src/ops/ops_infer/<op_type>/ -name '*_aclnn_runner.cpp' -type f 2>/dev/null
find <ATB_REPO_PATH>/src/ops/ops_infer/<op_type>/ -name '*_aclnn_runner.h' -type f 2>/dev/null

## 规模检测结果
 
算子: {OpType}
ATB 仓库: <ATB_REPO_PATH>
 
检测: {op_type}_aclnn_runner.{h,cpp} [✅ 已存在 / 不存在]
 
→ 使用 [轻量模板 / 完整模板] 生成设计文档。
→ 预计生成 [4 节 / 7 章] 文档。

# {OpType} OPS→ACLNN 替换设计文档（轻量版）
 
## 文档信息
| 项目 | 内容 |
|------|------|
| 算子名称 | {OpType} |
| 迁移类型 | 挂载已有 ACLNN Runner（{op}_aclnn_runner.cpp 已存在） |
| 变更范围 | 仅修改 {op}_operation.cpp 的 CreateRunner，添加 910B/950 设备检测 |
| 目标设备 | 910B / 950 |
 
## 需求简述
-将 {OpType} 算子在 910B/950 上从 OPS 切换至 ACLNN
-非 910B/950 设备保持 OPS 路径
-ACLNN Runner 已存在且通过 REG_RUNNER_TYPE 注册，仅需接入分发
 
## 参数映射关系
| ATB参数 | ACLNN参数 | 映射类型 | 说明 |
|---------|-----------|----------|------|
| [从已有 runner 代码提取] | [从已有 runner 代码提取] | [直接/计算] | |
 
## 规格约束
-数据类型: [从已有 runner 和接口文档提取]
-输入约束: [提取]
-参数约束: [提取]
-设备相关: 950 上仅支持 {受支持的变体}
 
## 风险评估
| 风险项 | 风险等级 | 应对策略 |
|--------|---------|---------|
| 设备检测逻辑错误 | 低 | 参考已有 runner (Gather/Split/Repeat) 的分发模式 |
| 变体路由错误 | 中 | 在 CreateRunner 中加严格的 layerType/quantType 过滤 |
| 非目标设备回归 | 低 | 非 910B/950 设备保持 OPS 路径不变 |

## 设计文档确认 - {OpType}（轻量版）
 
| 检查项 | 说明 | 用户确认 |
|--------|------|----------|
| 参数映射关系正确 | ATB→ACLNN 映射准确 | [ ] |
| 规格约束清晰 | 数据类型、参数约束完整 | [ ] |
| 风险评估完整 | 风险项和应对策略充分 | [ ] |

if [ -z "$CANN_PATH" ] || [ ! -f "$CANN_PATH/set_env.sh" ]; then
    echo "ERROR: CANN_PATH 未设置或无效，请用户提供。"
    exit 1
fi
if [ -z "$ATB_REPO_PATH" ] || [ ! -d "$ATB_REPO_PATH" ]; then
    echo "ERROR: ATB_REPO_PATH 未设置或无效，请用户提供。"
    exit 1
fi

## ⛔ WebFetch 失败 — 需要接口文档
 
获取以下接口文档失败：
-[URL] → [失败原因]
 
**请提供以下任一形式**：
1.可直接访问的文档 URL
2.ACLNN 开源仓中对应算子的接口头文件路径/内容
3.CANN 安装目录下的接口文档（如 `$ASCEND_TOOLKIT_HOME/opp/*/op_proto/` 下的算子定义）
4.手动提供的完整参数列表（类型、含义、约束）
 
在没有完整接口文档前，禁止进入设计阶段。

规模检测（是否存在 *_aclnn_runner.cpp）→ 接口文档分析 → 参数映射建立 → 按模板等级生成文档

## 需求详情
 
### 项目背景
为了兼容性和性能提升，需要将ATB中的{算子类型}算子替换为ACLNN算子。
 
### 需求目标
-将ATB中的{算子类型}算子替换为对应的ACLNN算子
-保持原有接口的兼容性，确保上层应用无需修改代码即可迁移
-提升算子执行性能，充分利用昇腾硬件加速能力
-确保替换后的算子功能正确性和稳定性
 
### 适用范围
本设计适用于ATB仓中的算子：
-{算子类型}算子

## 算子IR与参数配置
 
### ATB算子参数结构

 
### ACLNN算子接口

 
### 参数映射关系
| ATB参数 | ACLNN参数 | 映射关系 |
|---------|-----------|----------|
| param1 | param1 | 直接映射 |
| param2 | param2 | 计算映射 |
| param3 | - | 废弃参数 |

src/ops/ops_infer/{op_type}/{op_type}_aclnn_runner.h/cpp

## 设计文档确认 - {OpType}
 
### 待确认文档
-**设计文档路径**: `{WORKING_DIR}/{op_type}_replacement_design.md`
-**ATB 接口链接**: [用户提供的链接]
-**ACLNN 接口链接**: [用户提供的链接]
 
### 确认检查表
| 检查项 | 说明 | 用户确认 |
|--------|------|----------|
| 参数映射关系正确 | 第 2.3 节参数映射表准确反映了 ATB→ACLNN 的映射关系 | [ ] |
| 风险评估合理 | 第 6 章识别的风险项和应对策略完整 | [ ] |
| 实现方案可行 | 第 5 章实现方案符合 ATB ACLNN Runner 标准模式 | [ ] |
| 测试用例设计可行 | 第 4 章测试用例覆盖全面，可进入 CSV 设计阶段 | [ ] |
| 规格约束清晰 | 第 3 章规格约束明确，便于编写反例测试 | [ ] |
 
### 确认方式
-**通过**: 回复 "确认通过" 或逐项打勾确认
-**修改**: 指出具体问题，返回修改后重新确认
 
### 后续步骤
确认通过后，将进入 Phase 2: CSV 用例设计阶段
-下一步调用: `atb-csv-testcase-generator`
 
**⚠️ 未收到用户确认前，禁止进入 CSV 用例设计阶段**

我已生成 {OpType} 算子的替换设计文档，请确认以下内容：
 
📄 **文档位置**: `{WORKING_DIR}/{op_type}_replacement_design.md`
 
请检查：
1.第 2.3 节"参数映射关系"是否正确？
2.第 6 章"风险评估"是否遗漏重要风险？
3.第 5 章"实现方案"是否符合预期？
4.第 4 章"开发自测"是否覆盖全面？
 
回复 "确认通过" 进入 CSV 用例设计阶段，或指出需要修改的地方。