面向 AI 编码代理的 UCloud 技能集合。目前包含 ucloud-cli,用于通过官方 UCloud CLI 查询、创建、更新和删除云资源,也支持将 WEB 应用部署需求转换为具体的 UCloud 资源操作。
ucloud-cli 默认优先使用 ucloud <product> <subcommand> 产品子命令;仅在产品子命令不存在、能力不足或语义不明确时,才回退到 ucloud api 调用 OpenAPI。
主要能力:
- 管理 UHost、EIP、安全组等 UCloud 资源
- 查询 Region、Zone、项目和账户余额
- 规划并执行 WEB 应用部署
- 发现和使用本地 CLI profile
- 根据官方文档补全命令参数并处理常见错误
- 已安装
ucloudCLIv0.3.1或更高版本 - 已通过
ucloud auth login完成 OAuth 授权,或已配置可用的 CLI profile
可运行以下命令检查环境:
ucloud --version
ucloud config list请将配置输出视为敏感信息,不要公开其中的密钥或令牌。
克隆仓库后,将 ucloud-cli 目录复制或链接到代理使用的 skills 目录:
git clone https://github.com/ucloud/skills.git
ln -s "$(pwd)/skills/ucloud-cli" /path/to/agent/skills/ucloud-cli不同代理的 skills 目录位置可能不同,请以对应代理的文档为准。
在支持显式技能调用的代理中使用 $ucloud-cli,或直接描述 UCloud 资源操作与部署目标。例如:
使用 $ucloud-cli 查询当前账号可用的 Region 和 Zone。
使用 $ucloud-cli 和 profile testcli 查看 UHost 列表。
把我的 WEB 应用部署到 UCloud,先检查还缺哪些参数,不要创建资源。
涉及写入或删除时,技能会先确认目标资源、命令和 profile;查询结果默认以简洁的表格或摘要展示。
ucloud-cli/
├── SKILL.md # 技能入口和通用工作流
├── agents/openai.yaml # 技能展示配置
├── evals/evals.json # 行为评估用例
└── references/ # CLI、部署、产品和错误处理规则
- 不要在对话、命令参数、日志或补丁中填写真实的 Public Key、Private Key 或 Token。
- 优先使用 OAuth 或已有 CLI profile,避免通过命令行传递凭据。
- 对已有资源执行变更前,先运行只读查询并核对资源 ID、Region、Zone、ProjectId 和 profile。
- API 参数以本地 CLI help 和 UCloud 官方文档为准,不应凭经验猜测。