Agent Skills
返回列表
天翼云官方 CLI

天翼云官方 CLI

IT 运维与安全 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md 安装 @user_1d23aa46/ctyun-cli-guidance。

技能介绍

要解决什么问题

当一个 Agent 被要求调用本机的 ctyun-cli 去查询或变更天翼云资源时,最容易出现两类低级错误:一是凭记忆把参数写成 --regionId 或 --RegionID;二是凭印象猜测不该存在的 product key 或 Action。CLI 本身的 --help 是权威说明书,但真实响应往往被隐藏在多个视图之下。本技能建立一套机械的执行顺序:先只读发现,再按 Action 语义执行。

它如何工作

  • 本技能的作用是让用户通过自然语言指挥 Agent 使用 CLI,Agent 不直接接触 SecretKey。认证信息由用户在自有终端中维护:更新凭证可使用环境变量 CTYUN_ACCESSKEY / CTYUN_SECRETKEY,并结合例如 Export-Item Env:CTYUN_ACCESSKEY=xxxxx 这类会话级写法;ctyun-cli configure 这类交互式命令只由用户执行,Agent 不做决定。
  • 命令执行前会先读取如 ctyun-cli ecs --help 等输出,确认真实存在的 product 分组、action 名称与参数名逐字一致。需要 --body 等结构化字段的操作严格按 references/body-json.md 提供的规范格式写出。
  • 任务是列表或展示类时会主动检查分页与字段结构,不假设第一页完整。

真正的命令链

  1. 按 SKILL 给出的顺序加载 references/querying-pricing-troubleshooting.md 等上下文;Windows PowerShell 环境先读 references/windows-powershell.md 并确认 UTF-8。
  2. 在已确认 ctyun-cli --help、参数名前缀、鉴权状态与分页边界的前提下,构建命令,保持 JSON 键、Action 名、product 名的原始大小写,CIDR、JMESPath 和含特殊字符的字符串全部加引号。
  3. 只读查询,一般用 ctyun-cli <product> <action> --cli-query <JMESPath> 做最终投影;查询价格或排查错误也用此格式。
  4. 展示时保留 product 提供默认字段名映射。

适用边界与注意点

  • 用户说“只生成命令”“dry run”等等时,处理单元应落下命令文本,不进行执行。
  • PowerShell 中参数含 $、.、| 等情况时使用参数的 stop-parsing token,统一编码等待用户确认。

参考文档按需加载

  • 安装/环境缺失参考 references/install.md;PowerShell 的编码、--%、管道指引在 references/windows-powershell.md;请求体写入规范在 references/body-json.md;分页、价格、日志与常见错误在 references/querying-pricing-troubleshooting.md。

使用场景

  • 排查 ECS 实例的 regionID、azName、flavor、镜像和 VPC 归属,需要先确认参数名再做只读查询。
  • 准备创建 VPC 或子网,需要解析依赖项并按确认清单生成 create 命令,提交前再核对帮助输出。
  • 在 Windows PowerShell 会话中输出中文资源名,需要先设置 UTF-8 和 stop-parsing token 避免乱码。
  • 用户明确说“只生成命令”或“dry run”,需要在不执行的情况下输出完整的 ctyun-cli 调用字符串。

适合人员

  • 把 ctyun-cli 当自动化入口的 SRE 或 LaC 工程师。
  • 需要在 PowerShell 窗口里人肉排查和中文化资源名的运维工程师。
  • 在做带密凭据的云上批量巡检的 CI 或脚本研发。
  • 对敏感写操作有强审计场景的 PaaS 平台研发工程师。