前言¶
在华为云上查资源、改配置、写自动化脚本，多半会落到命令行工具 KooCLI（hcloud）。控制台文档分散，AK/SK 怎么配、ECS/OBS/RDS 常用子命令怎么写，Agent 若缺少固定上下文，容易给出不完整或与官方不一致的步骤。hwc-cli-guidance-v2 是 SkillHub 上的社区 Skill（坐标 @user_15292d5a/yjkj-hwc-cli-guidance-v2），把安装、认证、命令示例和运维实践写进 SKILL.md 及 reference/ 参考文档，让编码助手按同一套材料回答 KooCLI 相关问题。下面介绍它是什么、能做什么，以及如何安装与使用。
这是什么¶
定位：面向开发者与云运维人员的文档型 Guidance Skill，不替代 KooCLI 本身，而是在对话中提供华为云命令行工具的安装、配置、常用命令与最佳实践指引。
来源与版本：SkillHub 分类为 it-ops-security，来源 community，发布者 user_15292d5a，当前包版本 1.0.0（Skill 文档内标注最后更新 2026-06-04）。skill-card.md 标明许可为 MIT-0，部署地域为 Global；SkillHub 元数据标签含 requires_api_key=true，表示涉及华为云 AK/SK 等凭证配置场景。
解决的问题：统一 Agent 对 KooCLI（华为云 KooCLI / hcloud）的认知来源，减少「只记几个命令、漏掉认证与多 Profile」的情况；附带指向华为云官方 KooCLI 文档的链接，便于核对。
核心功能¶
依据 Skill 包内 SKILL.md 与 reference/ 目录，已核实能力包括：
- 快速上手：系统要求（Windows / macOS / Linux，pip 路径需 Python 3.8+）、访问密钥获取路径、多种安装方式（pip、curl 二进制、PowerShell、Homebrew 等见
reference/installation-guide.md）。 - 认证与配置：AK/SK、Token、Profile 说明；
hcloud configure init/list/set/delete等配置管理示例。 - 常用服务命令：ECS（列举/启停/重启实例）、OBS（桶与对象上传下载）、RDS、FunctionGraph 等示例；并说明可用
hcloud --help查看完整服务列表。 - 场景化示例：自动化运维脚本、OBS 批量上传、CES/AOM 监控查询等（文档中的 shell/Python 片段）。
- 最佳实践与排错：多环境 Profile、环境变量存放 AK/SK、输出格式（
--output=json|table、--query）、常见 HTTP 错误码对照；reference/command-reference.md提供更细的子命令参数表。
Skill 输出类型为文本、Markdown、命令与配置说明（见 skill-card.md），不会在 Skill 内直接代你执行云 API；生成或粘贴的命令仍需人工审阅后再跑。
安装与启用¶
安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 skillhub：
command -v skillhub && skillhub --version
未安装时可按 SkillHub 官方说明执行完整安装或仅 CLI：
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
安装本 Skill¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。官方页面给出的安装提示为：参照 https://skillhub.cn/install/skillhub.md，安装坐标 @user_15292d5a/yjkj-hwc-cli-guidance-v2。
skillhub install @user_15292d5a/yjkj-hwc-cli-guidance-v2 --dir ~/.cursor/skills/
各客户端常见 skills 路径（摘自 SkillHub 安装文档）：Cursor 为 ~/.cursor/skills/；Claude Code 为 ~/.claude/skills/；Codex 为 ~/.codex/skills/ 或项目下 .agents/skills/。装好后按你所用客户端要求重启或刷新 Agent，使 Skill 生效。
SkillHub 页面当前统计（以抓取资料为准）：评分约 100000，下载 782 次；安装数在页面上可能为 0，以 SkillHub 实时显示为准。
典型用法¶
启用 Skill 后，在对话中提出与 KooCLI 相关的具体任务即可，Agent 应依据 Skill 内文档组织回答。下面步骤来自 Skill 官方「快速开始」，可在本机复现以验证环境（需已有华为云 AK/SK）。
1、安装 KooCLI（pip 方式，Skill 推荐之一）
pip install huaweicloudsdkcore
pip install huaweicloudsdkkoocli
hcloud --version
2、初始化认证
hcloud configure init
按提示填写 Access Key ID、Secret Access Key、Region（示例：cn-north-4）。
3、执行第一条查询
hcloud ecs list-servers
hcloud obs list-buckets
若需 JSON 输出或切换环境，Skill 文档中的写法如下：
hcloud --profile=dev ecs list-servers --output=json
更完整的安装变体（Linux curl 二进制、Windows PowerShell、macOS Homebrew）和卸载步骤见包内 reference/installation-guide.md；子命令参数见 reference/command-reference.md。
适用场景与注意¶
适合谁
- 在 Cursor、Claude Code、Codex 等环境里用 Agent 写华为云运维脚本、查命令参数、对照官方流程的同事。
- 需要把 ECS/OBS/RDS 等常见操作与认证、Profile、错误处理放在同一上下文里的人。
限制与风险（摘自 skill-card.md 中的 Known Risks）
- 示例大量使用 AK/SK：勿把密钥写进仓库或日志；优先环境变量或密钥管理服务，并遵循最小权限。
- 安装示例可能从
dl.koo.cloud等地址下载二进制并写入系统路径：仅从华为云官方渠道获取，并在生产环境前验证包完整性。 - 启停实例、删除对象、批量操作等命令会影响真实资源：先在非生产环境验证，确认
server-id、桶名等标识无误。
Skill 为纯指引，不能代替你在华为云控制台或 IAM 中的权限审批；requires_api_key=true 只说明内容会涉及密钥配置，不会自动替你保管密钥。
结尾¶
hwc-cli-guidance-v2 把 KooCLI 从安装到常用服务命令、自动化示例和排错表收敛进一份 Agent 可读的技能包，适合作为华为云 CLI 相关提问的固定参考层。需要查看元数据或安装说明时，可打开 SkillHub 页面：
- https://www.skillhub.cn/skills/user_15292d5a/yjkj-hwc-cli-guidance-v2
- https://api.skillhub.cn/user_15292d5a/yjkj-hwc-cli-guidance-v2
KooCLI 行为与 API 以华为云官方文档为准：https://support.huaweicloud.com/qs-hcli/hcli_02_003.html
