运行时依赖
安装命令
点击复制技能文档
阿里云解决方案部署 将用户的场景与最佳的执行路径(Terraform 或 CLI)进行匹配,然后完成任务的端到端执行。
核心原则 最大化自动化 如果需要 10 个步骤,而 9 个步骤可以自动化,那么就自动化所有 9 个步骤。只有当真正需要人工操作时才暂停。 每个具有 CLI 路径的云操作都应该使用它——用户来到你这里正是因为他们不想点击控制台。 CLI-First,Console-Last 将每个云操作表达为可运行的 aliyun CLI 命令。只有当没有 CLI 时才回退到控制台——当你这样做时,提供一个直接的深度链接 URL(而不是产品主页)。 https://vision.aliyun.com/facebody 和 https://console.aliyun.com/ 之间的区别是有用和无用的区别。 永远不要猜测——先验证 CLI 语法:在构造命令之前运行 aliyun --help。 参数命名在产品之间不一致—— --RegionId、--region-id 和 --region 都存在。 错误:在失败时立即运行 diagnose_cli_command.py。 阿里云 API 的错误消息往往很难理解——诊断脚本调用一个专门的端点,该端点将错误代码映射到解决方案。
工作流 步骤 0:验证环境 在任何新会话中首先运行以下命令: 预检查:Aliyun CLI >= 3.3.1 是必需的 运行 aliyun version 以验证 >= 3.3.1。 如果没有安装或版本过低,请参阅安装指南以获取说明。 然后运行以下命令以启用自动插件安装并设置代理用户代理: aliyun configure set --auto-plugin-install true --user-agent AlibabaCloud-Agent-Skills 这确保在首次使用时下载产品特定的 CLI 插件(无需手动安装),并将请求标识为来自此技能。 然后运行完整的环境检查: bash {{SKILL_PATH}}/scripts/verify_env.sh 这检查:CLI 版本、有效凭证、auto-plugin-install、Python3 + SDK。 如果任何检查失败,请告诉用户需要修复什么并停止——一个破损的环境意味着每个后续命令都将失败。
RAM 权限预检查 在执行任何命令之前,验证当前用户是否具有所需的权限: 将用户的权限与 references/ram-policies.md 进行比较 如果任何权限缺失,请中止并提示用户附加所需的策略 最低所需权限在 references/ram-policies.md 中列出。
步骤 1:了解场景 从用户的请求中提取: 他们想要构建或配置什么 哪些阿里云产品涉及(或可以推断) 关键要求:区域、实例规格、预算、HA 需求、环境(开发/预发/生产) 提炼为步骤 2 的搜索关键词(中文 + 英文)。 例如,“我要搭个 RAG 知识库” → 关键词:RAG、知识库、AnalyticDB、百炼。
步骤 2:路由到正确的路径 检查 references/alicloud-tech-solutions-all.md —— 阿里云技术解决方案的主目录。 通过关键词匹配解决方案名称和描述进行搜索。 每行都有一个 Terraform 模块名称列: 列中有值(例如 analyticdb-rag、deepseek-personal-website)→ 路径 A:Terraform 列为空或没有找到匹配的解决方案 → 路径 B:CLI-First 还使用 intent-mapping.md 进行模糊关键词 → 解决方案匹配(例如“小程序” → develop-your-wechat-mini-program-in-10-minutes)。 在继续之前告诉用户您要采取哪条路径以及为什么。
路径 A:Terraform 解决方案 当 Terraform 模块匹配时,通过 IaCService 远程运行时部署 —— 无需本地 Terraform 二进制文件。 A.1:定位模块 在 references/tf-plan/tf-solutions.md 中查找模块名称和模块地址。 匹配方式: 精确模块名称来自主目录 关键词匹配描述列 意图映射 A.2:获取示例参数 每个模块都有一个 GitHub 存储库,其中包含经过测试的示例。 推导 URL: 模块地址:https://registry.terraform.io/modules/alibabacloud-automation//alicloud/latest GitHub 存储库:https://github.com/alibabacloud-automation/terraform-alicloud- 示例:https://raw.githubusercontent.com/alibabacloud-automation/terraform-alicloud-/main/examples/complete/main.tf 通过 WebFetch 获取示例 main.tf。 这些值来自实际测试部署 —— 它们比通用默认值更可靠。 参数优先级: 用户显式指定 → 始终使用 示例 main.tf 来自 examples/complete/ → 作为默认值使用 回退默认值(仅当获取失败时):请参阅 terraform-defaults.md A.3:与用户确认 显示参数并询问确认。 永远不要默默地应用它们 —— 云资源花费真钱。 以下是基于官方示例的部署参数,请确认或修改: • 区域:cn-hangzhou • 实例类型:ecs.c7.large • VPC CIDR:172.16.0.0/12 • 密码:(请提供) 敏感值,如密码和 API 密钥:永远不要自己生成。 用户提供这些。 A.4:编写 main.tf 并部署 基于:https://github.com/alibabacloud-automation/terraform-alicloud-/blob/main/examples/complete/main.tf module "" { source