| name | ascend-envcheck |
| description | 执行 K8s Master 节点的 envCheck.sh 环境检测脚本。当用户询问"集群状态"、"K8s集群状态"、"环境检测"、"Ascend环境检查"、"任务为什么没调度起来"、"任务为什么pendding"、"NPU状态"或要求执行集群状态检测时使用。需要用户提供 master 节点 IP、用户名，以及密码或 SSH 密钥路径其中之一。 |
Ascend 环境检测
触发条件
当用户提出以下需求时激活此 skill：
- 询问集群状态 / K8s 集群状态
- 执行环境检测 / Ascend 环境检查
- 检查 NPU 设备状态
- 验证节点标签配置
重要前提/约束
envCheck.sh 依赖 kubectl（这些依赖在脚本实际运行的那台机器上必须存在，部分检测内容依赖jq工具，非强制，如需要jq工具但没有时，可以提示用户安装）- 不支持在windows系统上执行。
- 不要在返回内容里泄露用户的密码/私钥内容；日志里需要对敏感字段做脱敏。
必需信息
执行前必须向用户获取：
- Master IP: K8s master 节点的 IP 地址
- 用户名: SSH 登录用户名（通常为 root）
- 认证方式（二选一）:
- 密码: SSH 登录密码
- 密钥路径: SSH 私钥文件路径（如
~/.ssh/id_rsa）
连接方式
方式一：密码认证
检查集群状态，IP 192.168.9.143，用户 root，密码 ***
方式二：SSH 密钥认证
检查集群状态，IP 192.168.9.143，用户 root，密钥 ~/.ssh/id_rsa
密钥方式无需提供密码，适合已配置 SSH 密钥登录的环境。
执行方式
- 通过 SSH 连接到 master 节点（密码或密钥）
- 上传
scripts/envCheck.sh 到目标主机 /tmp/ 目录，并在文件名后增加当前时间，如 /tmp/envCheck_20260316_174737.sh
- 执行脚本并输出执行结果（不做任何修改或摘要）
- 对结果进行摘要、解释和格式化，预测下一步可能需要的操作
- 执行结束后，删除目标主机上上传的临时脚本(保证只安全删除对应脚本，不得删除其他文件)
脚本参数
envCheck.sh 支持以下参数：
用法: ./envCheck.sh [期望NPU卡数量] [产品类型] [-r|--resources]
| 参数 | 说明 | 默认值 |
|---|
| 期望NPU卡数量 | 预期的 NPU 卡数量 | 16 |
| 产品类型 | 产品配置类型 | none |
| -r, --resources | 启用内存和 CPU 资源检查 | 关闭 |
可选产品类型
| 类型 | 说明 |
|---|
| none | 不检测标签（默认） |
| full-910 | Atlas 800 训练服务器（NPU满配） |
| half-910 | Atlas 800 训练服务器（NPU半配） |
| a2-pod | Atlas 800T A2 / Atlas 900 A2 PoD |
| a3-superpod | Atlas 900 A3 SuperPoD 超节点 |
| a3-box8 | A200T A3 Box8 超节点服务器 |
| a2-infer | Atlas 800I A2 推理服务器 |
| a2-box | A200I A2 Box 异构组件 |
| a2-box16 | Atlas 200T A2 Box16 异构子框 |
| train-card | 训练服务器（Atlas 300T 训练卡） |
| infer-card | 推理服务器（Atlas 300I 推理卡） |
| infer-series | Atlas 推理系列产品 |
| soc-core | Atlas 200I SoC A1 核心板 |
执行示例
密码认证：
检查集群状态，IP 192.168.9.143，用户 root，密码 ***
密钥认证：
检查集群状态，IP 192.168.9.143，用户 root，密钥 ~/.ssh/id_rsa
带脚本参数：
检查集群状态，8卡 half-910 配置，检查资源
输出要求
先直接原样输出 envCheck.sh 的执行结果，包括：
再对输出做摘要、解释或格式化，以及下一步可能需要的操作。
技术实现
密码认证方式
sshpass -p '<password>' scp -o StrictHostKeyChecking=no \
scripts/envCheck.sh <user>@<ip>:/tmp/envCheck.sh
sshpass -p '<password>' ssh -o StrictHostKeyChecking=no \
<user>@<ip> "chmod +x /tmp/envCheck.sh && bash /tmp/envCheck.sh <args>"
SSH 密钥认证方式
scp -o StrictHostKeyChecking=no -i <key_path> \
scripts/envCheck.sh <user>@<ip>:/tmp/envCheck.sh
ssh -o StrictHostKeyChecking=no -i <key_path> \
<user>@<ip> "chmod +x /tmp/envCheck.sh && bash /tmp/envCheck.sh <args>"
依赖
- 本地:
sshpass (密码认证时需要)ssh/scp (密钥认证时使用)
- 远程:
kubectl, jq (可选，如无 jq 部分检测项会降级)
Resources
scripts/
envCheck.sh - 主检测脚本，检查 K8s 集群、NPU 设备、节点标签、资源状态等
