阿里云 OOS 编排模板生成
将以下提示词粘贴到你的 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 产品文档。
技能如何工作
触发后按固定执行计划推进,大致包括:
- 需求拆解:操作类型、目标资源、地域(常见默认
cn-hangzhou)及可参数化项;不确定的项优先放进模板Parameters,而不是在对话里硬猜具体 ID。 - Action / API 查询:通过 Aliyun CLI(插件模式,如
aliyun oos list-actions)检索原子动作与云产品动作(如ACS::ECS::RebootInstance),必要时用 OpenMeta 辅助ACS::ExecuteAPI场景。 - 模板生成:输出
FormatVersion: OOS-2019-06-01、Tasks等完整结构;Description需含 en 与 zh-cn 双语;参数引用使用{{ paramName }}格式;批量逻辑用 Task 的 Loop 与{{ ACS::TaskLoopItem }},而非不存在的 Flow 类 Action。 - 独立校验:将模板写入临时文件后调用
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 写法