Agent Skills
返回列表
阿里云 OOS 编排模板生成

阿里云 OOS 编排模板生成

IT 运维与安全 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_15292d5a/yjkj-alibabacloud-oos-template-generation。

技能介绍

要解决什么问题

运维同学经常要把「重启一批 ECS」「按条件执行命令」「串联审批与云 API」写成可复用的自动化,阿里云 OOS(Operation Orchestration Service) 用模板描述编排,但手写 YAML/JSON 容易踩坑:Action 名称大小写不对、ACS::Flow::ForEach 这类并不存在的动作、Task 没定义 Outputs 就引用 {{ TaskName.Field }},以及云产品 Action 的 Properties 必须与 list-actions 返回完全一致。

本技能面向「用自然语言描述运维意图 → 产出可校验的 OOS 模板」这一闭环,而不是泛泛介绍 OOS 产品文档。

技能如何工作

触发后按固定执行计划推进,大致包括:

  1. 需求拆解:操作类型、目标资源、地域(常见默认 cn-hangzhou)及可参数化项;不确定的项优先放进模板 Parameters,而不是在对话里硬猜具体 ID。
  2. Action / API 查询:通过 Aliyun CLI(插件模式,如 aliyun oos list-actions)检索原子动作与云产品动作(如 ACS::ECS::RebootInstance),必要时用 OpenMeta 辅助 ACS::ExecuteAPI 场景。
  3. 模板生成:输出 FormatVersion: OOS-2019-06-01、Tasks 等完整结构;Description 需含 en 与 zh-cn 双语;参数引用使用 {{ paramName }} 格式;批量逻辑用 Task 的 Loop 与 {{ ACS::TaskLoopItem }},而非不存在的 Flow 类 Action。
  4. 独立校验:将模板写入临时文件后调用 ValidateTemplateContent;未通过校验不得作为最终结果,需根据错误修正并重复校验直至通过。

CLI 调用需开启 AI-Mode、携带规定 User-Agent,且 OOS 相关命令应带 --biz-region-id。凭证仅通过 aliyun configure list 检查状态,不得在会话中暴露 AK/SK。

适用边界与注意点

  • 环境前提:本机 Aliyun CLI ≥ 3.3.3、插件可自动安装/已更新,且 RAM 至少具备 oos:ListActions、oos:ValidateTemplateContent;权限不足时应先补齐策略再继续。
  • 参数确认:Region、实例 ID、资源名等用户可定制项须在生成前与用户确认,禁止擅自填默认资源标识。
  • 安全:不伪造资源 ID;除非用户明确要求,避免生成可能导致数据丢失的危险编排;本技能本身不创建云资源,仅生成与校验模板内容。

使用场景

  • 需要把「按实例 ID 重启 ECS」写成可复用 OOS 模板,并在提交前用 ValidateTemplateContent 校验通过
  • 多台机器要按同一套步骤执行云 API,想用 Loop 与 Parameters 做成批量编排而不是手写错误 Action 名
  • 运维需求涉及云产品 OpenAPI,需在 list-actions 查不到合适 Action 时用 ACS::ExecuteAPI 并核对参数定义
  • 审批、等待、通知与 ECS 操作要串在同一套 OOS Tasks 里,需要中英双语 Description 与规范字段结构

适合人员

  • 负责 ECS 变更窗口、要把重启/命令类操作固化成标准编排模板的云平台运维
  • 编写 RAM 最小权限策略的 SRE,需要明确 oos:ListActions 与 oos:ValidateTemplateContent 才能用 CLI 查 Action 并验模板
  • 自动化平台维护者,希望用自然语言描述运维意图后得到通过校验的 YAML/JSON 而非对照文档手搓
  • 刚接手 OOS 的工程师,常误用 ACS::Flow::ForEach 或 RunCommand,需要按 CLI 元数据生成正确 Action 与 Loop 写法