# Agent Plugins for AWS _他の言語で読む: [English](README.md)_ > [!IMPORTANT] > 生成 AI は誤った出力を生成する可能性があります。選択した AI モデルおよびエージェントコーディングアシスタントが生成するすべての出力とコストを確認することを推奨します。[AWS 責任ある AI ポリシー](https://aws.amazon.com/ai/responsible-ai/policy/)を参照してください。 Agent Plugins for AWS は、AI コーディングエージェントに AWS 上でのアーキテクチャ設計、デプロイ、運用を支援するスキルを提供します。Agent Plugins は現在、Claude Code と Cursor に対応しています。 AI コーディングエージェントはソフトウェア開発において急速に普及し、開発者のコード記述、レビュー、デプロイを効率化しています。 エージェントスキルとエージェントプラグインは、モデルのコンテキストを肥大化させることなくコーディングエージェントを的確な結果へ導くためのベストプラクティスとして確立されつつあります。長い AWS ガイダンスをプロンプトに繰り返し貼り付ける代わりに、エージェントが必要に応じて呼び出す再利用可能でバージョン管理された機能としてエンコードすることで、以下のメリットが得られます。 - 出力の決定論性が向上する - コンテキストのオーバーヘッドが削減される - チーム全体でエージェントの動作を標準化しやすくなる エージェントプラグインは、さまざまな種類の専門知識アーティファクトをパッケージ化するコンテナとして機能します。1 つのエージェントプラグインには以下を含めることができます。 - **エージェントスキル** – デプロイ、コードレビュー、アーキテクチャ設計などの複雑なタスクを通じて AI をガイドする、構造化されたワークフローとベストプラクティスのプレイブック。エージェントスキルは、ドメインの専門知識をステップバイステップのプロセスとしてエンコードします。 - **MCP サーバー** – 外部サービス、データソース、API への接続。MCP サーバーは、ランタイムにおいてアシスタントにライブドキュメント、料金データ、その他のリソースへのアクセスを提供します。[MCP Servers for AWS](https://github.com/awslabs/mcp) で詳細をご覧ください。 - **Hooks** – 開発者のアクションに応じて実行される自動化とガードレール。Hooks は変更の検証、標準の適用、ワークフローの自動トリガーが可能です。 - **リファレンス** – エージェントスキルが参照できるドキュメント、設定デフォルト値、ナレッジ。リファレンスにより、プロンプトを肥大化させることなくエージェントスキルをよりスマートにします。 この分野で新しいタイプの専門知識アーティファクトが登場しても、エージェントプラグインにパッケージ化できるため、進化は開発者に対して透過的に行われます。 ## ベストプラクティス プラグインを活用した開発のメリットを最大化しつつ、セキュリティとコード品質を維持するため、以下の重要なガイドラインに従ってください： - デプロイ前に、生成されたコードを必ずレビューしてください（例：セキュリティ、コスト、レジリエンスに関する制約への適合性） - プラグインは開発者の判断力と専門知識の代替ではなく、アクセラレーターとして使用してください。 - 最新の AWS ベストプラクティスの恩恵を受けるため、プラグインを最新の状態に保ってください。 - AWS 認証情報の設定には最小権限の原則に従ってください。 - 生成されたインフラストラクチャコードに対してセキュリティスキャンツールを実行してください。 ## プラグイン一覧 | プラグイン | 説明 | ステータス | | --------------------------- | ------------------------------------------------------------------------------------------------------------------------ | --------------------------- | | **amazon-location-service** | Amazon Location Service を使用してアプリケーションにマップ、ジオコーディング、ルーティング、場所検索、地理空間機能を追加 | 利用可能 | | **aws-amplify** | 認証、データ、ストレージ、関数のガイド付きワークフローで AWS Amplify Gen 2 を使用したフルスタックアプリを構築 | 利用可能 | | **aws-serverless** | Lambda、API Gateway、EventBridge、Step Functions、Durable Functions を使用したサーバーレスアプリケーションを構築 | 利用可能 | | **databases-on-aws** | AWS データベースポートフォリオのガイダンス — スキーマ設計、クエリ、マイグレーション、マルチテナントパターン | 一部利用可能（Aurora DSQL） | | **deploy-on-aws** | アーキテクチャ推奨、コスト見積もり、IaC デプロイにより AWS へのアプリケーションデプロイを支援 | 利用可能 | ## インストール ### Claude Code #### マーケットプレイスの追加 ```bash /plugin marketplace add awslabs/agent-plugins ``` #### プラグインのインストール インストールしたいプラグインに対応するコマンドを実行してください。 Amazon Location Service ```bash /plugin install amazon-location-service@agent-plugins-for-aws ``` AWS Amplify ```bash /plugin install aws-amplify@agent-plugins-for-aws ``` AWS Serverless ```bash /plugin install aws-serverless@agent-plugins-for-aws ``` Databases on AWS ```bash /plugin install databases-on-aws@agent-plugins-for-aws ``` Deploy on AWS ```bash /plugin install deploy-on-aws@agent-plugins-for-aws ``` ### Cursor **deploy-on-aws** プラグインは [Cursor Marketplace](https://cursor.com/marketplace/aws) からインストールできます。詳細については、[Cursor プラグインドキュメント](https://cursor.com/docs/plugins)を参照してください。Cursor アプリケーション内からもインストール可能です。 - Cursor の設定を開く - `Plugins` に移動する - `AWS` で検索する - インストールしたいプラグインを選択し、`Add to Cursor` をクリックする - インストールされたプラグインのスコープを選択する - プラグインが `Plugins -> Installed` に表示されます ## amazon-location-service Amazon Location Service を使用したマップ、場所検索、ジオコーディング、ルーティング、その他の地理空間機能の追加について、認証セットアップ、SDK 統合、ベストプラクティスを含めて開発者をガイドします。 ### エージェントスキルのトリガー | エージェントスキル | トリガー | | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | | **amazon-location-service** | 「マップを追加して」「住所をジオコーディングして」「ルートを計算して」「位置情報対応アプリ」「Amazon Location Service」「地理空間」「場所検索」 | ### MCP サーバー | サーバー | 用途 | | ----------- | ---------------------------------------- | | **aws-mcp** | AWS ドキュメントおよびサービスガイダンス | ## aws-amplify TypeScript コードファーストの開発で AWS Amplify Gen 2 を使用したフルスタックアプリを構築します。AWS 公式の Agent Standard Operating Procedures（SOP）に基づいてガイドされます。 ### ワークフロー 1. **バックエンド** - Amplify Gen 2 リソース（認証、データ、ストレージ、関数）を作成 2. **サンドボックス** - テスト用にサンドボックスにデプロイ 3. **フロントエンドとテスト** - フロントエンドをバックエンドに接続し、ローカルで検証 4. **本番環境** - 本番環境にデプロイ ### エージェントスキルのトリガー | エージェントスキル | トリガー | | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | **amplify-workflow** | 「Amplify アプリを作って」「Amplify プロジェクトを作成して」「Amplify に認証を追加して」「Amplify をデプロイして」「フルスタック Amplify」 | ### MCP サーバー | サーバー | 用途 | | ----------- | ---------------------------------------- | | **aws-mcp** | AWS ドキュメントおよびサービスガイダンス | ## aws-serverless AWS Lambda、API Gateway、EventBridge、Step Functions、Durable Functions を使用してサーバーレスアプリケーションの設計、構築、デプロイ、テスト、デバッグを行います。SAM および CDK のデプロイワークフロー、SAM テンプレート検証 Hook、そして耐障害性のある長時間実行マルチステップアプリケーション構築のための AWS Lambda Durable Functions スキルを含みます。 ### エージェントスキルのトリガー | エージェントスキル | トリガー | | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **aws-lambda** | 「Lambda 関数」「イベントソース」「サーバーレスアプリケーション」「API Gateway」「EventBridge」「Step Functions」「サーバーレス API」「イベント駆動アーキテクチャ」「Lambda トリガー」 | | **aws-serverless-deployment** | 「SAM を使って」「SAM テンプレート」「SAM init」「SAM deploy」「CDK サーバーレス」「CDK Lambda コンストラクト」「NodejsFunction」「PythonFunction」「サーバーレス CI/CD パイプライン」 | | **aws-lambda-durable-functions** | 「Lambda Durable Functions」「ワークフローオーケストレーション」「ステートマシン」「リトライ/チェックポイントパターン」「長時間実行のステートフル Lambda」「Saga パターン」「Human-in-the-loop」 | ### MCP サーバー | サーバー | 用途 | | ---------------------- | ------------------------------------------------------------------------------------ | | **aws-serverless-mcp** | サーバーレス開発ガイダンス、プロジェクトのスキャフォールディング、IaC 生成、デプロイ | ### Hooks | Hook | トリガー | アクション | | ------------------------ | --------------------------------------- | ----------------------------------------------- | | **SAM テンプレート検証** | `template.yaml`/`template.yml` の編集後 | `sam validate` を実行しエラーをインラインで報告 | ## databases-on-aws AWS データベースポートフォリオのデータベースガイダンス。スキーマ設計、クエリ実行、マイグレーション処理、アプリケーション構築、ワークロードに最適なデータベースの選択を支援します。現在は Aurora DSQL（サーバーレスの PostgreSQL 互換分散 SQL データベース）を含みます。 ### エージェントスキルのトリガー | エージェントスキル | トリガー | | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- | | **dsql** | 「Aurora DSQL」「DSQL スキーマ」「分散 SQL データベース」「サーバーレス PostgreSQL 互換データベース」「DSQL テーブルを作成して」「DSQL に移行して」 | ### MCP サーバー | サーバー | 用途 | | ---------------- | --------------------------------------------------------------------------------- | | **awsknowledge** | AWS ドキュメント、アーキテクチャガイダンス、ベストプラクティス | | **aurora-dsql** | データベースの直接操作 — クエリ、スキーマ、トランザクション（デフォルトでは無効） | ### Hooks | Hook | トリガー | アクション | | ---------------- | ------------------- | -------------------------------------------------------- | | **スキーマ検証** | `transact` 操作の後 | スキーマ変更と影響を受ける行の検証を促すプロンプトを表示 | ## deploy-on-aws AWS デプロイを加速するスキルをエージェントに提供します — AWS アーキテクチャとサービスの推奨、コスト見積もり、Infrastructure as Code（CDK または CloudFormation）の生成、そしてデプロイのガイドを行います。 ### ワークフロー 1. **分析** - コードベースをスキャンしてフレームワーク、データベース、依存関係を検出 2. **推奨** - 簡潔な根拠とともに AWS サービスを選定 3. **見積もり** - 進行前にコスト見積もりを提示 4. **生成** - IaC コード（CDK/CloudFormation）を記述 5. **デプロイ** - ユーザーの確認を得て実行 ### エージェントスキルのトリガー | エージェントスキル | トリガー | | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------- | | **deploy** | 「AWS にデプロイして」「AWS でホストして」「AWS で動かして」「AWS アーキテクチャ」「AWS コストを見積もって」「インフラを生成して」 | ### MCP サーバー | サーバー | 用途 | | ---------------- | -------------------------------------------------------------- | | **awsknowledge** | AWS ドキュメント、アーキテクチャガイダンス、ベストプラクティス | | **awspricing** | コスト見積もり用のリアルタイム AWS サービス料金 | | **aws-iac-mcp** | CDK/CloudFormation の IaC ベストプラクティス | ## 要件 - 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)をご覧ください。 ## メンテナー リポジトリのレビューアー、メンテナー、管理者は、PR レビューワークフロー、マージルール、CI/CD ドキュメントを[メンテナーガイド](./docs/MAINTAINERS_GUIDE.md)で確認できます。 ## その他のリソース - [Introducing Agent Plugins for AWS（公式ブログ）](https://aws.amazon.com/blogs/developer/introducing-agent-plugins-for-aws/) - [Extend Cursor with plugins ft. AWS](https://cursor.com/blog/marketplace) - [MCP Servers for AWS](https://github.com/awslabs/mcp) - [Claude Code プラグインドキュメント](https://code.claude.com/docs/en/plugins) - [Cursor プラグインドキュメント](https://cursor.com/docs/plugins) ## ライセンス このプロジェクトは Apache-2.0 ライセンスの下で提供されています。 --- _この日本語版 README は [Minoru Onda (AWS AI Hero)](https://github.com/minorun365) が翻訳・作成しました。原文は [README.md](./README.md) を参照してください。_