使用 Skill 创建 OOS 自动化运维模板

在 AI 智能体平台的 Agent 模式对话界面中发送以下提示词，即可自动完成 Skill 添加和配置：

Install the skill "alibabacloud-oos-template-generation" from GitHub repo aliyun/alibabacloud-aiops-skills. Skill path: skills/migrationom/oos/alibabacloud-oos-template-generation. After install, inspect the skill metadata and help me finish setup.

从 GitHub 仓库下载 Skill 定义文件，按照 AI 智能体平台的文档将 Skill 文件添加到项目中。

根据运维需求生成对应的 OOS 自动化模板。Skill 自动完成需求分析、动作查询、模板生成和语法验证。

示例对话：

• "帮我生成一个重启 ECS 实例的 OOS 模板"

• "写一个自动化模板，在指定实例上执行命令"

• "创建一个定时停止 ECS 实例的运维编排模板"

Skill 从对话中提取操作类型、目标资源和地域信息，通过 CLI 查询合适的 OOS 动作，生成包含 FormatVersion、Description、Parameters 和 Tasks 的完整模板，最终调用 ValidateTemplateContent API 完成语法验证后输出。

生成针对多个资源执行批量操作的模板。Skill 使用 OOS 的 Loop 机制实现批量逻辑。

示例对话：

• "帮我写一个批量重启多个 ECS 实例的模板"

• "生成一个模板，先查询所有实例，再逐个停止"

对于批量操作，Skill 通过 Task 的 Loop 属性和 {{ ACS::TaskLoopItem }} 循环变量实现遍历逻辑，并在前置 Task 中定义 Outputs 以供后续 Task 引用。

生成包含多个步骤的复杂编排模板，支持步骤间的输出传递和条件分支。

示例对话：

• "生成一个模板：先创建快照，等快照完成后再重启实例"

• "帮我编排一个自动化任务，根据实例状态决定是否执行重启"

Skill 将需求拆解为多个 Task，通过 {{ taskName.outputField }} 格式传递步骤间的输出数据，并使用 ACS::Choice 动作实现条件分支逻辑。

Skill 在验证失败时会自动分析错误并修复。常见的错误类型包括：

• 无效动作：使用了不存在的动作名称。Skill 通过 CLI 重新查询正确的动作名称后修复。

• 属性名大小写不匹配：动作属性名的大小写必须与 API 定义完全一致。Skill 根据查询到的属性定义自动修正。

• YAML 格式错误：缩进或引号不正确。Skill 自动修正格式后重新验证。

• 缺少必填字段：如 FormatVersion、Description 或 Tasks。Skill 自动补充后重新验证。

OOS 模板生成 Skill 需要阿里云 CLI 3.3.3 及以上版本。运行以下命令安装或更新：

curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash

安装后运行 aliyun version 确认版本号。

以下动作在 OOS 中不存在，Skill 会自动使用替代方案：

引用其他 Task 输出前，该 Task 必须先定义 Outputs 块。引用格式为 {{ taskName.outputField }}。

例如，先通过 ACS::ExecuteAPI 查询实例列表并定义输出，再在后续 Task 中通过 Loop 遍历查询结果：

Tasks:
  - Name: listInstances
    Action: ACS::ExecuteAPI
    Properties:
      Service: ecs
      API: DescribeInstances
      Parameters:
        RegionId: '{{ regionId }}'
    Outputs:
      instanceIds:
        Type: List
        ValueSelector: 'Instances.Instance[].InstanceId'
  - Name: rebootInstances
    Action: ACS::ECS::RebootInstance
    Properties:
      regionId: '{{ regionId }}'
      instanceId: '{{ ACS::TaskLoopItem }}'
    Loop:
      Items: '{{ listInstances.instanceIds }}'

执行 CLI 命令时如果遇到权限错误，Skill 会提示所需的 RAM 权限。请联系管理员为当前账号授予 oos:ListActions 和 oos:ValidateTemplateContent 权限后重试。