技能介绍

要解决的具体问题

在终端管理阿里云容器服务 Kubernetes（ACK）时，直接操作 aliyun cs 命令容易踩三类坑：一是忽略异步任务模式，创建集群、安装插件等操作返回 task_id 后没轮询结果，导致误判失败；二是混淆 Region 参数，--region 与 --biz-region-id 作用不同却值相同，搞错后要么路由到默认端点变慢，要么直接调用失败；三是复杂 JSON 参数（如 Terway 多可用区 Pod 交换机、Addon 配置）手工转义出错，频繁触发 InvalidParameter.Format。此外，遗留的 PascalCase OpenAPI 风格命令参数混乱、--help 信息不全，进一步增加了出错概率。

核心能力与关键步骤

该技能围绕 ACK 专属模式构建，强制只使用 kebab-case 的 cs 插件命令，先通过 --help 确认参数类型（基础值、列表、可重复键值或复杂 JSON）再拼写命令。对异步操作（如 create-cluster、install-cluster-addons、modify-cluster-node-pool），统一用 task_id 配合 describe-task-info 轮询，支持 pause-task、resume-task、cancel-task 控制任意在途任务。处理 Region 化 API 时遵循两条规则：优先用 -for-region 变体（如 describe-clusters-for-region）并传 --biz-region-id；集群 ID 级调用必传 --region 直连区域端点。面对嵌套 JSON 参数，建议用文件或 jq 生成而非手工转义，避免格式错误；AutoMode 只需单标志开启，无需再配置 VPC、网络等参数。

适用边界与注意点

技能基于 aliyun-cli 3.3.2 + cs plugin 0.2.1 编写，插件更新后需重新运行自发现命令刷新参数信息。--region 是 CLI 全局端点路由参数，--biz-region-id 是 API 业务参数，不可混用，且没有 --region-id 标志。遇到 【该参数已废弃】 标记时必须告知用户并引用建议替代参数，不可静默替换。轮询任务前需征得用户同意，避免消耗 token；写入操作前建议先加 --cli-dry-run 校验参数。内网集群的 kubeconfig 仅能在 VPC 内使用，临时 STS 凭证过期后需重新生成。