How do I install the External Cannbot Ops Ascendc API Best Practices skill?

Run npx skillmds@latest add ascend-ai-coding/external-cannbot-ops-ascendc-api-best-practices in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is External Cannbot Ops Ascendc API Best Practices safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with External Cannbot Ops Ascendc API Best Practices?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is External Cannbot Ops Ascendc API Best Practices free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under UNKNOWN.

Who published External Cannbot Ops Ascendc API Best Practices?

ascend-ai-coding (@ascend-ai-coding) published this skill. Their other Agent Skills are listed on their SkillMD profile.

External Cannbot Ops Ascendc API Best Practices by ascend-ai-coding

Name: External Cannbot Ops Ascendc API Best Practices
Author: ascend-ai-coding

External Cannbot Ops Ascendc API Best Practices

Ascend C API 使用最佳实践。提供算术、归约、数据搬运、Buffer管理、精度转换等 API 的正确用法和限制说明。触发：用户询问具体 API 用法（如"DataCopy 怎么用"）、遇到 API 参数错误或限制报错（如 repeatTimes、对齐问题）、需要查看 API 最佳实践或避坑指南时。

ascend-ai-coding 71f3869 13 files · 81.9 KB Updated Sep 17, 2026

File contents

Ascend C API 最佳实践

API 类别索引

API 类别	涵盖 API	核心文档	典型场景
算术运算	Add, Sub, Mul, Div, Adds, Muls	api-arithmetic.md	Softmax, LayerNorm, 广播优化
归约操作	ReduceMax, ReduceSum	api-reduce.md, api-reduce-pattern.md	Softmax, LayerNorm, ReduceMean
数据搬运	DataCopy, DataCopyPad	api-datacopy.md	非对齐处理、多维搬运
Transpose / 重排	TransDataTo5HD, Gather	api-transpose.md	小通道 transpose、permute
Buffer 管理	TBuf, TQue	api-buffer.md	Double Buffer、内存规划
精度转换	Cast	api-precision.md	FP16/FP32 混合精度
流水线同步	EnQue, DeQue, SetFlag	api-pipeline.md	多级流水线、事件同步
Compare 256B对齐	Compare	api-restrictions.md	Padding 策略
repeatTime 限制	repeatTimes ≤ 255	api-repeat-limits.md	分批处理
API 限制	-	api-restrictions.md	禁用 API、编译期限制
Host Runtime	aclrtSetDevice, aclrtGetDeviceInfo	api-host-runtime.md	设备初始化、核数获取

场景索引

使用场景	相关文档	关键技巧
Softmax/LayerNorm	api-reduce.md, api-reduce-pattern.md, api-arithmetic.md	标量操作、广播优化、Buffer 复用
逐行处理（AR 模板）	api-arithmetic.md	Adds/Muls、节省 UB
Transpose / 重排	api-transpose.md	2维度转置性能
多行广播（ARA 模板）	api-arithmetic.md	BinaryRepeatParams.src1RepStride=0、分批处理
半精度加减法（FP16/BF16 Add/Sub）	api-arithmetic.md, api-precision.md	默认升精度（除非 spec 明确同量级）、in-place 复用
非对齐数据	api-datacopy.md	DataCopyPad、32 字节对齐
混合精度	api-precision.md	FP16 输入 FP32 计算
流水线优化	api-pipeline.md, api-buffer.md	Double Buffer、事件同步
性能调优	api-buffer.md, api-repeat-limits.md	Double Buffer、repeatTimes 优化
遇到 API 限制	api-restrictions.md	替代方案、避坑指南

快速参考

完整的 API 参数速查表：api-quickref.md

⛔️ API 黑名单

禁止在生产代码中使用：

API	禁止原因	替代方案	文档
`GlobalTensor::SetValue()`	效率极低	`DataCopyPad`	api-datacopy.md
`GlobalTensor::GetValue()`	效率极低	`DataCopyPad`	api-datacopy.md

限制使用的 API：

API	限制条件	说明	文档
`DataCopy(GM↔UB)`	仅当搬运数据严格 32 字节对齐时允许使用	非对齐场景必须使用 `DataCopyPad`	api-datacopy.md

仅允许调试时使用：

// ✅ 调试：单点验证
AscendC::printf("debug: xGm[0]=%f\n", xGm.GetValue(0));

