awslabs/agent-plugins

# AWS 的 Agent 插件 _阅读其他语言版本：[日本語](README.jp.md)_ ## 新增内容 ## AWS 的 Agent 插件 AWS 的 Agent 插件为 AI 编程 agent 赋予了相关技能，以帮助您在 AWS 上进行架构设计、部署和运维。Agent 插件目前受 Claude Code、Codex 和 Cursor 支持。 AI 编程 agent 在软件开发中的使用日益增多，帮助开发者更高效地编写、审查和部署代码。Agent 技能以及更广泛的 agent 插件打包模型正在成为最佳实践，用于引导编程 agent 实现可靠的结果，同时避免使模型上下文膨胀。开发者现在可以将 AWS 指导编码为可重用的、带版本控制的功能，由 agent 在相关时调用，而无需将冗长的 AWS 指南重复粘贴到提示中。这提高了确定性，减少了上下文开销，并使 agent 行为更容易在团队中实现标准化。Agent 插件充当将不同类型的专业知识产物打包在一起的容器。单个 agent 插件可以包括： - Agent 技能 – 结构化的工作流和最佳实践手册，引导 AI 完成部署、代码审查或架构规划等复杂任务。Agent 技能将领域专业知识编码为分步流程。 - MCP 服务器 – 与外部服务、数据源和 API 的连接。MCP 服务器使您的助手能够在运行时访问实时文档、定价数据和其他资源。了解更多关于 [AWS 的 MCP 服务器](https://github.com/awslabs/mcp)的信息。 - Hooks – 在开发者操作时运行的自动化和护栏。Hooks 可以验证更改、执行标准或自动触发工作流。 - References – agent 技能可以查阅的文档、配置默认值和知识。References 使 agent 技能更智能，而不会使提示膨胀。 随着该领域出现新类型的专业知识产物，它们可以被打包到 agent 插件中，使得这种演进对开发者是透明的。 ## 最佳实践 为了在保持安全性和代码质量的同时最大化插件辅助开发的收益，请遵循以下基本准则： - 在部署之前始终审查生成的代码（例如，对照您的安全性、成本、弹性约束进行检查） - 将插件用作加速器，而不是开发者判断和专业知识的替代品。 - 保持插件更新，以受益于最新的 AWS 最佳实践。 - 在配置 AWS 凭证时遵循最小权限原则。 - 对生成的基础设施代码运行安全扫描工具。 ## 插件 | 插件 | 描述 | 状态 | | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- | | **amazon-location-service** | 使用 Amazon Location Service 为应用程序添加地图、地理编码、路线规划、地点搜索和地理空间功能 | 可用 | | **aws-amplify** | 使用 AWS Amplify Gen 2 构建全栈应用，包含身份验证、数据、存储和功能的引导式工作流 | 可用 | | **aws-serverless** | 使用 Lambda、API Gateway、EventBridge、Step Functions 和 durable functions 构建无服务器应用程序 | 可用 | | **codebase-documentor-for-aws** | 分析部署在 AWS 上的服务和代码库，以生成带有事实来源引用的结构化技术文档 | 可用 | | **databases-on-aws** | AWS 数据库组合的数据库指南 — schema 设计、查询、迁移和多租户模式 | 部分服务可用 (Aurora DSQL) | | **deploy-on-aws** | 将应用程序部署到 AWS，包含架构建议、成本估算和 IaC 部署 | 可用 | | **sagemaker-ai** | 以直接引入到您的编程助手中、涵盖 [Amazon SageMaker AI](https://aws.amazon.com/sagemaker/ai/) 范围的深厚 AWS AI/ML 专业知识来构建、训练和部署 AI 模型 | 可用 | ## 安装 ### Claude Code #### 添加 marketplace ``` /plugin marketplace add awslabs/agent-plugins ``` #### 安装插件 ``` /plugin install amazon-location-service@agent-plugins-for-aws ``` 或 ``` /plugin install aws-amplify@agent-plugins-for-aws ``` 或 ``` /plugin install aws-serverless@agent-plugins-for-aws ``` 或 ``` /plugin install codebase-documentor-for-aws@agent-plugins-for-aws ``` 或 ``` /plugin install databases-on-aws@agent-plugins-for-aws ``` 或 ``` /plugin install deploy-on-aws@agent-plugins-for-aws ``` 或 ``` /plugin install sagemaker-ai@agent-plugins-for-aws ``` ### Codex Codex 通过 `.agents/plugins/marketplace.json` 以及位于 `plugins/*/.codex-plugin/plugin.json` 下的各插件清单支持仓库本地的 marketplace 和插件清单；此仓库包含这两者，并遵循 [构建插件](https://developers.openai.com/codex/plugins/build)中的官方 Codex 插件打包指南。 要从本仓库在 Codex 中试用这些插件： 1. 在本地克隆此仓库。 2. 在 Codex 中打开该仓库，以便 Codex 能够发现 `.agents/plugins/marketplace.json`。 3. 重启 Codex。 4. 打开插件目录，选择 `Agent Plugins for AWS` marketplace， 然后安装您想要使用的插件。 已知限制： - 特定于 Claude 的自动 hooks 尚未连接到 Codex 清单中。 - 包含了 `databases-on-aws` 提示 hook，因为它不依赖于 特定于 Claude 的环境变量。 ### Cursor 您可以从 [Cursor Marketplace](https://cursor.com/marketplace/aws) 安装 **deploy-on-aws** 插件。有关更多信息，请参阅 [Cursor 插件文档](https://cursor.com/docs/plugins)。您也可以在 Cursor 应用程序内进行安装： - 打开 Cursor 设置 - 导航到 `Plugins` - 搜索 `AWS` - 选择您要安装的插件并点击 `Add to Cursor` - 选择已安装插件的范围 - 该插件应显示在 `Plugins -> Installed` 下 ### Kiro (实验性) 您可以使用第三方 [`@every-env/compound-plugin`](https://www.npmjs.com/package/@every-env/compound-plugin) CLI 将 Claude Code 插件转换为 Kiro 格式。这会将技能（SKILL.md 工作流指令和参考文档）以及 MCP 服务器配置转换为 Kiro 的 `.kiro/` 格式。 需要 [Bun](https://bun.sh)（建议使用最新版本）。 #### 项目范围 写入当前工作目录中的 `.kiro/`： ``` COMPOUND_PLUGIN_GITHUB_SOURCE=https://github.com/awslabs/agent-plugins \ bunx @every-env/compound-plugin install deploy-on-aws --to kiro ``` #### 全局范围 写入 `~/.kiro/`，以便技能可在所有项目中使用： ``` COMPOUND_PLUGIN_GITHUB_SOURCE=https://github.com/awslabs/agent-plugins \ bunx @every-env/compound-plugin install deploy-on-aws --to kiro --output ~/.kiro ``` 将 `deploy-on-aws` 替换为上表中的任何插件名称（例如，`aws-serverless`、`amazon-location-service`、`migration-to-aws`、`aws-amplify`）。 有关转换工具的问题，请在 [EveryInc/compound-engineering-plugin](https://github.com/EveryInc/compound-engineering-plugin/issues) 报告。 ## amazon-location-service 引导开发者使用 Amazon Location Service 添加地图、地点搜索、地理编码、路线规划和其他地理空间功能，包括身份验证设置、SDK 集成和最佳实践。 ### Agent 技能触发器 | Agent 技能 | 触发器 | | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | | **amazon-location-service** | "add a map", "geocode an address", "calculate a route", "location-aware app", "Amazon Location Service", "geospatial", "places search" | ### MCP 服务器 | 服务器 | 用途 | | ----------- | -------------------------------------- | | **aws-mcp** | AWS 文档和服务指南 | ## aws-amplify 使用 AWS Amplify Gen 2 通过 TypeScript code-first 开发构建全栈应用，并由官方 AWS Agent 标准操作程序 (SOPs) 提供指导。 ### 工作流 1. **后端** - 创建 Amplify Gen 2 资源（身份验证、数据、存储、函数） 2. **沙盒** - 部署到沙盒以进行测试 3. **前端与测试** - 将前端连接到后端，在本地进行验证 4. **生产环境** - 部署到生产环境 ### Agent 技能触发器 | Agent 技能 | 触发器 | | -------------------- | ------------------------------------------------------------------------------------------------------------ | | **amplify-workflow** | "build Amplify app", "create Amplify project", "add auth to Amplify", "deploy Amplify", "full-stack Amplify" | ### MCP 服务器 | 服务器 | 用途 | | ----------- | -------------------------------------- | | **aws-mcp** | AWS 文档和服务指南 | ## aws-serverless 使用 AWS Lambda、API Gateway、EventBridge、Step Functions 和 durable functions 设计、构建、部署、测试和调试无服务器应用程序。包括 SAM 和 CDK 部署工作流、SAM 模板验证 hook，以及用于构建弹性、长时间运行、多步骤应用程序的 AWS Lambda durable functions 技能。 ### Agent 技能触发器 | Agent 技能 | 触发器 | | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **aws-lambda** | "Lambda function", "event source", "serverless application", "API Gateway", "EventBridge", "Step Functions", "serverless API", "event-driven architecture", "Lambda trigger" | | **aws-serverless-deployment** | "use SAM", "SAM template", "SAM init", "SAM deploy", "CDK serverless", "CDK Lambda construct", "NodejsFunction", "PythonFunction", "serverless CI/CD pipeline" | | **aws-lambda-durable-functions** | "lambda durable functions", "workflow orchestration", "state machines", "retry/checkpoint patterns", "long-running stateful Lambda", "saga pattern", "human-in-the-loop" | ### MCP 服务器 | 服务器 | 用途 | | ---------------------- | ------------------------------------------------------------------------------------ | | **aws-serverless-mcp** | 无服务器开发指南、项目脚手架、IaC 生成和部署 | ### Hooks | Hook | 触发器 | 动作 | | --------------------------- | --------------------------------------------- | --------------------------------------------- | | **SAM template validation** | 编辑 `template.yaml`/`template.yml` 之后 | 运行 `sam validate` 并内联报告错误 | ## codebase-documentor-for-aws 分析代码库以生成结构化的技术文档，带有事实来源引用，将每个发现链接回生成它的确切代码。使用大纲驱动的 pipeline 系统地分析任何规模的代码库，并带有一个用于可恢复性的持久任务板。 ### Agent 技能触发器 | Agent 技能 | 触发器 | | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **document-service** | "analyze this codebase", "generate documentation", "document this service", "I inherited this code", "help me understand this system", "draw the architecture", "what does this system look like" | ### MCP 服务器 | 服务器 | 用途 | | ---------------- | -------------------------------------------------------------------- | | **awsknowledge** | AWS 服务描述、架构指南、文档链接 | | **awsiac** | CDK/CloudFormation 资源 schema 验证和 IaC 最佳实践 | ## databases-on-aws AWS 数据库组合的数据库指南。设计 schema、执行查询、处理迁移、构建应用程序，并为您的负载选择合适的数据库。目前包括 Aurora DSQL —— 一种无服务器的、兼容 PostgreSQL 的分布式 SQL 数据库。 ### Agent 技能触发器 | Agent 技能 | 触发器 | | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------- | | **dsql** | "Aurora DSQL", "DSQL schema", "distributed SQL database", "serverless PostgreSQL-compatible database", "create DSQL table", "migrate to DSQL" | ### MCP 服务器 | 服务器 | 用途 | | ---------------- | -------------------------------------------------------------------------------- | | **awsknowledge** | AWS 文档、架构指南和最佳实践 | | **aurora-dsql** | 直接数据库操作 —— 查询、schema、事务（默认禁用） | ### Hooks | Hook | 触发器 | 动作 | | ----------------------- | --------------------------- | -------------------------------------------------------- | | **Schema verification** | `transact` 操作之后 | 提示验证 schema 更改和受影响的行 | ## deploy-on-aws 为 agent 装备加速 AWS 部署的技能 —— 推荐 AWS 架构和服务、估算成本、生成基础设施即代码（CDK 或 CloudFormation）并指导您完成部署。 ### 工作流 1. **分析** - 扫描代码库以获取框架、数据库、依赖项 2. **推荐** - 选择 AWS 服务并附带简明理由 3. **估算** - 在继续之前显示成本估算 4. **生成** - 编写 IaC 代码（CDK/CloudFormation） 5. **部署** - 在用户确认后执行 ### Agent 技能触发器 | Agent 技能 | 触发器 | | ----------- | --------------------------------------------------------------------------------------------------------------------- | | **deploy** | "deploy to AWS", "host on AWS", "run this on AWS", "AWS architecture", "estimate AWS cost", "generate infrastructure" | ### MCP 服务器 | 服务器 | 用途 | | ---------------- | ------------------------------------------------------------ | | **awsknowledge** | AWS 文档、架构指南和最佳实践 | | **awspricing** | 用于成本估算的实时 AWS 服务定价 | | **aws-iac-mcp** | CDK/CloudFormation 的 IaC 最佳实践 | ## sagemaker-ai 以直接引入到您的编程助手中、涵盖 [Amazon SageMaker AI](https://aws.amazon.com/sagemaker/ai/) 范围的深厚 AWS AI/ML 专业知识来构建、训练和部署 AI 模型。[了解更多](./plugins/sagemaker-ai/README.md)。 ## 要求 - Claude Code >=2.1.29 或 [Cursor >= 2.5](https://cursor.com/changelog/2-5) - 已配置具有适当凭证的 AWS CLI ## 故障排除 在插件安装或使用方面遇到问题？请参阅我们的[故障排除指南](./docs/TROUBLESHOOTING.md)获取常见解决方案。 ## 贡献 向我们的优秀贡献者致以最崇高的敬意！感谢您让这个项目变得更好！ 我们欢迎各种形式的贡献！请查看我们的[贡献者指南](./CONTRIBUTING.md)了解更多信息。 ## 开发者指南 如果您想向库中添加新插件，请查看我们的[设计指南](./docs/DESIGN_GUIDELINES.md)和[开发指南](./docs/DEVELOPMENT_GUIDE.md)。 ## 维护者 仓库审查员、维护者和管理员可以在[维护者指南](./docs/MAINTAINERS_GUIDE.md)中找到 PR 审查工作流、合并规则和 CI/CD 文档。 ## 管理员 GitHub 环境和 AWS 账户配置记录在[管理员指南](./docs/ADMINISTRATORS_GUIDE.md)中。 ## 其他资源 - [Introducing Agent Plugins for AWS 博客](https://aws.amazon.com/blogs/developer/introducing-agent-plugins-for-aws/) - [使用 AWS 插件扩展 Cursor](https://cursor.com/blog/marketplace) - [AWS 的 MCP 服务器](https://github.com/awslabs/mcp) - [Claude Code 插件文档](https://code.claude.com/docs/en/plugins) - [Cursor 插件文档](https://cursor.com/docs/plugins) ## 许可证 本项目根据 Apache-2.0 许可证授权。

标签：AI 开发者工具, AI 编程助手, AWS, CISA项目, Claude Code, Codex, Cursor, DLL 劫持, DPI, IaC 基础设施即代码, LLM 工具链, MCP 服务器, 云原生开发, 云架构, 亚马逊云科技, 代码审查, 大语言模型, 工作流自动化, 提示词工程, 插件, 数字取证, 智能编码, 特权提升, 策略决策点, 自动化脚本, 自动化运维, 自动化部署, 软件开发