creating-api-gateway-stage – API Gateway 阶段创建 Skill

Skill 详细介绍

aws/agent-toolkit-for-aws#creating-api-gateway-stage 是 AWS 官方 agent-toolkit-for-aws 仓库中的一个技能条目，从命名来看，它面向的是 Amazon API Gateway 中“阶段（Stage）”的创建与管理任务。

需要先明确一点：它本身不是一个可以独立运行的软件。它是一段提供给 AI Agent 加载的结构化指令 / 工作流指引。安装之后，Agent 不会因此获得新的运行时能力，而是获得一套关于“如何为 API Gateway 配置并创建 Stage”的操作知识，从而在需要时更规范地帮你完成这类任务。

它主要解决什么问题：

– 用户在用 AI Agent 操作 AWS 时，常常需要为 REST API / HTTP API 创建部署阶段（例如 dev、staging、prod）。
– Stage 涉及部署、阶段名称、阶段变量、日志、限流、自定义域名映射、访问日志、X-Ray 追踪等一系列配置项。
– 如果没有专门指引，Agent 容易漏掉关键参数或给出不规范的操作步骤。
– 该 Skill 的作用，就是把这部分操作经验结构化，让 Agent 在处理这类请求时更有针对性。

核心用途

– 帮助规划 API Gateway 的 Stage 结构。
– 指导创建 Stage 时需要确认的参数与顺序。
– 配合部署（Deployment）流程说明 Stage 的创建时机。

它不是什么

– 不是 AWS CLI 的封装。
– 不是可以直接执行的脚本或 Docker 镜像。
– 不是 API Gateway 的替代管理控制台。

适合的用户

– 正在用 AI Agent 协助管理 AWS 资源的后端工程师、DevOps。
– 需要在多个环境之间划分 API 阶段的团队。
– 希望让 Agent 输出更符合 AWS 规范的操作建议。

不适合的需求

– 只想用图形界面点几下就完成 Stage 创建的轻度用户。
– 需要 Skill 自动代替你执行全部部署与回滚的场景。

关于该 Skill 更细的触发词、支持的 Stage 字段范围与具体工作流步骤，当前官方资料没有在本次可确认范围内完整给出，具体以该 Skill 当前官方说明为准。

Skill 安全评估

从来源看，该 Skill 属于 aws 官方组织的 agent-toolkit-for-aws 仓库，来源可信度较高，这一点是重要的正向信号。但来源可信不代表使用过程中零风险。

需要关注的点：

– 操作对象是云资源。API Gateway 的 Stage 一旦创建并部署，会直接影响线上 API 的流量入口、日志、限流和域名映射。误操作可能影响线上服务。
– 凭证与权限。这类 Skill 通常会引导 Agent 使用已配置好的 AWS 凭证（例如 AWS CLI 的凭证文件、环境变量或 IAM Role）。它本身一般不要求你把裸密钥粘贴到对话里，但真正执行命令时，Agent 所在环境需要有相应权限。
– Shell / 命令执行。如果 Agent 被允许自动执行 Shell 命令，那么它可能直接调用 AWS CLI 完成 Stage 创建。这属于符合用途的权限，但需要你确认账号、区域（Region）与目标 API 是否正确。
– 不可逆性偏低但要慎重复制。创建 Stage 本身大多可删除重建，但如果 Stage 上绑定了自定义域名、访问日志组或 WAF，删除会连带影响线上，需要谨慎。

降低风险的实际建议：

– 尽量在非生产 AWS 账号或测试 API 上先验证一次流程。
– 涉及生产账号时，关闭 Agent 的自动执行 Shell 权限，让它只输出命令，由你人工确认后再执行。
– 确认 AWS CLI 使用的 profile 与 region 是目标环境，避免误操作到错误账号。
– 不要为了图方便，把长期有效的管理员密钥塞进对话或环境变量里。

整体判断：来源可信，功能聚焦，其风险主要在“操作云资源”这一环，而不是 Skill 本身存在恶意行为。是否放权，取决于你对 Agent 执行云命令的信任程度。

Skill 使用要求

一、Agent / 客户端

该 Skill 来自 aws 官方 agent-toolkit-for-aws，官方并没有公布完整的第三方 Agent 兼容列表。从 Agent Skill 的通用工作方式看，在支持 Skills、自定义 Skill 或类似指令加载机制的环境中，通常也可以尝试使用，包括 Codex、Cursor、Trae、OpenClaw、WorkBuddy 等主流 AI Agent。不同 Agent 的 Skill 加载方式与兼容程度可能不同，具体以对应 Agent 当前版本为准。

如果你主要使用 Claude Code，通常可以优先尝试，因为它对基于指令 / 工作流的 Skill 支持较为成熟。

二、运行环境 / 依赖

要真正把 Stage 创建出来，实际操作层面通常离不开 AWS 官方工具链。注意：这部分依赖是“执行任务时需要”，而不是“加载 Skill 本身时需要”。

