huaweicloud-skill

name	huaweicloud-skill
description	使用 hcloud 命令行工具执行华为云资源查询、分析、规划和变更；也支持通过华为云 MaaS API 规划和调用大模型、图像理解、图片生成/编辑与视频生成任务。适用于 CLI/KooCLI 云资源操作、MaaS API 调用、认证排查、命令构造、执行验证和安全变更规划。

Huawei CLI Skill

核心定位

• 单一 skill 覆盖华为云上云、用云、管云场景，默认以租户体验和可验证闭环为中心。
• hcloud 是云资源查询、执行、回读和验收的主链路；没有可用 hcloud 时，不宣称已经查询或修改云资源。
• SDK 只做窄范围补充，例如参数、region/endpoint、错误结构、凭证来源线索，或 allowlist 内的稳定只读查询。
• Terraform 是辅助 IaC 面，只在用户明确需要可重复创建、环境复制、长期纳管、import 或 drift review 时进入；不能跳过 hcloud 发现和后置验证。
• 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 当成通用云知识问答、通用 SDK 执行器、通用 Terraform apply 器，或非华为模型服务兜底。

默认工作流

1. 先确认环境和上下文：
   • 首选 python3 scripts/hcloud_environment_doctor.py --pretty 或 python3 scripts/hcloud_context_inspect.py --pretty。
   • 若 hcloud.found=false，停止真实云查询和变更，只能给本地方案草稿和安装指引。
2. 宽泛目标先路由：
   • 用 hcloud_scenario_router.py 找到本地 playbook、guide、planner、SDK supplement 和 Terraform 候选。
   • 只读取命中的少量资料，不全量浏览 catalog、Terraform 示例或长 reference。
3. 查询类默认稳定化：
   • 默认 JSON 输出，必要时用 --cli-query、--result-file 或 parsed JSON 文件控制大结果。
   • 返回为空不等于失败；必要时检查 region/project、过滤条件、权限和状态码。
4. 变更类先计划再执行：
   • 先查现状证据，再生成 change plan / dry-run / guarded submit。
   • 真实 submit 必须有本次操作的明确用户确认；安全、身份、密钥、治理类 mutation 默认 hard guard。
5. P0 高频服务闭环：
   • 先运行 hcloud_closure_plan.py --tier lifecycle 生成 lifecycle plan 和 acceptance_evidence_plan。
   • 再用 hcloud_acceptance_closure.py plan/run/evaluate/chain 做采证计划、受支持探测和 evidence 结果判定。
   • 做真实账号回归或服务晋级时，用 hcloud_live_validation_plan.py 列出 ECS/VPC/EIP/OBS/ELB/RDS 的目标输入、读回、probe 和晋级缺口。
6. 完成声明要诚实：
   • job_id、accepted、云侧 ACTIVE、Terraform plan 成功、MaaS task_id 都不等于业务可用。
   • 需要协议、健康、机内、日志、指标或用户路径证据时，必须说明已采集、缺失或被阻塞。

安全边界摘要

详细规则在 references/runtime-safety-boundaries.md。执行创建、变更、网络暴露、ECS 机内操作、COC/SSH fallback、应用验收或排障前先读取该 reference。

风险点	默认处理
凭据、AK/SK、API Key、私钥	不在对话、日志、manifest、站点代码中回显或保存；让用户使用本地环境变量/profile。
安全组入口	SSH/Web 常见端口不得自动开放到 0.0.0.0/0；复用已有安全组也要读回规则。
异步云任务	跟到 job 终态，再做资源状态、协议或业务验收。
Terraform 状态	import/state/remote state 是高影响操作；必须显式确认，不能自动 apply/destroy。
MaaS 视频和异步任务	task_id 只是受理凭据，必须查询终态。
账单/成本	不从资源清单推断费用；账单结果要脱敏、区分 fact/grain/money basis/scope。
自动 live probe	只执行 plan 派生的 HTTP/TCP/DNS/TLS；元数据/link-local 目标拒绝，内网/localhost 需显式确认。
结果叙事	只描述真实发生的命令、输出和验证；不要编造失败-恢复过程或把计划态写成已执行。

