阿里云全球加速（GA）EasyConfig 用于对阿里云全球加速标准型（Standard）与基础型（Basic）加速器进行端到端的生命周期管理与自动化配置。
用途与触发场景：当用户需要创建、配置或设置 GA 实例，导入已有加速器到本地配置文件，基于 JSON 模板在多环境部署，检测配置漂移，管理 ACL、转发规则与证书，监控健康状态、估算费用或优化资源时可使用。适用于跨境加速、跨境合规、海外用户访问、访问延迟过高、游戏加速、电商加速及中国大陆到海外加速等场景。
主要能力：覆盖加速实例、监听、终端节点组、终端节点、转发规则、带宽包、访问控制、证书与健康检查的创建与管理；支持配置漂移检测、健康状态查询、费用估算和资源优化；提供跨环境 JSON 模板部署与既有实例导入。
使用方式：需先安装并配置阿里云 CLI（aliyun）3.3.3 或更高版本，GA 控制面所有 API 调用使用 cn-hangzhou，加速地域通过专用参数指定。需具备 jq（Linux/macOS）或 PowerShell ConvertFrom-Json（Windows）用于格式化输出。每次会话须生成唯一 GA_SESSION_ID（UUID4），调用时设置 User-Agent：AlibabaCloud-Agent-Skills/alibabacloud-ga-easyconfig/<GA_SESSION_ID> skill-version/<version>。首次 API 调用前通过 scripts/init-session.sh 初始化会话并导出环境变量，后续命令均需携带 --user-agent "$GA_USER_AGENT"。
命令语法要求：使用 kebab-case 参数，API 级 RegionId 通过 --biz-region-id 传入，不可使用旧式 PascalCase 参数；列表/嵌套参数以单组内联 Field=Value 形式传递，组内字段名保持 PascalCase；枚举值区分大小写（计费类型大写、监听协议大写、健康检查协议小写、IP 版本 IPv4/IPv6、ISP 类型 BGP）。POSTPAY 实例必须使用 --bandwidth-billing-type CDT 且不支持 --spec；加速地域带宽须大于 2 Mbps。易错参数组合可先以 --dry-run true 验证。
安全与成本控制：所有写操作需用户显式确认，PreToolUse 钩子作为安全网拦截 Bash 调用，钩子未运行或放行创建/更新/删除命令时仍需自行确认。预付费实例购买、规格变更、基础型预付费加速器购买、带宽包购买与升配等高成本操作须先展示资源类型、规格/带宽、计费类型、时长、自动续费设置与具体命令，获得用户二次确认后才执行。创建调用须保证幂等：超时或网络错误后不得盲目重试，应先做资源盘点，支持 ClientToken 的接口使用确定性令牌去重，不支持的采用先查后建。
执行边界：轮询循环须设置最大尝试次数与时间预算，禁止前台运行 while true、tail -f 或持续监控脚本；持续监控应后台运行并报告 PID 与停止方式；单次状态检查直接调用 get-health-status。单次 API 疑似挂起时可带超时参数重试一次，仍失败则报告阻塞。
阻塞处理：遇到配额超限、跨境合规拦截、RAM 权限缺失或资源冲突时，停止不可逆操作，记录失败命令、时间戳、错误码与 RequestId、账号 ID 及盘点结果，提供可运行的修正脚本并做语法检查，给出带取舍的编号选项供用户选择；未经明确确认不得删除或修改属于其他工作负载或订阅的 GA 资源。
跨境加速限制：跨境（中国大陆到海外）的 CrossDomain 带宽包涉及合规审批，本技能不购买也不绑定，无论审批状态如何；仅可执行只读的跨境审批状态与加速器跨境状态检查，随后输出人工操作指引，由用户在控制台完成合规申请（审批约 1-5 个工作日）、购买 CrossDomain 带宽包并绑定。非跨境部分（实例、基础带宽包、加速地域、监听、终端节点组）仍按正常自动化流程执行。
配置与权限：assets/ga-config.json 为加速器、带宽包与 IP 集示例配置，ga-listeners.json 保存监听、终端节点组、终端节点与转发规则；每次变更操作后应更新工作目录中的配置副本。RAM 权限遵循 references/ram-policies.md 中的最小权限策略，至少需要 GA 及依赖服务的读权限，写权限仅在用户明确确认变更操作时使用。