external-cannbot-ops-ascendc-blaze-best-practice
Installation
SKILL.md
Ascend C Matmul 单算子生成(Blaze 路径)
该能力解决 Matmul 单算子生成场景下的问题:tensor_api/Blaze API 约束确认、三模板选型(纯AIC / StreamK / FixpOpti)、统一工程模板复用、SWAT/全载 Tiling 改造、流水与排错。
架构限定:核心验证在
DAV_3510。其他架构必须在 DESIGN.md 中显式说明差异并给出适配方案。
首次使用:
matmul_custom/依赖tensor_api/,首次需拉取外部依赖。步骤见matmul_pattern.md§0.5.0。
何时使用
满足以下任一条件时使用该能力:
- 算子类型为 Matmul 族(GEMM/BMM/量化 matmul/matmul+bias/mxfp8 matmul)。
- 代码或讨论中出现
tensor_api、blaze等信号。 - 需要选择模板(纯AIC/StreamK/FixpOpti)、切换 dispatch mode(NO_FULL/A_FULL/B_FULL_LOAD)、进行 Tiling 改造或流水排错。
不要把该能力当成默认算子开发路径的通用替代品。Vector 类逐元素/归约算子、matmul+eltwise 深度融合(含激活/残差等 Vector 后处理)、matmul+softmax 等不在本 skill 模板直接覆盖范围内;这些场景使用本 skill 的 FixpOpti 模板做 Cube 段,epilogue 部分需自行扩展。