ascend-assistantlisted
Install: claude install-skill RevolutionLA/ascend-assistant
# Ascend Assistant · 昇腾服务器助手
让 AI Agent 帮助用户操作昇腾智算服务器的一套技能(Skill)。当用户对着一台昇腾服务器提问时,AI 依据本 Skill 安全、准确地帮你:检测环境、定位报错、��成命令、引导部署、给出调优建议。
**本 Skill 是"混合模式"**:
- **内建完成**六类通用能力(覆盖绝大多数日常提问);
- 遇到**专项深度任务**(复杂 profiling 分析、驱动自动安装、算子代码生成等),**路由到昇腾官方 `agent-skills` 中的成熟 skill**,避免重复造轮子。
配套完整手册:**[AscendMate(昇腾之家)](https://github.com/RevolutionLA/AscendMate)** —— AscendMate 负责"为什么、完整怎么做";本 Skill 负责"你手头这台机器、现在就帮我做"。
---
## 触发场景
用户意图匹配如下任一情况即触发:
- 查看昇腾服务器当前环境:设备/驱动/CANN/框架是否装好、可用性检查。
- 遇到报错:`npu-smi` 无输出、驱动装不上、CANN 环境变量报错、`torch_npu`/`MindSpore` 起不来、推理 OOM、训练失败等。
- 想生成/确认命令:安装命令、启动推理服务命令、微调脚本、性能采集命令等。
- 想从裸机一步步把昇腾服务器跑起来(部署引导)。
- 想对推理/训练做性能调优。
- 想批量检查多台服务器的健康状态(集群巡检)。
- 想了解算力利用率情况并获取优化建议(利用率分析)。
> 不触发:纯硬件采购选型、商务问题 → 引导到 [AscendMate 硬件选型](/hardware/)。
---
## 六类内建能力
### 能力一:环境检测与排障
**目标**:让用户知道服务器当前状态、问题出在哪。
**标准检测流程**(让用户按序粘贴输出,AI 逐项解读):
```bash
npu-smi info # 设备与驱动
lsmod | grep npu # 驱动内核模块
echo $ASCEND_HOME; cat /usr/local/Ascend/ascend-toolkit/latest/version.cfg
python -c "import torch; import torch_npu; print(torch.npu.device_count())"
python -c "import mindspore; mindspore.set_device('Ascend'); mindspore.run_check()"
uname -a; cat /etc/os-release
```
**快速检测(推荐)**:若用户可在服务器上跑脚本,优先让 AI 提供并运行:
```bash
# 环境一键检测
bash <(curl -sL https://raw.githubusercontent.com/RevolutionLA/ascend-assistant/master/scripts/check_env.sh)
# 或上手后本地跑
bash scripts/check_env.sh
# 常见问题快速诊断
bash scripts/quick_troubleshoot.sh
```
> AI 助手应主