这是一个给昇腾 NPU 开发者使用的 skills 仓库。内容按 Skill 组织，可被 Claude Code、OpenCode、Cursor、Trae、Codex 等 AI 编程工具读取。

• GitHub 页面：https://ascend-ai-coding.github.io/awesome-ascend-skills/
• skills.sh：https://skills.sh/ascend-ai-coding/awesome-ascend-skills

---

目录

• 简介
• 快速开始
• 安装指南
• 开发目录
• Skill导航
• 外部技能
• Skill 工作原理
• 治理规范
• 贡献指南
• 提交 PR
• 官方文档
• 许可证

---

简介

超棒的Ascend Skills 收集昇腾 NPU 开发中常用的排障、部署、迁移和分析经验。仓库里主要有四类内容：

• 单个 技能：处理一个明确问题，比如 npu-smi、hccl-test
• 领域技能包：把同一方向的多个子 技能放在一起，比如 mindspeed-llm-skills
• 官方安装包：按常见工作方向拆好的 bundle，比如 ascend-base、ascend-inference
• 外部同步 skills：从其他 Ascend 技能 仓库同步进来的内容

当前目录模型：

• 所有本地 skills 统一位于 skills/
• skills/ /... 是本地 skill 的唯一正式路径
• external/ 是外部同步 skills 的独立目录，不参与本地路径规则

第一次使用时，不必从完整列表里一个个挑。先看 快速开始，确定自己要装哪个方向，再去 安装指南 执行命令。

---

快速开始

我应该先装什么？

推荐路径

1. 第一次用，先装 ascend-base
2. 按任务追加 ascend-inference、ascend-training、ascend-profiling、ascend-ops
3. 只有明确知道要用哪个 skill 时，再安装单个 leaf skill

---

安装指南

推荐安装方式

使用 npx 安装到支持 Skills 的 AI 编程工具中。新同学先装对应方向的目录即可，不要一上来把全部 skills 都装进去：

支持的 AI 编程工具：Claude Code、OpenCode、Cursor、Trae、Codex 等。

---

开发目录

如果你要维护仓库、补充 skill，先看这两个入口：

Awesome Ascend Skills

这是一个给昇腾 NPU 开发者使用的 skills 仓库。内容按 Skill 组织，可被 Claude Code、OpenCode、Cursor、Trae、Codex 等 AI 编程工具读取。

• GitHub Pages: https://ascend-ai-coding.github.io/awesome-ascend-skills/
• skills.sh: https://skills.sh/ascend-ai-coding/awesome-ascend-skills

---

目录

• 简介
• 快速开始
• 安装指南
• 开发目录
• Skill 导航
• 外部 Skills
• Skill 工作原理
• 治理规范
• 贡献指南
• 提交 PR
• 官方文档
• 许可证

---

简介

Awesome Ascend Skills 收集昇腾 NPU 开发中常用的排障、部署、迁移和分析经验。仓库里主要有四类内容：

• 单个 skill：处理一个明确问题，比如 npu-smi、hccl-test
• 领域技能包：把同一方向的多个子 skill 放在一起，比如 mindspeed-llm-skills
• 官方安装包：按常见工作方向拆好的 bundle，比如 ascend-base、ascend-inference
• 外部同步 skills：从其他 Ascend skill 仓库同步进来的内容

当前目录模型：

• 所有本地 skills 统一位于 skills/
• skills//... 是本地 skill 的唯一正式路径
• external/ 是外部同步 skills 的独立目录，不参与本地路径规则

第一次使用时，不必从完整列表里一个个挑。先看 快速开始，确定自己要装哪个方向，再去 安装指南 执行命令。

---

快速开始

我应该先装什么？

Start
├─ 你是第一次使用，或者还不确定该装什么？
│  ├─ Yes → 先安装 `ascend-base`
│  └─ No  → 进入下一步
│
├─ 你的主要任务是什么？
│  ├─ 推理 / 模型转换 / 服务部署
│  │  └─ 安装 `ascend-base` + `ascend-inference`
│  ├─ 训练 / 通信 / MindSpeed-LLM
│  │  └─ 安装 `ascend-base` + `ascend-training`
│  ├─ Profiling 采集 / 性能瓶颈分析
│  │  └─ 安装 `ascend-base` + `ascend-profiling`
│  ├─ 算子开发 / Triton 迁移 / op-plugin 接入 / 算子调优
│  │  └─ 安装 `ascend-base` + `ascend-ops`
│  ├─ AI for Science 专项工作
│  │  └─ 安装 `ascend-base` + `ascend-ai-for-science`
│  └─ 我只想要一个非常具体的能力
│     └─ 使用 `-s ` 安装单 skill
│
└─ 仍然拿不准？
   └─ 先装 `ascend-base`，再按下面安装指南追加对应 bundle

推荐路径

1. 第一次用，先装 ascend-base
2. 按任务追加 ascend-inference、ascend-training、ascend-profiling、ascend-ops
3. 只有明确知道要用哪个 skill 时，再安装单个 leaf skill

---

安装指南

推荐安装方式

使用 npx 安装到支持 Skills 的 AI 编程工具中。新同学先装对应方向的目录即可，不要一上来把全部 skills 都装进去：

# 基础环境包（推荐所有新同学先装）
npx skills add https://github.com/ascend-ai-coding/awesome-ascend-skills/tree/main/skills/base -s '*'

# 推理方向
npx skills add https://github.com/ascend-ai-coding/awesome-ascend-skills/tree/main/skills/inference -s '*'

# 训练方向
npx skills add https://github.com/ascend-ai-coding/awesome-ascend-skills/tree/main/skills/training -s '*'

# Profiling / 性能分析方向
npx skills add https://github.com/ascend-ai-coding/awesome-ascend-skills/tree/main/skills/profiling -s '*'

# 算子开发 / 迁移方向
npx skills add https://github.com/ascend-ai-coding/awesome-ascend-skills/tree/main/skills/ops -s '*'

# AI for Science 方向
npx skills add https://github.com/ascend-ai-coding/awesome-ascend-skills/tree/main/skills/ai-for-science -s '*'

# 安装单个 Skill
npx skills add ascend-ai-coding/awesome-ascend-skills -s npu-smi

# 安装全部 Skills（不建议新同学直接使用）
npx skills add https://github.com/ascend-ai-coding/awesome-ascend-skills -s '*'

支持的 AI 编程工具：Claude Code、OpenCode、Cursor、Trae、Codex 等。

---

开发目录