huawei-cloud-solution-ops

Huawei Cloud Agent Skill

概述（核心定位）

• 单一 skill 覆盖华为云上云、用云、管云场景，默认以租户体验和可验证闭环为中心。
• 云资源默认优先使用 hcloud：它更适合 Agent 做 operation 发现、一次性查询/变更、dry-run 和回读。Agent 仍根据任务意图、运行时能力和证据质量自行选择 hcloud、SDK 或 Terraform，详细决策见 references/backend-selection.md。
• SDK 是受支持的程序化后端，适合类型化请求、复杂 body、分页/并发、结构化异常，或 hcloud 当前确有覆盖/解析障碍的任务。hcloud_sdk_readonly.py 的 allowlist 只约束该便捷 runner，不限制 Agent 编写任务专用 SDK 代码。
• Terraform 由 IaC 意图触发，用于可重复创建、环境复制、长期纳管、import 或 drift；它不是 hcloud 失败后的普通兜底。前置发现和后置验证优先用 hcloud，也允许等价 SDK/API、data source 和业务探测证据。
• 高频脚本是对上述后端的可选封装，不是第四种后端。脚本覆盖目标时优先复用其版本选择、参数校验、脱敏、输出收敛和错误分类；未覆盖的长尾任务可直接使用有证据的 hcloud、官方 SDK 或 Terraform。
• 文档中的 python3 scripts/<name>.py ... 假设当前目录是 Skill 根目录。当前目录不确定时，用 bin/hcloud-skill <name> ...；Windows 用 bin/hcloud-skill.cmd <name> ...。这个稳定入口只定位当前 Skill 自带脚本并原样传递参数，不替 Agent 选择服务、operation、参数或调用顺序。
• 面向 Agent 的脚本成功结果至少提供布尔 success；默认最终 stdout 是 JSON object。大结果或已选择的结构化入口可进一步提供 huaweicloud_skill_public_result_v1 artifact 回执，但小型 planner/inspector 不需要机械增加 --output-file。显式 Markdown、shell-command 和逐项图片进度模式见 references/public-script-contract.md。
• hcloud 不可用不等于整个 Skill 不可用；如果 SDK 或 Terraform 符合任务且运行条件完备，可以继续。无论使用哪个后端，没有真实执行和回读证据时都不能宣称已经查询、修改或完成。
• MaaS 是 API-first 能力面。模型调用使用 MaaS API Key；用量统计是治理查询，按本地 AK/SK 签名规划处理。不要让用户在对话里粘贴密钥。
• 目标不是背命令，而是稳定完成：识别上下文 -> 发现资源/operation -> 构造安全命令 -> 查询或变更 -> 回读验证 -> 处理错误。

什么时候使用

优先在这些场景使用本 skill：

• 用户提到华为云、hcloud、KooCLI、CLI、命令行、云资源查询、创建、变更、排障或治理。
• 用户需要查看 service/operation、构造 --cli-jsonInput、使用 --cli-query、--dryrun、--cli-waiter 等 CLI 能力。
• 用户需要华为云认证、region/project、profile、meta cache、网络或输出格式排查。
• 用户明确需要 Terraform/IaC、MaaS 大模型/图像/视频，或华为云 Web/OBS/CDN/ECS 站点资产辅助。

不要把本 skill 当成非华为云的通用云知识问答、无证据 API 猜测器、自动 Terraform apply 器，或非华为模型服务兜底。

hcloud 命令应显式携带当前任务的区域，标准形态为：

hcloud <Service> <Operation>/<version> --cli-region=<region> <business-parameters>

全局服务确认不需要 region 时才可省略；跨区域任务不得依赖 profile 的隐式默认值。

跨服务和多轮任务

本 skill 用少量共享语义帮助不同服务场景保持目标、事实来源和完成口径一致，但它不是任务执行控制器。Agent 仍然负责理解现场情况，并自主选择或调整服务、工具、参数和操作次序。