首选入口

完整脚本说明和命令模板在 references/scripts.md。这里仅保留默认入口，避免在运行时让模型浏览长脚本表。

任务	首选入口
环境、认证、profile、region/project	hcloud_environment_doctor.py、hcloud_context_inspect.py
自然语言场景路由	hcloud_scenario_router.py
真实 hcloud 查询或受控系统命令	hcloud_safe_exec.py
多服务发现、目标查询、readiness/live validation	hcloud_resource_discovery.py、hcloud_resource_query.py、hcloud_service_readiness.py、hcloud_live_validation_plan.py
创建/变更计划和 guarded flow	hcloud_change_plan.py、hcloud_service_change_plan.py、hcloud_guarded_change_flow.py
P0/P1/P2 闭环计划和验收	hcloud_closure_plan.py、hcloud_acceptance_closure.py
盘点、闲置、成本、治理	hcloud_account_inventory.py、hcloud_idle_audit.py、hcloud_billing_readonly.py、hcloud_billing_live_read.py
Terraform/IaC	hcloud_terraform_context_inspect.py、hcloud_terraform_router.py、hcloud_terraform_operations_plan.py
MaaS 模型调用、图片/视频、用量治理	maas_models.py、maas_chat.py、maas_image_generation.py、maas_video_generation.py、maas_usage_request_plan.py
脚本边界、维护分层、完整命令模板	references/scripts.md、references/script-audience-manifest.json

资料入口

按任务需要读取，不要一次性加载所有资料：

• 基础流程和安全：references/workflow.md、references/runtime-safety-boundaries.md、references/auth-and-context.md
• 场景路由和服务资料：references/scenario-router.json、references/guides/、references/playbooks/
• 命令构造和错误处理：references/command-construction.md、references/error-playbook.md、references/output-and-query.md
• 脚本索引和受众边界：references/scripts.md、references/script-audience-manifest.json
• Terraform：references/terraform-workflow.md、references/terraform/README.md、references/terraform/operations.md
• MaaS：references/maas-model-calls.md、references/playbooks/maas-api-readiness.md、references/playbooks/maas-usage-governance.md
• 覆盖和晋级：references/service-coverage.md、references/service-curation-profiles.json、references/live-validation-profiles.json、hcloud_closure_maturity_audit.py
• 版本事实：references/versioning-policy.md、CHANGELOG.md、RELEASE_NOTES.md
• 溯源和材料：references/source-map.md、references/materials-sources.json

原始 KooCLI 材料在 materials/ 下，仅作为资料源，不直接当最终指令集使用。涉及 API 字段语义时，以华为云官方文档和实际 hcloud --dryrun/查询结果为准。

能力边界

• ECS guidance 最完整，覆盖创建前校验、dry-run、job 终态、ACTIVE 回读、SSH 和应用验收。
• P0 高频服务有 lifecycle planner 和 acceptance closure；P1/P2 主要是 governance/scenario planner，不能说成完整执行闭环。
• OBS、MaaS、Billing、Terraform 都有专门边界：各自只在明确场景进入，不替代 hcloud 主链路。
• 长尾安全、数据库、治理、身份和 key 类服务多为 metadata-backed evidence gap；先做发现、计划和证据缺口，不默认执行 mutation。
• 自动 live probe 只支持内置 HTTP/TCP/DNS/TLS；内网、localhost 或 .local 目标必须带 --allow-private-targets 且来自已审阅的 evidence plan，其他 evidence 需要人工或专用工具采集后再 evaluate。
• 真实账号回归、Terraform state-changing import、计费资源创建/释放仍需要用户提供隔离环境、资源 ID、profile/region 和明确确认。