| 项目 | 要求 |
|—|—|
| Agent | 支持 Skill / 指令加载的 Agent 均可尝试 |
| AWS CLI | 如需实际执行命令，通常需要已安装并配置 |
| AWS 凭证 | 需具备创建 / 修改 API Gateway Stage 的 IAM 权限 |
| 网络 | 需要能访问 AWS 对应区域的 Endpoint |
| Node.js / Python | 该 Skill 本身没有明确要求，取决于你选择的执行方式 |

官方没有为这个 Skill 明确公布 Node.js、Python 等版本要求，因此不要自行假设具体版本。

三、权限

– 文件读取：通常可选，用于读取项目或配置。
– Shell：可选但重要。允许则 Agent 可直接执行 AWS 相关命令；不允许则只输出命令。
– 网络：需要，用于访问 AWS。
– AWS / IAM 权限：必需（若真正执行创建操作），至少覆盖 API Gateway 相关资源。

四、账号 / API Key

Skill 本身一般不需要单独的 API Key。真正需要凭证的是它操作的 AWS 环境，通常使用：

– AWS 访问密钥（Access Key / Secret Key），或
– 已配置好的 AWS CLI profile，或
– 运行环境上的 IAM Role

这些属于 AWS 侧凭证，请按最小权限原则授予，避免使用长期有效的 Administrator 权限。

最小使用条件

1. 一个支持 Skill 的 AI Agent。
2. 一个 AWS 账号，并有可操作的目标 API。
3. 具备创建 API Gateway Stage 的 IAM 权限。
4. （可选）已安装并配置好的 AWS CLI。

Skill 安装、使用与卸载教程

一、安装

你可以直接复制本页面提供的 Skill 安装指令，粘贴到对应的 Agent 或终端执行。

如果你不确定自己的 Agent 怎么装，最简单的方式是直接问它：

如何安装 aws/agent-toolkit-for-aws#creating-api-gateway-stage？

如何在 Claude Code 中安装 aws/agent-toolkit-for-aws#creating-api-gateway-stage？

如何在 Cursor 中安装 aws/agent-toolkit-for-aws#creating-api-gateway-stage？

让当前 Agent 根据自己的 Skill 加载与管理机制给出对应步骤，比手动找目录更稳妥。

如果该 Skill 存在特殊官方安装要求，请以官方仓库说明为准。当前没有确认到需要额外前置步骤的特殊要求。

二、安装后如何使用

安装后，你不需要输入什么神秘命令，直接用自然语言描述任务即可。适合交给它的任务类型：

– 为某个 REST API / HTTP API 创建新的部署阶段。
– 规划 dev / staging / prod 多阶段结构。
– 检查某个 Stage 配置是否完整。

自然语言示例：

使用 creating-api-gateway-stage，帮我在这个 API 上创建一个名为 prod 的部署阶段。

使用 creating-api-gateway-stage，说明一下我的 API 该创建哪几个 Stage，分别用于什么环境。

使用 creating-api-gateway-stage，帮我梳理创建一个 Stage 需要确认哪些参数。

描述需求时，尽量带上：API 名称或 ID、目标 Region、阶段名称、是否需要日志或自定义域名。信息越具体，Agent 给出的步骤越贴合。

三、卸载

不同 Agent 的 Skill 安装位置与管理方式可能不同。常见做法是：

– 使用对应 Agent / Skill 管理器提供的删除或禁用功能。
– 直接询问当前 Agent 如何移除该 Skill。

如果你不确定统一卸载命令，可以直接问：

如何卸载 aws/agent-toolkit-for-aws#creating-api-gateway-stage？

不要手动删除不明目录，以免影响其他 Skill。

常见问题

1. 这个 Skill 会自己帮我创建 Stage 吗？
取决于你的 Agent 配置。如果关闭了 Shell / 命令执行权限，它只输出步骤或命令；如果放开，它可能直接调用 AWS 相关命令。是否放权由你决定。

2. 会不会误操作到生产账号？
有可能，前提是 Agent 使用的 AWS 凭证指向生产账号。建议先确认当前 CLI profile 与 Region，或在测试账号上先走一遍流程。

3. 需要把 AWS 密钥写进对话里吗？
通常不需要。更推荐通过 AWS CLI 的 profile、环境变量或 IAM Role 提供凭证。不要在对话中粘贴长期有效的密钥。

4. 中国大陆网络环境使用有问题吗？
该 Skill 操作的是 AWS，而 AWS 在中国大陆的网络访问与合规有其自身特点。是否顺畅取决于你能访问的 AWS 区域与网络条件，与 Skill 本身无关。

5. 可以同时装到多个 Agent 里吗？
一般可以，各 Agent 的 Skill 目录相互独立。但要注意不同 Agent 的兼容程度可能不同，行为不一定完全一致。

6. 安装后 Agent 好像没反应？
先确认 Skill 是否被正确加载（多数 Agent 有类似“已加载 Skill”的提示或列表），再确认你的提问是否触发了它的使用条件，例如是否明确提到了 API Gateway 阶段。

7. 这个 Skill 和直接用 AWS CLI 有什么区别？
AWS CLI 是执行工具，这个 Skill 是给 Agent 的操作指引。它帮你把“该做什么、按什么顺序做”讲清楚，最终执行往往仍落到 AWS CLI 或 SDK 上。