---name: external-cannbot-ops-ascendc-api-best-practicesdescription: Ascend C API 使用最佳实践。提供算术、归约、数据搬运、Buffer管理、精度转换等 API 的正确用法和限制说明。触发：用户询问具体 API 用法（如"DataCopy 怎么用"）、遇到 API 参数错误或限制报错（如 repeatTimes、对齐问题）、需要查看 API 最佳实践或避坑指南时。license: UNKNOWN---# Ascend C API 最佳实践---## API 类别索引| API 类别 | 涵盖 API | 核心文档 | 典型场景 ||---------|---------|---------|---------|| **算术运算** | Add, Sub, Mul, Div, Adds, Muls | [api-arithmetic.md](references/api-arithmetic.md) | Softmax, LayerNorm, 广播优化 || **归约操作** | ReduceMax, ReduceSum | [api-reduce.md](references/api-reduce.md), [api-reduce-pattern.md](references/api-reduce-pattern.md) | Softmax, LayerNorm, ReduceMean || **数据搬运** | DataCopy, DataCopyPad | [api-datacopy.md](references/api-datacopy.md) | 非对齐处理、多维搬运 || **Transpose / 重排** | TransDataTo5HD, Gather | [api-transpose.md](references/api-transpose.md) | 小通道 transpose、permute || **Buffer 管理** | TBuf, TQue | [api-buffer.md](references/api-buffer.md) | Double Buffer、内存规划 || **精度转换** | Cast | [api-precision.md](references/api-precision.md) | FP16/FP32 混合精度 || **流水线同步** | EnQue, DeQue, SetFlag | [api-pipeline.md](references/api-pipeline.md) | 多级流水线、事件同步 || **Compare 256B对齐** | Compare | [api-restrictions.md](references/api-restrictions.md#21-compare-api-256字节对齐约束) | Padding 策略 || **repeatTime 限制** | repeatTimes ≤ 255 | [api-repeat-limits.md](references/api-repeat-limits.md) | 分批处理 || **API 限制** | - | [api-restrictions.md](references/api-restrictions.md) | 禁用 API、编译期限制 || **Host Runtime** | aclrtSetDevice, aclrtGetDeviceInfo | [api-host-runtime.md](references/api-host-runtime.md) | 设备初始化、核数获取 |---## 场景索引| 使用场景 | 相关文档 | 关键技巧 ||---------|---------|---------|| **Softmax/LayerNorm** | [api-reduce.md](references/api-reduce.md), [api-reduce-pattern.md](references/api-reduce-pattern.md), [api-arithmetic.md](references/api-arithmetic.md) | 标量操作、广播优化、Buffer 复用 || **逐行处理（AR 模板）** | [api-arithmetic.md](references/api-arithmetic.md) | Adds/Muls、节省 UB || **Transpose / 重排** | [api-transpose.md](references/api-transpose.md) | 2维度转置性能 || **多行广播（ARA 模板）** | [api-arithmetic.md](references/api-arithmetic.md) | BinaryRepeatParams.src1RepStride=0、分批处理 || **半精度加减法（FP16/BF16 Add/Sub）** | [api-arithmetic.md](references/api-arithmetic.md), [api-precision.md](references/api-precision.md) | 默认升精度（除非 spec 明确同量级）、in-place 复用 || **非对齐数据** | [api-datacopy.md](references/api-datacopy.md) | DataCopyPad、32 字节对齐 || **混合精度** | [api-precision.md](references/api-precision.md) | FP16 输入 FP32 计算 || **流水线优化** | [api-pipeline.md](references/api-pipeline.md), [api-buffer.md](references/api-buffer.md) | Double Buffer、事件同步 || **性能调优** | [api-buffer.md](references/api-buffer.md), [api-repeat-limits.md](references/api-repeat-limits.md) | Double Buffer、repeatTimes 优化 || **遇到 API 限制** | [api-restrictions.md](references/api-restrictions.md) | 替代方案、避坑指南 |---## 快速参考完整的 API 参数速查表：[api-quickref.md](references/api-quickref.md)---## ⛔️ API 黑名单**禁止在生产代码中使用**：| API | 禁止原因 | 替代方案 | 文档 ||-----|---------|---------|------|| `GlobalTensor::SetValue()` | 效率极低 | `DataCopyPad` | [api-datacopy.md](references/api-datacopy.md) || `GlobalTensor::GetValue()` | 效率极低 | `DataCopyPad` | [api-datacopy.md](references/api-datacopy.md) |**限制使用的 API**：| API | 限制条件 | 说明 | 文档 ||-----|---------|------|------|| `DataCopy(GM↔UB)` | 仅当搬运数据**严格 32 字节对齐**时允许使用 | 非对齐场景必须使用 `DataCopyPad` | [api-datacopy.md](references/api-datacopy.md) |**仅允许调试时使用**：```cpp// ✅ 调试：单点验证AscendC::printf("debug: xGm[0]=%f\n", xGm.GetValue(0));```

Frequently asked questions