阿里云解决方案部署（Alibaba Cloud Solution Deploy）是一个用于在阿里云上部署官方技术解决方案的技能，目标是把用户的场景匹配到最佳执行路径（Terraform 或 CLI），并端到端完成任务。
一、用途与核心原则 该技能用于部署阿里云官方技术方案。触发场景包括用户提到某个阿里云解决方案，或粘贴解决方案 URL 时。其核心原则包括：
- 最大自动化：如果需要 10 个步骤、其中 9 个可以自动化，就把这 9 个全部自动化，只为真正需要人工操作的 1 步暂停。每个有 CLI 路径的云操作都应使用 CLI，因为用户正是为免于在控制台点击而来。
- CLI 优先、控制台最后：把每个云操作表达为可运行的 aliyun CLI 命令。只有在不存在 CLI 时才回退到控制台，且此时要给出直接深链接 URL（而非产品首页）。
- 绝不猜测，先验证：构造命令前先运行 aliyun <product> <command> --help 确认 CLI 语法，因为不同产品参数命名不一致（--RegionId、--region-id、--region 均存在）。出错时立即运行 diagnose_cli_command.py，该诊断脚本会调用专门端点，把错误码映射为修复方法。
二、工作流程 Step 0：验证环境。在任何新会话中首先执行。前置检查要求 Aliyun CLI >= 3.3.1，运行 aliyun version 验证；若未安装或版本过低，需参考安装指南。随后运行命令启用自动插件安装并设置 agent user-agent：aliyun configure set --auto-plugin-install true --user-agent AlibabaCloud-Agent-Skills。最后运行完整环境检查脚本：bash {{SKILL_PATH}}/scripts/verify_env.sh，检查 CLI 版本、有效凭证、自动插件安装、Python3 + SDK；任一检查失败则告知用户修复并停止。
RAM 权限预检：执行任何命令前，将用户权限与 references/ram-policies.md 对比；若缺少权限则中止并提示用户附加所需策略。
Step 1：理解场景。从用户请求中提取想构建或配置的内容、涉及的阿里云产品、关键需求（地域、实例规格、预算、高可用需求、环境 dev/staging/prod），并提炼中英文关键词用于 Step 2。
Step 2：路由到正确路径。查阅 references/alicloud-tech-solutions-all.md（187 个阿里云技术方案的主目录），按关键词匹配方案名称与描述。每行有 Terraform Module 名称列：有值则走 Path A（Terraform）；为空或未匹配到方案则走 Path B（CLI-First）。也可用 intent-mapping.md 做模糊关键词到方案的映射。
Path A：Terraform 方案。当匹配到 Terraform 模块时，通过 IaCService 远程运行时部署，无需本地 terraform 二进制。包括：A.1 定位模块（在 references/tf-plan/tf-solutions.md 中查 Module 名称与地址）；A.2 获取示例参数（从 GitHub 仓库已测试示例中获取 main.tf，参数优先级为用户明确指定 > 示例默认值 > 兜底默认值）；A.3 与用户确认参数（绝不静默应用，云资源产生真实费用），密码和 API Key 等敏感值绝不自行生成，由用户提供；A.4 编写 main.tf 并部署（使用远程运行时脚本，STATE_ID 对未来更新或销毁必需）；A.5 验证并报告，提供销毁命令。
Path B：CLI-First 执行。适用于没有 Terraform 模板的情况：理解架构 → 拆解步骤 → 查找每步 CLI 命令 → 执行。B.1 理解架构（可获取部署教程页面了解目标架构、所需产品与部署顺序）；B.2 拆解为原子步骤（按依赖排序，如 VPC → VSwitch → 安全组 → ECS 通常是基础，注意 ID 链式传递与异步操作）；B.3 研究 CLI 命令，使用脚本查找正确 API 名称与参数，不依赖记忆，可并行运行脚本；B.4 呈现计划并确认，计划必须包含 RAM 权限部分，列出当前账号所需全部权限，权限由计划的 CLI 命令推导；B.5 执行（先验证语法、运行命令、轮询异步操作并验证结果、保存 ID 与端点等输出）；B.6 处理错误（运行诊断脚本、应用修复并重试，从失败步骤恢复，绝不重跑已成功步骤）；B.7 报告（已创建资源及 ID、访问端点/连接串、如何使用、按相反依赖顺序的清理命令）。
三、脚本与参考 脚本包括：verify_env.sh（环境检查）、lsit_products.py（查找产品代码与版本）、search_apis.py（自然语言转 API）、search_documents.py（文档搜索）、lsit_api_overview.py（产品完整 API 列表）、diagnose_cli_command.py（诊断 CLI 错误）、terraform_runtime_online.sh（远程 TF 执行）。参考文档包括 Intent Mapping、Terraform Defaults、Terraform Online Runtime、All Tech Solutions Catalog（187 个方案及 TF Module 可用性）、TF Solutions Detail（48 个 Terraform 模块及 Registry 地址）。
四、适用场景与限制 适用于在阿里云上部署官方技术方案的场景，尤其是用户描述建站、AI 应用（如 RAG 知识库、百炼/Bailian/DashScope 相关方案）等需求时。官方内置一些常见 CLI 快捷方式，例如通过 modelstudio 命令程序化获取百炼 API Key、用 ecs RunCommand 通过云助手在 ECS 上执行脚本、用 ossutil 子命令操作 OSS。限制方面：需要 Aliyun CLI >= 3.3.1、有效凭证与相应 RAM 权限；部分产品开通或控制台专有功能无 CLI，需人工在控制台操作；敏感值需用户自行提供；云资源产生费用且部分操作不可逆，因此写入操作前必须等待用户确认。具体安装命令、脚本用法与参考文件内容以实际资料为准，其余细节暂未提供。