前言¶
在云上做日常运维时，常见路径是登录控制台逐页点选，或在本机查文档再拼 ctyun 子命令。资源类型多、API 面又大时，容易漏参数、记错服务模块名。若你已经在用 Cursor、Claude Code 等带 Skills 的客户端，可以把「天翼云 CLI 能做什么、命令怎么组织」沉淀成 Skill，让对话里直接按模块查操作，而不是每次从零翻文档。
下面介绍 SkillHub 上的社区 Skill ctyun-cli-天翼云-命令行（坐标 @user_70730af0/ctyun-cli-skill，当前版本 1.30.0），它面向天翼云官方 CLI 场景，供 Agent 在需要时引用。
这是什么¶
一句话定位： 把天翼云企业级 CLI 的能力说明与使用指引打包成 Agent Skill，便于在编码/运维对话中管理天翼云资源。
来源与维护： SkillHub 分类为 it-ops-security，来源标注为 community，发布者为 user_70730af0。页面标签含 requires_api_key=true，表示实际调用云 API 时需要可用的天翼云访问凭证（具体字段以 Skill 内说明与官方 CLI 文档为准）。
解决的问题： 在 AI 侧统一引用「ECS、VPC、EBS、ELB、CCE、Redis、Kafka、CSS、EMR、监控、账务、IAM、Aone、CloudPC、AIServer」等 17 大服务模块 相关能力；SkillHub 简介写明覆盖 397+ 个 API、383+ 个命令（以 SkillHub 页面与已抓取元数据为准，与个别营销文案中的更大数字可能不一致，写作与选型时以商店页为准）。
核心功能¶
依据 SkillHub 简介与元数据，可核实的能力范围包括：
- 多服务模块： 上述 17 类模块，涵盖计算、网络、存储、容器、中间件、大数据、监控、身份与账务、云桌面、AI 服务器等常见运维面。
- 命令与 API 规模： 397+ API、383+ 命令量级，适合「一条对话里查某服务子命令结构」而非只记少数高频操作。
- 运维安全类归类： 放在
it-ops-security，与账号、权限、云资源变更类任务同一货架，便于在 SkillHub 内检索。 - 需 API Key： 标签
requires_api_key=true；未配置凭证时，Agent 只能做说明与命令草拟，无法代替你在本机执行并成功调云 API。
Skill 本体遵循通用 SKILL.md 格式；具体子命令示例、环境变量名、配置文件路径以安装后目录内的 SKILL.md 为准。本文不展开未在公开商店页出现的命令行样例。
安装与启用¶
1、安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 skillhub：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 官方安装文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需要 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装本 Skill¶
安装技能时必须用 --dir 指向当前 Agent 正在使用的 skills 目录，否则默认落在 ./skills/，客户端可能识别不到。
skillhub install @user_70730af0/ctyun-cli-skill --dir <你的 skills 目录>
也可用 SkillHub 页面提供的提示，让 AI 按 SkillHub 安装说明 安装 @user_70730af0/ctyun-cli-skill。
3、各客户端 skills 目录（节选）¶
SkillHub 文档中常见的路径如下，请按你实际使用的客户端选择：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
安装完成后，按各客户端要求刷新或重启，使新 Skill 被加载。
典型用法¶
公开商店页未附带可逐条复制的 CLI 会话实录；可复现的流程是「安装 Skill → 在对话中说明资源类型与目标（如查 ECS 实例、改 VPC 规则）→ Agent 依据 Skill 内对天翼云 CLI 的指引组织命令或步骤」。
建议用法：
- 在本机已安装并配置好天翼云官方 CLI 与 API 访问凭证（与
requires_api_key=true一致）。 - 在 Agent 对话中明确服务模块（如 CCE、ELB）与操作意图，避免跨模块歧义。
- 由 Agent 给出命令或参数草案后，在你自己的终端执行并核对变更；生产环境变更仍应走既有审批与回滚流程。
若需核对命令字面量，以安装包内 SKILL.md 与天翼云 CLI 官方文档为准，不要依赖本文臆造示例。
适用场景与注意¶
适合谁
- 已使用天翼云、并习惯或计划使用 ctyun CLI 的运维、平台、后端工程师。
- 希望在 Cursor / Claude Code 等环境中，把「云资源操作知识」固定在 Skill 里，减少重复查表。
限制与注意
- 社区 Skill： 来源为 community，升级与问题反馈路径以 SkillHub 与发布者页面为准。
- 凭证安全： 不要把 AccessKey、Secret 写进对话或仓库；用环境变量或官方推荐的配置文件，并遵守企业密钥规范。
- 数据以商店为准： SkillHub 页面显示评分 100000、下载 739（抓取时间与页面可能变动）；简介中的模块数、API/命令数量为 17 / 397+ / 383+，若与其他渠道文案不一致，以 SkillHub 技能页 为准。
- 安装计数： 元数据中「安装 0」仅表示商店统计字段，不代表你本机未安装；是否生效以客户端是否加载
~/.cursor/skills/（或对应目录）下该 Skill 为准。
结尾¶
ctyun-cli-天翼云-命令行 把天翼云 CLI 的多模块能力收敛成 Agent 可引用的 Skill，适合在对话里查命令结构、梳理运维步骤。需要安装或更新时，使用坐标 @user_70730af0/ctyun-cli-skill。
- SkillHub 页面：https://www.skillhub.cn/skills/user_70730af0/ctyun-cli-skill
- API 入口：https://api.skillhub.cn/user_70730af0/ctyun-cli-skill
