天翼云官方 CLI
将以下提示词粘贴到你的 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提供的规范格式写出。 - 任务是列表或展示类时会主动检查分页与字段结构,不假设第一页完整。
真正的命令链
- 按 SKILL 给出的顺序加载
references/querying-pricing-troubleshooting.md等上下文;Windows PowerShell 环境先读references/windows-powershell.md并确认 UTF-8。 - 在已确认
ctyun-cli --help、参数名前缀、鉴权状态与分页边界的前提下,构建命令,保持 JSON 键、Action 名、product名的原始大小写,CIDR、JMESPath 和含特殊字符的字符串全部加引号。 - 只读查询,一般用
ctyun-cli <product> <action> --cli-query <JMESPath>做最终投影;查询价格或排查错误也用此格式。 - 展示时保留
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 平台研发工程师。