AgentSkillsCN

aliyun-eci-openapi

ECI OpenAPI/SDK 调用设计与故障定位。适用于需要通过代码自动化完成 ECI 资源（实例、镜像缓存、DataCache、虚拟节点等）的创建、查询、更新、删除操作，并提供最小化请求、权限认证（RAM/STS）以及错误码排查路径时使用。

SKILL.md
--- frontmatter
name: aliyun-eci-openapi
description: "ECI OpenAPI/SDK 调用设计与故障定位。Use when 需要通过代码自动化创建、查询、更新、删除 ECI 资源（实例、镜像缓存、DataCache、虚拟节点等），并给出最小请求、鉴权（RAM/STS）与错误码排查路径。"

阿里云 ECI OpenAPI/SDK

快速工作流（按官方文档落地）

  1. •先定位官方 API 文档页面
  • •优先用 $aliyun-eci-docs 本地索引检索（更快、更稳）
    • •python3 ~/.codex/skills/aliyun-eci-docs/scripts/eci_docs.py search CreateContainerGroup
    • •python3 ~/.codex/skills/aliyun-eci-docs/scripts/eci_docs.py search ExecContainerCommand
  • •命中后拉取并阅读关键段落（参数/示例/错误码/限制）
    • •python3 ~/.codex/skills/aliyun-eci-docs/scripts/eci_docs.py fetch <URL> --format md
  1. •明确鉴权与权限边界（RAM/STS）
  • •确认调用方身份：主账号/子账号 RAM User/STS 临时凭证/实例 RAM 角色
  • •按“最小权限”原则给出策略建议（具体 Action/Resource 以官方文档为准）
  1. •形成“最小可用请求 + 可选增强项”
  • •最小可用：只包含必填参数，确保能创建/查询成功
  • •增强项：网络/存储/日志/安全/规格等按场景逐项加入
  • •输出时必须带：参数解释、常见报错定位、依据链接（官方 URL）
  • •输出结构优先按 references/minimal_api_workflow_templates.md 的模板组织

常见需求到 API 的映射（只作导航）

  • •创建/删除/查询实例：CreateContainerGroup / DeleteContainerGroup / DescribeContainerGroups
  • •查看事件/状态：DescribeContainerGroupEvents / DescribeContainerGroupStatus
  • •进入容器执行命令：ExecContainerCommand
  • •拉取容器日志：DescribeContainerLog
  • •镜像缓存：CreateImageCache / DescribeImageCaches / DeleteImageCache
  • •DataCache：CreateDataCache / DescribeDataCaches / DeleteDataCache
  • •虚拟节点：CreateVirtualNode / DescribeVirtualNodes / DeleteVirtualNode

输出模板（回答/交付时遵循）

  • •结论：该场景需要调用哪些 API、建议的调用顺序
  • •最小示例：请求参数清单（必填/选填分组），必要时给伪代码/请求体结构
  • •参数解释：每个关键字段“从哪里来/如何获取/常见坑”
  • •权限与鉴权：需要的 RAM 角色/策略方向（不直接臆造具体 Action 列表）
  • •排障：常见错误码/现象 -> 定位路径 -> 可能原因
  • •依据：列出官方文档 URL

参考资料（需要细节时再读）

  • •references/openapi_cheatsheet.md: 常见调用套路与排障导航
  • •references/official_link_baseline.md: OpenAPI 常用 Action 官方链接基线
  • •references/minimal_api_workflow_templates.md: 最小可用调用流程模板（含鉴权/排障结构）
  • •references/full_scope_urls.md: aliyun-eci-openapi 主路由文档全量清单（45 篇）
  • •~/.codex/skills/aliyun-eci-docs/references/eci_full_skill_coverage.md: 全量文档覆盖矩阵（先确认该问题属于 OpenAPI 路由）
  • •~/.codex/skills/aliyun-eci-docs/references/eci_full_skill_routing.json: URL -> 主技能路由明细（跨域问题先查）