alibabacloud-ecs-linux-troubleshooting
Troubleshoot an Alibaba Cloud ECS Linux instance. Use when user needs to troubleshoot a problem on the specified ECS Linux instance, such as: boot stuck, SSH/VNC/Workbench, network, disk/FS, performance, crash/hang, clock, config, etc.
npx skills add aliyun/alibabacloud-ecs-troubleshoot-skills --skill alibabacloud-ecs-linux-troubleshooting --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# ECS Linux 问题排查 本技能**仅适用于阿里云 ECS 上的 Linux GuestOS**，针对用户指定的阿里云 ECS Linux 实例（目标机）进行异常问题排查。Agent 运行在目标机或他机上，通过 aliyun CLI 工具对目标 ECS 实例进行远程诊断与数据采集。 ## 何时使用本技能 - 用户指定的排查对象为阿里云 ECS Linux 实例时。 - 用户描述涉及启动/运行状态与 OS 不符、远程登录失败、网络不通、磁盘/扩容/挂载、性能异常、宕机夯机、时钟、配置不生效等异常问题时。 - **不适用**：非阿里云 ECS、非 Linux GuestOS、其它云或物理机；纯管控/计费/API 侧问题且无 GuestOS 参与 ## 原则与要求 1. **排查对象 = 用户指定的阿里云 ECS Linux 实例**：所有检查、结论都针对这一台机器。`references/` 中的命令、路径等按实例内环境编写。 2. **使用 aliyun CLI 工具进行远程诊断和数据采集。**：要求除 [`references/utils/guestos-pe-prep.md`](references/utils/guestos-pe-prep.md) 中步骤外其他步骤只能使用[`references/aliyun-cli-cheatsheet.md`](references/aliyun-cli-cheatsheet.md)中列出的子命令，**不得调用未列出的子命令**。 3. **先搞清问题再查**：严格遵循**排查流程**，需要先把用户描述收敛为**现象域**，再按**排查文档**执行排查。 4. 优先按照`references/<slug>.md` 排查文档中描述运行排查所需命令，**不要盲目自行猜测命令**。 5. **多实例场景**：每台 ECS 须分别执行排查，不要混用 A 机的结果去结论 B 机。 ## 排查流程 **必须按序执行** ### 阶段 1：异常问题澄清 在打开任何域文档前，如果用户问题描述较模糊时**先通过多轮对话细化问题**，并通过 **aliyun CLI** 和 **向用户询问** 尽量补齐异常问题发生的证据和相关的环境信息，通常会涉及以下信息： | 维度 | 要补齐的内容 | 获取方式 | | --- | --- | --- | | **实例基本信息、状态、规格** | 实例状态 | 按需调用 aliyun CLI | | **范围** | 是否必现；起止时间；异常问题发生时是否存在变更、重启、扩缩容 | 向用户询问 | | **通道** | VNC 是否可用；SSH/Workbench/云助手是否可用 | 向用户询问 | | **网络方向** | 外部→实例业务端口、实例→外部网络、仅 VPC 内互通等 | 向
- 何时使用本技能
- 原则与要求
- 排查流程
- 阶段 1：异常问题澄清
- 阶段 2：归类到现象域
- 阶段 3：确认是否属于 GuestOS 问题
- 阶段 4：诊断工具排查
- 阶段 5：GuestOS 内问题相关组件排查
- 阶段 6: 总结与建议
- 流程总览
- 引用文档索引
What does the alibabacloud-ecs-linux-troubleshooting skill do?
Troubleshoot an Alibaba Cloud ECS Linux instance. Use when user needs to troubleshoot a problem on the specified ECS Linux instance, such as: boot stuck, SSH/VNC/Workbench, network, disk/FS, performance, crash/hang, clock, config, etc.
How do I install it?
Run `npx skills add aliyun/alibabacloud-ecs-troubleshoot-skills --skill alibabacloud-ecs-linux-troubleshooting --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From aliyun/alibabacloud-ecs-troubleshoot-skills, a repository with 160 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.