前言¶

在华为云上查资源、改配置、写自动化脚本，官方文档和 CLI 参数都齐全，但对话式开发时 Agent 往往不知道该用哪条 hcloud 子命令、认证该怎么配、批量脚本要注意什么。自己翻 KooCLI 用户指南再贴回对话，成本高且容易漏步骤。

hwc-cli-guidance 是 SkillHub 上的一类 SKILL.md 指导型 Skill：把 KooCLI 的安装、认证、常用服务命令和运维实践整理成 Agent 可读的说明与示例，让 Cursor、Claude Code 等客户端在回答华为云 CLI 问题时有一致的事实来源。下面介绍它是什么、能做什么，以及如何安装与使用。

这是什么¶

一句话定位：面向华为云命令行工具 KooCLI（hcloud）的中文安装与使用指引 Skill。

• 坐标：@user_15292d5a/yjkj-hwc-cli-guidance
• 版本：1.0.0（包内 _meta.json 与 SkillHub 页面一致）
• 来源：SkillHub 社区（community），发布者 ID 为 user_15292d5a
• 分类：dev-programming
• 标签：requires_api_key=true（使用 KooCLI 通常需要配置华为云 AK/SK 等凭证）

技能包内的 skill-card.md 说明本 Skill 提供 KooCLI 安装、认证配置、常用云管命令与自动化实践指导；许可为 MIT-0。它不替代华为云官方 CLI，而是在 Agent 侧注入可引用的操作说明与命令示例。

核心功能¶

以下内容来自 SkillHub 可下载的 v1.0.0 包（SKILL.md 及 reference/），均为该 Skill 向 Agent 提供的指导能力，而非独立可执行程序。

1. 快速上手：环境要求（Windows / macOS / Linux，文档写明支持 Python 3.8+）、在控制台创建访问密钥、多种安装方式（pip、curl 二进制、Windows PowerShell）、hcloud configure init 配置 Region 等。
2. 认证与配置：AK/SK、Token、多 Profile；hcloud configure list / set / delete 等配置管理命令说明。
3. 常用服务命令示例：ECS（如 hcloud ecs list-servers）、OBS（桶与对象上传下载）、RDS、FunctionGraph 等；并提示可用 hcloud --help 查看完整服务列表。
4. 场景化用法：自动化运维脚本、OBS 批量上传、CES/AOM 等指标查询等示例（含 bash / Python 片段）。
5. 最佳实践与排错：子进程调用时的错误处理、多环境 Profile、--output=json|table 等输出格式；常见 HTTP 错误码（401/403/404/429/500）及处理建议。
6. 延伸阅读：包内 reference/installation-guide.md、command-reference.md、best-practices.md，以及华为云官方 KooCLI 文档链接。

安装与启用¶

SkillHub 页面给出的安装方式是：让 Agent 按 SkillHub 安装说明 安装坐标 @user_15292d5a/yjkj-hwc-cli-guidance。

若本机已安装 skillhub CLI，可按官方文档将 Skill 装到当前 Agent 的 skills 目录（未指定 --dir 时默认 ./skills/，多数客户端不会自动加载）：

command -v skillhub && skillhub --version

skillhub install @user_15292d5a/yjkj-hwc-cli-guidance --dir ~/.cursor/skills/

常见客户端 skills 路径（摘自 SkillHub 安装文档，按你实际使用的客户端选择其一）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

未安装 skillhub CLI 时，可先执行官方推荐的一键安装（完整包含 CLI 与默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装后需重启或重新加载 Agent，使新 Skill 被识别。SkillHub 页面显示的统计为评分 100000、下载 768 次、安装 0（以页面抓取时为准）。

典型用法¶

启用 Skill 后，在对话中提出与 KooCLI 相关的具体任务即可，Agent 会依据 SKILL.md 中的步骤与命令作答。下列流程与技能包内「快速开始」一致，便于你对照验证。

1. 安装 CLI（pip 方式，技能包推荐之一）

pip install huaweicloudsdkcore
pip install huaweicloudsdkkoocli

2. 初始化认证

在华为云控制台「我的凭证」创建 AK/SK 后执行：

hcloud configure init

按提示填写 Access Key ID、Secret Access Key 与 Region（示例：cn-north-4）。

3. 验证常用读操作

hcloud ecs list-servers
hcloud obs list-buckets

若需 JSON 输出，技能文档示例为：

hcloud ecs list-servers --output=json

多环境时技能包建议先 hcloud configure init --profile=dev 等，再通过 hcloud --profile=dev ecs list-servers 切换。

适用场景与注意¶

适合谁

• 已在或计划在华为云上用 KooCLI 做运维、脚本、CI/CD 的开发者。
• 希望 Agent 生成/解释 hcloud 命令时，对齐官方安装路径与认证方式，而不是凭空编造子命令的团队。

限制与注意

• 凭证安全：标签 requires_api_key=true 与技能卡均强调 AK/SK、credentials.csv 等敏感信息；应最小权限 IAM、勿提交到仓库或日志，泄露后及时轮换。技能卡中的风险说明同样建议先在非生产 Profile 验证破坏性命令。
• 操作风险：示例包含启停 ECS、删除 OBS 对象、批量操作等，执行前需确认资源 ID、Region 与账号。
• 安装来源：二进制安装示例使用 https://dl.koo.cloud/cli/...，应按组织安全策略从华为云官方渠道获取并校验包。
• Skill 性质：这是指导文档型 Skill，不会替你执行云 API；实际变更仍由本机 hcloud 与你的权限决定。

结尾¶

hwc-cli-guidance 把华为云 KooCLI 的安装、认证、常用命令与实践收进标准 SKILL.md，适合挂在 Cursor 等 Agent 的 skills 目录，减少查文档与口述参数的时间。安装与详情见 SkillHub：

• 页面：https://www.skillhub.cn/skills/user_15292d5a/yjkj-hwc-cli-guidance
• 坐标：@user_15292d5a/yjkj-hwc-cli-guidance（v1.0.0）