Skip to content

README.jp.md

Latest commit

 

History

History
283 lines (185 loc) · 19.8 KB

README.jp.md

File metadata and controls

283 lines (185 loc) · 19.8 KB

Agent Plugins for AWS

他の言語で読む: English

Important

生成 AI は誤った出力を生成する可能性があります。選択した AI モデルおよびエージェントコーディングアシスタントが生成するすべての出力とコストを確認することを推奨します。AWS 責任ある AI ポリシーを参照してください。

Agent Plugins for AWS は、AI コーディングエージェントに AWS 上でのアーキテクチャ設計、デプロイ、運用を支援するスキルを提供します。Agent Plugins は現在、Claude Code と Cursor に対応しています。

AI コーディングエージェントはソフトウェア開発において急速に普及し、開発者のコード記述、レビュー、デプロイを効率化しています。

エージェントスキルとエージェントプラグインは、モデルのコンテキストを肥大化させることなくコーディングエージェントを的確な結果へ導くためのベストプラクティスとして確立されつつあります。長い AWS ガイダンスをプロンプトに繰り返し貼り付ける代わりに、エージェントが必要に応じて呼び出す再利用可能でバージョン管理された機能としてエンコードすることで、以下のメリットが得られます。

  • 出力の決定論性が向上する
  • コンテキストのオーバーヘッドが削減される
  • チーム全体でエージェントの動作を標準化しやすくなる

エージェントプラグインは、さまざまな種類の専門知識アーティファクトをパッケージ化するコンテナとして機能します。1 つのエージェントプラグインには以下を含めることができます。

  • エージェントスキル – デプロイ、コードレビュー、アーキテクチャ設計などの複雑なタスクを通じて AI をガイドする、構造化されたワークフローとベストプラクティスのプレイブック。エージェントスキルは、ドメインの専門知識をステップバイステップのプロセスとしてエンコードします。
  • MCP サーバー – 外部サービス、データソース、API への接続。MCP サーバーは、ランタイムにおいてアシスタントにライブドキュメント、料金データ、その他のリソースへのアクセスを提供します。MCP Servers for AWS で詳細をご覧ください。
  • 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 へのアプリケーションデプロイを支援 利用可能
migration-to-aws リソース検出、アーキテクチャマッピング、コスト分析、実行計画により GCP インフラを AWS に移行 利用可能

インストール

Claude Code

マーケットプレイスの追加

/plugin marketplace add awslabs/agent-plugins

プラグインのインストール

インストールしたいプラグインに対応するコマンドを実行してください。

Amazon Location Service

/plugin install amazon-location-service@agent-plugins-for-aws

AWS Amplify

/plugin install aws-amplify@agent-plugins-for-aws

AWS Serverless

/plugin install aws-serverless@agent-plugins-for-aws

Databases on AWS

/plugin install databases-on-aws@agent-plugins-for-aws

Deploy on AWS

/plugin install deploy-on-aws@agent-plugins-for-aws

Migration to AWS

/plugin install migration-to-aws@agent-plugins-for-aws

Cursor

deploy-on-aws プラグインは Cursor Marketplace からインストールできます。詳細については、Cursor プラグインドキュメントを参照してください。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 ベストプラクティス

migration-to-aws

Terraform リソースの検出、アーキテクチャマッピング、コスト見積もり、実行計画を通じて、GCP インフラから AWS への体系的な移行を支援します。

ワークフロー

  1. 検出 - Terraform ファイルをスキャンして GCP リソースを検出し、インフラストラクチャを抽出
  2. 確認 - コンピューティングワークロードとアーキテクチャパターンを理解
  3. 設計 - GCP サービスを AWS の同等サービスにマッピングし、根拠を提示
  4. 見積もり - 月間 AWS コストを算出し、GCP と比較
  5. 実行 - 移行タイムラインを策定し、デプロイリスクを特定

エージェントスキルのトリガー

エージェントスキル トリガー
gcp-to-aws 「GCP から AWS に移行して」「GCP から移行して」「GCP 移行計画」「AWS コストを見積もって」「GCP インフラのアセスメント」

MCP サーバー

サーバー 用途
awsknowledge AWS ドキュメント、アーキテクチャガイダンス
awspricing コスト見積もり用のリアルタイム AWS サービス料金

要件

  • Claude Code >=2.1.29 または Cursor >= 2.5
  • 適切な認証情報が設定された AWS CLI

トラブルシューティング

プラグインのインストールや使用に問題がありますか？一般的な解決策については、トラブルシューティングガイドを参照してください。

コントリビューション

素晴らしいコントリビューターの皆さんに大きな感謝を！このプロジェクトをより良くしてくれてありがとうございます！

あらゆる種類のコントリビューションを歓迎します！詳細はコントリビューターガイドをご覧ください。

開発者ガイド

ライブラリに新しいプラグインを追加したい場合は、設計ガイドラインと開発ガイドをご覧ください。

メンテナー

リポジトリのレビューアー、メンテナー、管理者は、PR レビューワークフロー、マージルール、CI/CD ドキュメントをメンテナーガイドで確認できます。

その他のリソース

ライセンス

このプロジェクトは Apache-2.0 ライセンスの下で提供されています。

この日本語版 README は Minoru Onda (AWS AI Hero) が翻訳・作成しました。原文は README.md を参照してください。