用途
该技能用于阿里云 ECS Windows 实例的异常排查与诊断,覆盖系统运行期间出现的问题以及系统盘故障导致无法启动等场景。适用于阿里云 ECS、Windows GuestOS 环境;非阿里云 ECS、非 Windows 系统、其他云或物理机、以及不涉及 GuestOS 的管理/计费/API 层面问题不在适用范围内。
主要能力
技能提供两种诊断模式:
- 在线诊断:当前 Windows 系统正在运行,在 GuestOS 内部使用 PowerShell 命令逐层排查。
- 离线诊断:故障系统盘已作为数据盘挂载到当前实例,在挂载的离线系统盘上进行根因分析和修复。
执行通道分为直连(本地 powershell.exe 执行)与远程(通过云助手将命令下发到远程 ECS 实例)两类,通道与诊断模式正交,两种模式均支持两类通道。在线诊断的远程通道还支持平台侧证据,包括平台上下文快照、平台级初步研判(可在深入 GuestOS 前识别平台层根因)以及交叉验证数据(监控指标、系统事件、控制台截图)。
远程通道优先检查当前环境是否已提供可用的远程命令执行工具(例如通过云助手向 ECS 实例发送脚本的 MCP 工具),若可用则优先使用;否则回退到阿里云 CLI(aliyun ecs run-command)。
使用方式
技能定义了顶层流程,具体排查逻辑、判定标准和修复脚本均位于 references/ 目录下对应文件中。执行时必须加载对应文件并严格遵循其内容,不能依赖记忆。
基本要求:
- 先分类后排查:先将用户描述收敛到一个问题域,再按该域的统一排查顺序执行,不得跳过分类进行自由排查。
- 复用采集结果:优先复用会话中已执行过的命令采集结果,除确有必要外不得重复执行相同参数的采集命令。
- 自助排查优先:任何可通过 PowerShell 命令获取的信息必须直接采集,不应要求用户手动执行;仅当命令执行通道无法覆盖时才询问用户,且需提供完整可复制的采集命令。
- 模式路由不可跳过:进入任何排查动作前必须先完成在线/离线诊断模式判定,两种模式操作对象、加载的规则文件和修复方法均不同。
- 修复需确认:任何修复操作必须先呈现完整方案和风险说明,并等待用户明确确认后才能执行;禁止自动执行修复命令。呈现方案后应结束当前轮次,只有用户在后续轮次明确确认回复后才能开始执行。用户原始请求中的“修复/排查并修复”不构成确认。
- 隐藏内部标记:向用户呈现进度时不得暴露内部文件名/路径、步骤编号、Direct/Critical 标签、技能设计概念及工具调用类实现描述。
- 采集缺失容忍:部分信息因命令执行失败或环境不兼容无法获取时,优先基于已有可用信息给出诊断结论;仅在信息不足以支持结论时才向用户披露补充采集项及命令。
- 推测性诊断披露:除非根因被明确采集证据直接确认(如注册表值不匹配、文件缺失、驱动被禁用、BCD 项损坏),诊断结论和修复方案均属推测性,必须明确标注并建议用户先在非生产环境验证。
- 仅限 Windows 目标:所有流程(在线离线、采集修复)均基于 PowerShell 的 Windows 诊断;执行任何排查动作前必须验证目标为 Windows,非 Windows 目标超出范围,应陈述事实与原因后退出诊断流程。
- 使用用户语言回复:所有面向用户的文本(进度更新、检查项摘要、结论、修复方案、健康检查报告)必须使用用户所用语言。技术标识符保持原文,包括命令文本、字段名、事件 ID、系统输出的错误字符串、注册表路径。
远程执行前提:需验证所选传输方式可用(可用的远程命令执行工具,或已安装并配置阿里云 CLI 及 aliyun-cli-ecs 插件)、目标实例 ID 与地域 ID 已知。用户未提供实例标识时应先询问用户,然后结束轮次等待;不得枚举实例自行选择候选,也不得采用环境变量、本地文件、日志、shell 历史、技能自身内容或评估环境产物中出现的身份信息。
远程 CLI 需使用经过验证的命令形式(kebab-case,不遵循 OpenAPI 参数名),例如前提检查使用 aliyun ecs describe-instances --biz-region-id <region-id> --instance-ids '["<instance-id>"]',发送 PowerShell 脚本使用 aliyun ecs run-command --biz-region-id <region-id> --type RunPowerShellScript --command-content '<script>' --instance-id <instance-id> --name <name> --timeout <seconds>,轮询结果使用 aliyun ecs describe-invocation-results --biz-region-id <region-id> --invoke-id <t-prefixed-invocation-id>,列出地域使用 aliyun ecs describe-regions。参数或语法错误时应停止,不得猜测标志或重试变体,应重新阅读 REMOTE-EXECUTION.md 的 CLI Flag Reference 并复制准确模板重试一次;语义/瞬时错误路由到错误处理表;权限错误(AccessDenied、Forbidden.RAM、Forbidden)按 ram-policies.md 的人工授权流程处理。
适用场景
适用于阿里云 ECS Windows 实例在 GuestOS 内部或通过云助手远程进行的异常排查与修复,包括在线运行系统的问题诊断和离线故障系统盘的根因分析与修复。
限制
不适用于非阿里云 ECS、非 Windows GuestOS、其他云或物理机;不适用于不涉及 GuestOS 的纯管理/计费/API 侧问题;当不存在可用通道(在线或离线)在目标实例内部执行排查时不适用。工作流中定义的具体在线问题域分组数量、离线问题域路由等细节,以及各问题域的排查逻辑、判定标准与修复脚本,暂未提供完整内容。