该技能面向阿里云灵骏(Lingjun)机架级 GPU 裸金属节点,用于处理 GPU/HBM ECC、网卡链路抖动、NCCL 挂起、内核 panic、RDMA 降级、AI 任务日志异常等故障,形成“诊断→报告→修复”的闭环,基于 eflo-controller(v2022-12-15)OpenAPI。
主要能力分八项:资源定位(list-clusters / describe-cluster / list-cluster-nodes / list-cluster-hyper-nodes / describe-node / describe-hyper-node);提交诊断任务(create-diagnostic-task,DiagnosticType 取 BasicCheck / NodeHardwareCheck / CheckByAiJobLogs,NetConfigCheck 与 NetRuntimeCheck 已废弃);查询单次诊断结果(describe-diagnostic-result);浏览诊断历史(list-diagnostic-results,支持分页与 --diag-type 过滤);生成 Markdown 诊断报告(目标标识、判定结论、逐项检查表、证据);生成修复计划(映射到 reboot-nodes / reimage-nodes / stop-nodes / report-node-status,长期移除交由集群扩缩容技能);辅助遥测(list-syslogs、节点硬件计数);故障上报跟踪(report-node-status 后经 list-fault-reports / describe-fault-report 跟踪,stop-node-diagnostic 停止诊断,approve-operation 审批维护建议)。
环境准备:先确认 aliyun 版本不低于 3.3.3,否则执行 curl -fsSL --connect-timeout 10 --max-time 120 https://aliyuncli.alicdn.com/setup.sh | bash,再用 aliyun version 校验。安装插件:aliyun configure set --auto-plugin-install true、aliyun plugin install --name eflo-controller、aliyun plugin update。认证仅用 aliyun configure list 检查,禁止运行 aliyun configure get / configure show,禁止回显 AccessKey,输出需脱敏。权限按只读定位、诊断读写、修复变更、故障跟踪四组 RAM 策略划分。
使用前需执行会话级一次性自检:export LJ_SKILL_DIR="${LJ_SKILL_DIR:-$HOME/.qoder/skills/alibabacloud-lingjun-node-diagnose}" 并 source "$LJ_SKILL_DIR/lib/lj_init.sh",确认 safe_aliyun 已加载,否则拒绝发出任何 CLI;所有调用须经 safe_aliyun 包装,不允许裸调 aliyun。所有变更类 CLI(含 create-diagnostic-task)必须走 safe_mutate 两阶段确认,第二阶段需用户回复「确认」或 confirm 才提交;禁推断字段(如 ImageId / Hostname / LoginPassword / Description / IssueCategory / Reason / ReportId)不得由模型自动填充或沿用历史值,须经人工选择。命令必须同时显式指定 --endpoint eflo-controller.<region>.aliyuncs.com 且与 --region 完全一致;未指定区域时禁止默认或沿用,需用户从 describe-regions 列表中选择(仅 describe-regions 可临时使用 cn-hangzhou)。分页列表须跟踪 NextToken 至末页,单查询软上限 50 页/1000 条,超限需人工决策。失败重试白名单为网络层、5xx 与瞬时错误,最多 3 次指数退避,限流固定等待 60 秒;鉴权与 403 等业务错误不重试。
报告与计划必须基于真实 CLI 返回的 JSON,禁止编造 DiagnosticId、RequestId、检查项状态或“节点已恢复”等结论;每次输出需标注执行成功、已提交待轮询、执行失败或未执行,若本会话无真实 API 调用须说明云侧未发生变更。具体产物模板、禁止推断字段清单及边界用例详见技能内的 parameter-confirmation.md、mutating-schemas/、endpoint-routing.md 与 edge-cases.md。