external-gitcode-ascend-skills

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/<domain>/... 是本地 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-name>` 安装单 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 等。

---

开发目录

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

分类入口	适合维护什么
skills/	所有本地 skills 的统一入口，按 base / inference / training / profiling / ops / agent-tools / ai-for-science 分类组织
external/	外部同步 skills

维护时注意：

• 所有本地 skill 目录都已下沉到 skills/ 下。
• skills/README.md 继续按功能域分流。
• 新增或维护本地 skill 时，放到 skills/<domain>/...，不要再在 root 下加平行目录。

官方推荐安装包

安装包	适合谁	包含内容
ascend-base	所有新同学	基础环境、服务器连接、容器环境、设备检查、硬件诊断、虚拟化与 PyTorch NPU 基础能力
ascend-inference	推理、模型转换、服务部署	ATC、vLLM-Ascend、vLLM 服务部署、在线压测、ais-bench、量化、Diffusers、Wan 适配
ascend-training	训练、通信、MindSpeed-LLM、MindSpeed-MM、VERL	HCCL、torch 通信测试、MindSpeed-LLM/MM 全流程、VERL quickstart
ascend-profiling	Profiling 采集、性能分析	Profiling 分析、训练 Profiling 采集、MFU 分析
ascend-ops	算子开发、迁移、调优	AscendC、op-plugin、Triton-Ascend 迁移、算子基准测试
ascend-ai-for-science	AI for Science 专项用户	AI for Science 总入口及其子技能

ascend-profiling 和 ascend-ops 的区别：

• 选 ascend-profiling：你已经有模型/训练任务，重点是采集 Profiling、定位性能瓶颈、分析 hostbound / computing / communication。
• 选 ascend-ops：你要做的是算子开发、算子迁移、op-plugin 接入、Triton-Ascend 改写或算子级调优。

领域技能包

如果方向已经很明确，可以直接装更细的领域技能包：

技能包	说明
mindspeed-llm-skills	MindSpeed-LLM 训练全流程
mindspeed-mm-skills	MindSpeed-MM 多模态训练全流程
diffusers-ascend-skills	Diffusers 环境、权重准备与推理
profiling-analysis	Profiling 分析技能集
ai-for-science	AI for Science 技能集
hiascend-forum	昇腾社区论坛抓取与反馈问题分析

手动安装

如果无法使用 npx，可以手动复制所需的 skill 目录。

方式一：项目级安装（推荐）

将所需 skill 复制到项目根目录的 .agents/skills/ 下：

# 克隆仓库
git clone https://github.com/ascend-ai-coding/awesome-ascend-skills.git

# 复制基础环境相关 skills 到项目目录
cp -r awesome-ascend-skills/skills/base/npu-smi your-project/.agents/skills/
cp -r awesome-ascend-skills/skills/base/ascend-docker your-project/.agents/skills/
cp -r awesome-ascend-skills/skills/base/torch_npu your-project/.agents/skills/