用途：仅适用于阿里云 ECS 上的 Linux GuestOS，针对用户指定的目标实例诊断异常问题。代理可运行在目标实例或其他机器上，通过 aliyun CLI 远程诊断并采集数据。
适用场景：启动或运行状态与 OS 状态不一致、远程登录失败、网络连通性失败、磁盘扩容或挂载问题、性能异常、崩溃或挂起、时钟漂移、配置不生效等。不适用：非阿里云 ECS、非 Linux GuestOS、其他云或物理机，以及不涉及 GuestOS 的纯控制面、计费或 API 侧问题。
主要能力与流程：按六个阶段执行——澄清异常问题、归类现象域、确认是否为 GuestOS 问题、诊断工具调查、GuestOS 内部组件调查、总结与建议。先调用 DescribeInstances 查询实例信息；实例已释放或不可达时进入降级模式。使用 references/symptom-to-domain.md 选择现象域，再打开对应 references/<slug>.md 排查文档。
使用方式：除 references/utils/guestos-pe-prep.md 外，仅可使用 references/aliyun-cli-cheatsheet.md 中列出的子命令。采集 GuestOS 内部数据时使用 aliyun ecs run-command 调用 RunCommand。每条 aliyun CLI 命令必须带 --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ecs-linux-os-troubleshooting/{session-id}，同一排查会话复用同一 session-id，不同会话不得复用。
限制与安全：执行前需按 references/ram-policies.md 配置最小权限 RAM 动作。所有用户提供或模型推导的值须先校验，如 --biz-region-id 仅允许 cn-hangzhou 形式，实例、磁盘、镜像、安全组、ENI、诊断报告、invoke ID 需带产品前缀并拒绝空白、引号、shell 元字符、命令替换或换行；JSON 参数用序列化器构建；时间窗口仅接受 ISO 8601 且 StartTime <= EndTime。轮询默认每 10 至 20 秒一次，10 分钟或 30 次后停止并报告最后状态。仅提供结论与修复建议，不执行修复操作，除非用户明确要求。报告中不得包含密钥、密码、访问密钥或完整敏感命令输出。多实例需分别排查，不得用实例 A 的结果推断实例 B。
其他：诊断报告使用 references/diagnosis-report-template.md 模板，须包含目标实例、地域、现象域、确认的问题边界、关键证据、结论置信度和建议的后续操作。若根因仍不确定，列出已排除的候选根因并给出下一步排查建议。具体收费、价格与平台支持范围暂未提供。