本文介绍如何获取 ctyun-cli-guidance Skill，并把它接入到你正在使用的智能体中。
当前发布方式不提供 skill 安装脚本。Skill 以 zip 包发布。用户下载 zip 后，按所用智能体的要求导入即可。不同智能体的机制不完全一样，常见方式包括：
解压到智能体约定的 skills、knowledge、context 或扩展目录。
在智能体的会话、项目知识库、系统提示词或自定义指令中上传或引用 SKILL.md。
通过智能体自带的插件、扩展、MCP、知识库管理功能导入。
1.Skill 能做什么
ctyun-cli-guidance 会指导智能体：
安装当前平台对应的天翼云 CLI。
根据用户需求选择正确的天翼云 CLI 产品和 Action。
通过 ctyun-cli --help 核对真实命令和参数，避免用错命令名。
查询资源池、可用区、规格、镜像、VPC、子网、安全组、EIP 等资源。
帮用户创建、删除、退订、绑定、解绑资源等操作，变更操作前说明影响并请求确认。
协助排查 AK/SK、权限、参数、签名、区域和资源 ID 等问题。
Skill 是给智能体使用的操作指南，不是天翼云 CLI 本身：
只安装 Skill 后，智能体可以解释命令并协助规划操作。
需要查询或变更真实云资源时，智能体会触发安装 ctyun-cli，并引导配置有效的 AK/SK。
Skill 不会内置、上传或代替用户的 AK/SK。
2.通过智能体辅助安装skill
如果你正在使用的智能体具备文件下载、解压和写入本地目录的能力，推荐把 Skill 下载地址交给智能体，让它辅助完成下载和导入。这样通常比手动复制多段命令更省事。
可以直接对智能体说：
请帮我安装天翼云 CLI Skill。
Skill 下载地址是：https://huabei-2.zos.ctyun.cn/ctyun-cli/skill/latest/ctyun-cli-guidance.zip
请先判断当前操作系统，然后下载 zip，解压后把 ctyun-cli-guidance/SKILL.md 放到当前智能体可读取的 skill、knowledge、context 或自定义指令目录中。
安装完成后，请告诉我最终路径，并提醒我是否需要重启客户端或新建会话。如果要安装指定版本，可以把地址换成：
https://huabei-2.zos.ctyun.cn/ctyun-cli/skill/0.1.0/ctyun-cli-guidance-0.1.0.zip注意：不同智能体支持的导入机制不同。有的支持本地 skills 目录，有的支持项目知识库、会话上下文、自定义指令或插件配置。让智能体安装时，应要求它先确认当前智能体实际读取的位置，不要盲目使用某个固定目录。
3. 手动下载 Skill zip
macOS / Linux 下载最新版：
curl -fL "https://huabei-2.zos.ctyun.cn/ctyun-cli/skill/latest/ctyun-cli-guidance.zip" -o ctyun-cli-guidance.zipmacOS / Linux 下载指定版本：
curl -fL "https://huabei-2.zos.ctyun.cn/ctyun-cli/skill/0.1.0/ctyun-cli-guidance-0.1.0.zip" -o ctyun-cli-guidance.zipWindows PowerShell 下载最新版：
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Invoke-WebRequest -UseBasicParsing "https://huabei-2.zos.ctyun.cn/ctyun-cli/skill/latest/ctyun-cli-guidance.zip" -OutFile ctyun-cli-guidance.zipWindows PowerShell 下载指定版本：
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Invoke-WebRequest -UseBasicParsing "https://huabei-2.zos.ctyun.cn/ctyun-cli/skill/0.1.0/ctyun-cli-guidance-0.1.0.zip" -OutFile ctyun-cli-guidance.zipzip 包内部结构是：
ctyun-cli-guidance/SKILL.md
ctyun-cli-guidance/references/*.md4. 手动导入到智能体
优先查看你所使用智能体的官方说明，确认它支持哪种导入方式。
如果智能体支持本地 skill 目录，请把 zip 解压到该目录，让最终路径类似：
macOS / Linux路径为：
<智能体-skill目录>/ctyun-cli-guidance/SKILL.md
<智能体-skill目录>/ctyun-cli-guidance/references/*.mdWindows 路径为：
<智能体-skill目录>\ctyun-cli-guidance\SKILL.md
<智能体-skill目录>\ctyun-cli-guidance\references\*.md不要只把 SKILL.md 单独放进目录根部，因为目录名 ctyun-cli-guidance 和 references 目录都是识别、组织和按场景加载规则的一部分。
如果智能体不支持本地 skill 目录，但支持会话级或项目级知识配置，优先导入整个 ctyun-cli-guidance 目录；如果只能导入单文件，可以先导入 ctyun-cli-guidance/SKILL.md，但部分场景化参考规则可能无法自动读取。导入后建议在新会话中使用。
5. 解压示例
下面只是通用示例，不代表所有智能体都使用这些路径。实际路径以你使用的智能体文档为准。
macOS / Linux：
# 假设智能体的 skill 目录是 ~/.example-agent/skills
mkdir -p "$HOME/.example-agent/skills"
unzip -o ctyun-cli-guidance.zip -d "$HOME/.example-agent/skills"Windows PowerShell：
# 假设智能体的 skill 目录是 %USERPROFILE%\.example-agent\skills
New-Item -ItemType Directory -Force "$HOME\.example-agent\skills" | Out-Null
Expand-Archive ".\ctyun-cli-guidance.zip" -DestinationPath "$HOME\.example-agent\skills" -ForceCodex 示例：
mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
unzip -o ctyun-cli-guidance.zip -d "${CODEX_HOME:-$HOME/.codex}/skills"Claude Code 示例：
mkdir -p "$HOME/.claude/skills"
unzip -o ctyun-cli-guidance.zip -d "$HOME/.claude/skills"如果你的智能体不使用上述目录，请不要照抄路径，按该智能体文档选择正确目录或会话配置方式。
6. 确认导入成功
如果是本地目录方式，检查目标目录中是否存在：
ctyun-cli-guidance/SKILL.md
ctyun-cli-guidance/references/macOS / Linux 示例：
test -f "$HOME/.example-agent/skills/ctyun-cli-guidance/SKILL.md" \
&& test -d "$HOME/.example-agent/skills/ctyun-cli-guidance/references" \
&& echo "skill installed"Windows PowerShell 示例：
Test-Path "$HOME\.example-agent\skills\ctyun-cli-guidance\SKILL.md"
Test-Path "$HOME\.example-agent\skills\ctyun-cli-guidance\references"如果是会话或项目知识方式，检查智能体配置中是否能看到 ctyun-cli-guidance 目录，或至少能看到 SKILL.md 和 references 中的参考内容。
导入或更新 Skill 后，建议重新启动智能体客户端，或新建一个会话。已经打开的会话可能不会自动重新扫描 Skill 文件。
可以用下面的问题做验证：
请告诉我 CTYUN CLI 查询 VPC 列表应使用哪个 product 和 Action，
并说明如何查看该 Action 的参数。暂时不要执行命令。预期回答应包含：
product: vpc
Action: ListVpc
ctyun-cli vpc ListVpc --help
