SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场huawei-cloud-skill-creator

huawei-cloud-skill-creator

智能体与模型

查看项目

更新于 10-15 12:07

技能介绍

用途

Huawei Cloud Skill Creator v2 用于创建和打包符合华为云技能规范的技能包。它基于六阶段严格流水线运行，每个阶段依赖上一阶段的输出，不可跳过；若某阶段缺失，需从缺失阶段重新开始。该工具只创建/打包技能，不直接操作云资源（不创建、删除或修改 ECS、VPC、OBS 等）；如需操作云资源，应生成管理类技能或使用其他专门的管理技能。

主要能力

六阶段流水线：

  1. 阶段一（问答）：通过苏格拉底式逐题对话澄清需求，覆盖目标服务、功能范围、执行模式、CLI 操作、触发场景等维度，每 5 个问题或覆盖全部维度后展示需求汇总表并等待用户确认。
  2. 阶段二（技术调研）：按 CLI→SDK→API 三级回退顺序调研每个功能点的可用性。CLI 通过 hcloud 命令验证；SDK 通过 huaweicloudsdk 导入验证；API 端点仅允许来自 SDK 源码的 _http_info/resource_path 或华为云 API Explorer，严禁猜测或推断 API 路径。
  3. 阶段三（文档生成）：生成 SKILL.md、references/、scripts/、templates/ 等目录结构，包含 YAML frontmatter、概述、前置条件、工作流、核心命令、参数确认、参考文档等章节，并生成 Mermaid 数据流图和最小权限 IAM 策略。
  4. 阶段四（测试准备）。
  5. 阶段五（详细测试）。
  6. 阶段六（资源清理与合规检查）。

每个阶段必须输出阶段摘要（phase-N-summary），开始新阶段前须验证上一阶段摘要文件存在，全部完成后进行最终缺失检查。

使用方式

前置条件：

  • 已安装并认证 hcloud CLI（参考 https://support.huaweicloud.com/qs-hcli/hcli_02_003.html）。
  • 通过预检（hcloud configure list）验证认证。
  • Python 3.8+ 及 huaweicloudsdk 包，按需安装：pip install huaweicloudsdkcore huaweicloudsdkecs；在阶段二/四/五前用 python3 -c "import huaweicloudsdkcore" 验证。
  • Node.js + npx 可用。
  • 华为云 AK/SK（自动扫描 HUAWEI / HW / HWC 前缀且名称含 ACCESS_KEY / _AK / SECRET_KEY / _SK 的环境变量）。
  • skill-quality-cli，由 bash scripts/ensure_cli.sh 确保安装（幂等，已存在则跳过）。

凭证预检（强制门禁）：在任何 hcloud / huaweicloudsdk 命令（包括阶段二调研、阶段四/五测试、阶段六验证）之前必须通过。若未检测到有效凭证配置，须停止并通过带外方式获取凭证。凭证来源优先级：环境变量、hcloud configure list 配置、IAM 委托/临时凭证。

安全规则：绝不读取、回显或打印 AK/SK 值；绝不读取磁盘上的凭证文件；绝不要求用户在对话或命令行中直接输入 AK/SK；绝不使用字面量凭证调用 hcloud configure set；仅使用 hcloud configure list 检查凭证状态。

命令包装（强制）：本技能中每条 hcloud 命令都必须用 skill-quality-cli run --skill-name huawei-cloud-skill-creator -- 包装，禁止裸调用 hcloud。示例：

skill-quality-cli run --skill-name huawei-cloud-skill-creator -- hcloud configure list skill-quality-cli run --skill-name huawei-cloud-skill-creator -- hcloud ECS ListFlavors --cli-region=cn-north-4 --help

环境变量设置模板（真实值须在会话外填写，绝不在聊天中输入）：

export HUAWEICLOUD_SDK_AK="<your-access-key-id>" read -rs HUAWEICLOUD_SDK_SK; export HUAWEICLOUD_SDK_SK export HUAWEICLOUD_SDK_REGION="cn-north-4"

临时凭证(可选): export HUAWEICLOUD_SDK_SECURITY_TOKEN="<temporary-token>"

升级：手动运行 skill-quality-cli upgrade（无自动升级）。禁用遥测上报：设置 SKILL_QUALITY_REPORT=0。

适用场景

需要为华为云服务（如 ECS、VPC、OBS、RDS、BSS 等）创建符合规范的技能包时使用，例如生成查询、诊断、部署、监控、管理类技能。适用于日常巡检、故障排查、自动扩缩容等触发场景的技能构建。

限制

  • 不直接操作云资源，仅创建/打包技能。
  • 六阶段不可跳过，每阶段依赖上一阶段输出。
  • API 端点严禁猜测，仅允许来自 SDK 源码或 API Explorer，否则标记 ⛔。
  • 打包限制：文件总内容 ≤ 40 MB，文件总数 ≤ 30，SKILL.md ≤ 500 行。
  • 文件扩展名须在 46 种允许列表内。
  • 一个 PR 只能修改一个技能目录。
  • 凭证预检未通过则终止，不得跳过需要凭证的步骤。
  • 具体收费、价格信息暂未提供。