翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # DevOps エージェントスキル AWS DevOps エージェントスキルは、インフラストラクチャと運用ワークフローに合わせた専門的なドメインの知識と調査方法論により、エージェントの機能を拡張するモジュラー命令セットです。 ## スキルとは スキルは、 AWS DevOps Agent に特殊な機能を提供する Markdown 指示を含む自己完結型ディレクトリです。 AWS DevOps Agent は、エージェントの指示とリソースをパッケージ化するオープンスタンダードである [Agent Skills 仕様](https://agentskills.io/)のサブセットをサポートし、Markdown 指示書、PDFs、画像、データファイルなどの実行不可能なドキュメントのみをサポートします。 すべてのスキルには、 AWS DevOps エージェントに提供する手順を含む SKILL.md ファイルが必要です。必要な SKILL.md ファイルに加えて、スキルには次のようなものがあります。 + 特定のシナリオまたはインフラストラクチャタイプの**調査ワークフロー**。 + アーキテクチャパターンや運用手順を含む**参考資料**。 + **エージェントタイプのターゲティング** – スキルは、特定のエージェントタイプ (汎用、オンデマンド、インシデントトリアージ、インシデント RCA、インシデント緩和、評価) を対象にして、コンテキストの消費を減らし、エージェントのフォーカスを向上させることができます。 ## スキルを使用する理由 スキルは AWS DevOps エージェントを汎用アシスタントからインフラストラクチャと運用ワークフローのスペシャリストに変換します。チャットメッセージで提供される 1 回限りの手順とは異なり、スキルは、 AWS DevOps Agent によって実行されるタスクに関連する場合に自動的にロードされる再利用可能な機能です。 **主な利点:** + **エージェントを専門化する** – 調査手順、ベストプラクティス、インフラストラクチャと運用パターンに固有の組織知識を使用して、 AWS DevOps エージェントをカスタマイズします。 + **繰り返しを減らす** – 調査ワークフローを一度作成すると、 AWS DevOps Agent は関連するすべての調査でそれらを自動的に使用するため、同じガイダンスを繰り返し提供する必要がなくなります。 + **機能を構成する** – 複数のスキルを組み合わせてend-to-endの調査ワークフローを構築します。 AWS DevOps エージェントは、カスタム CI/CD パイプラインからデプロイを取得するスキルやコードリポジトリを検索するスキルなど、実行中に複数のスキルを読み取ります。 + **Amplify カスタムツール** – AWS DevOps Agent がカスタム MCP サーバーツールを効果的に使用するのに役立つスキルを作成します。スキルは、特定のツールを呼び出すタイミング、さまざまなシナリオに使用するパラメータ、結果を解釈してインフラストラクチャ固有のワークフローを実行する方法を文書化することができます。 ## スキルの仕組み AWS DevOps エージェントが関連するタスクに遭遇すると、適切なスキルをロードし、調査の指針となる指示に従います。例えば、「データベースパフォーマンス調査」スキルには、RDS スロットリングの問題を分析するstep-by-stepの手順が含まれている場合があります。これにより、エージェントはアラームステータスを体系的にチェックし、接続メトリクスを分析し、スロークエリを特定できます。 ## スキル構造 スキルは、以下を含むディレクトリとして編成されます。 ``` my-skill/ ├── SKILL.md # Main skill instructions ├── references/ # Optional: additional reference documentation └── assets/ # Optional: images, diagrams, data files ``` ### SKILL.md は唯一の必須ファイル`SKILL.md`です。これには、Markdown 形式で記述されたコア命令が含まれています。このファイルは次の条件を満たす必要があります。 + スキルを使用するタイミングと方法について説明します。 + step-by-stepの調査手順を提供します。 + さまざまなシナリオのディシジョンツリーを含めます。 + 期待される出力と成功基準を文書化します。 ### フロントマター Frontmatter は、`SKILL.md`ファイルの上部にあるメタデータブロックで、`---`区切り文字で囲まれています。これには、 AWS DevOps Agent が調査またはタスク中にスキルを有効にするタイミングを判断するために使用する `name`および `description`フィールドが含まれます。 ``` --- name: rds-performance-investigation description: Investigation procedures for RDS performance issues including connection exhaustion, slow queries, replication lag, and storage capacity. Use this skill when investigating database latency, connection errors, or read/write performance degradation. --- ``` **name** – スキルの一意の識別子。小文字、数字、ハイフンのみを使用してください (最大 64 文字）。先頭または末尾にハイフンを使用しないでください。 **説明** – AWS DevOps エージェントがこのスキルを使用するタイミングと理由の詳細な説明。 AWS DevOps エージェントはこのフィールドを評価して、スキルが現在のタスクに関連しているかどうかを判断します。説明があいまいまたは欠落している場合、指示が適切に記述されていても、エージェントはスキルを完全にスキップする可能性があります。 **重要** – エージェントの観点から説明を記述します。スキルをトリガーする特定のシナリオ、サービス、エラータイプ、または症状を含めます。たとえば、「Amazon RDS インスタンスのデータベースレイテンシー、接続エラー、またはクエリタイムアウトを調査するときにこのスキルを使用する」は、「RDS スキル」よりも効果的です。 UI でスキルを作成すると、指定した名前と説明からフロントマターが自動的に生成されます。zip ファイルとしてアップロードされるスキルには、`SKILL.md`ファイルに frontmatter が含まれている必要があります。 ## 例: スキルを完了する 次の例は、RDS パフォーマンスの問題を調査するための完全で適切な形式のスキルを示しています。ディレクトリ構造、SKILL.md frontmatter、実用的な調査手順、および補足参照ファイルを示します。 **ディレクトリ構造:** ``` rds-performance-investigation/ ├── SKILL.md ├── references/ │ └── rds-metrics-reference.md └── assets/ └── rds-investigation-flowchart.png ``` **SKILL.md:** ``` --- name: rds-performance-investigation description: Investigation procedures for RDS performance issues including connection exhaustion, slow queries, replication lag, and storage capacity. Use this skill when investigating database latency, connection errors, or read/write performance degradation. --- # RDS Performance Investigation Use this skill when customers report database latency, connection errors, query timeouts, or read/write performance degradation. ## Step 1: Check alarm status Query CloudWatch for active alarms on the affected RDS instance. Look for: - `DatabaseConnections` exceeding 80% of max_connections - `ReadLatency` or `WriteLatency` above 20ms - `FreeStorageSpace` below 20% of total storage - `ReplicaLag` above 30 seconds (read replicas only) ## Step 2: Analyze connection metrics Retrieve `DatabaseConnections` over the past hour. If connections are near the max_connections limit, check for connection pool misconfiguration or long-running idle connections. ## Step 3: Identify slow queries Use Performance Insights (`pi:GetResourceMetrics`) to retrieve the top SQL statements by average active sessions. Focus on queries with high `db.load` contribution or frequent I/O waits. ## Step 4: Summarize findings Provide a summary with: 1. Current performance status (healthy / degraded / critical) 2. Root cause hypothesis with supporting metrics 3. Recommended remediation steps ranked by priority ``` **リファレンス/rds-metrics-reference.md:** ``` # RDS CloudWatch Metrics Reference | Metric | Normal Range | Investigation Threshold | |---|---|---| | DatabaseConnections | < 70% max_connections | > 80% max_connections | | ReadLatency | < 5ms | > 20ms | | WriteLatency | < 5ms | > 20ms | | FreeStorageSpace | > 30% total storage | < 20% total storage | | ReplicaLag | < 5 seconds | > 30 seconds | | CPUUtilization | < 70% | > 85% | ``` ## スキルの作成 スキルを作成する前に、エージェントスペースが必要です。詳細については、「[エージェントスペースの作成](getting-started-with-aws-devops-agent-creating-an-agent-space.md)」を参照してください。 ワークフローの設定とスキルの複雑さに応じて、2 つの方法でスキルを作成できます。 ### UI でのスキルの作成 AWS DevOps エージェントオペレーターウェブアプリで作成されたスキルには、単一の SKILL.md ファイルの名前、説明、および手順が含まれています。 **UI でスキルを作成するには:** + エージェントスペースオペレーターウェブアプリのスキルページに移動します。 + 「スキルの追加」をクリックします。 + モーダルから「スキルの作成」を選択します。 + スキルフォームに入力します。 + **名前** – 小文字、数字、ハイフンのみ (最大 64 文字）。先頭または末尾にハイフンを使用しないでください。例: `rds-throttling-investigation` + **説明** – このスキルを使用するタイミングの簡単な説明 (推奨文字数は 100 文字以上、最大 1,024 文字）。これは、エージェントがスキルを有効にするタイミングを決定するのに役立ちます。 + **ステータス** – アクティブ (デフォルト) または非アクティブに設定します。非アクティブなスキルはエージェントでは使用されません。 + **エージェントタイプ** – このスキルを使用できるエージェントタイプを 1 つ以上選択します。**汎用** はデフォルトで選択され、スキルがすべてのエージェントタイプで使用できるようにします。特定のエージェントをターゲットにするには、汎用 の選択を解除し、オンデマンド、インシデントトリアージ、インシデント RCA、インシデント緩和、評価のいずれかを選択します。 + **手順** – Markdown Step-by-stepの手順。具体的で実用的であること。 + スキルを保存するには、「作成」をクリックします。 システムは、適切なフロントマター構造を持つ SKILL.md ファイルを自動的に生成します。 **UI で作成されたスキルを編集するには:** + スキルリストのスキルに移動し、スキルをクリックして開きます。 + [**Edit (編集)**] をクリックします。 + 名前、説明、または手順を変更します。 + **保存**をクリックしてスキルを更新します。 ### スキルのアップロード zip ファイルとしてアップロードされたスキルには、SKILL.md ファイルに加えて、参考資料やアセットなどの追加リソースが含まれています。 **スキル構造:** ``` my-skill.zip ├── SKILL.md # Required: main skill instructions ├── references/ # Optional: reference documentation │ ├── architecture.md │ └── troubleshooting.md └── assets/ # Optional: images, diagrams, data files ├── topology.png └── metrics.csv ``` **SKILL.md フロントマター要件:** zip ファイルとしてアップロードされるスキルには、 `name`フィールドと `description`フィールドを含む SKILL.md のフロントマターが含まれている必要があります。 AWS DevOps Agent はこれらのフィールドを使用して、スキルを有効にするタイミングを決定します。効果的なフロントマターの記述の詳細については、このトピックの前半の「Frontmatter」セクションを参照してください。 ``` --- name: rds-performance-analysis description: Comprehensive RDS performance investigation procedures for connection exhaustion, slow queries, and storage capacity issues. Use when investigating database latency or read/write degradation. --- # RDS Performance Analysis [Your skill instructions here...] ``` **zip アップロードでスキルを作成するには:** + 上記の構造に従って、スキルファイルを含むディレクトリを作成します。 + SKILL.md に適切なフロントマター (名前と説明) が含まれていることを確認します。 + ディレクトリを .zip ファイルに圧縮します。 + エージェントスペースオペレーターウェブアプリのスキルページに移動します。 + 「スキルの追加」をクリックします。 + モーダルから「スキルのアップロード」を選択します。 + .zip ファイルをドラッグアンドドロップするか、クリックして参照します (ZIP ファイルのみ、最大 6 MB)。 + このスキルを使用できるエージェントタイプを 1 つ以上選択します (汎用 はデフォルトで選択され、すべてのエージェントタイプに適用されます。特にオンデマンド、インシデントトリアージ、インシデント RCA、インシデント緩和、または評価をターゲットにするには選択を解除します）。 + zip ファイルの要件と検証結果を確認します。 + 「アップロード」をクリックして、エージェントスペースにスキルを追加します。 **zip ファイルとしてアップロードされるスキルに関する重要な制限:** + **スクリプトは現在サポートされていません** – `scripts/` ディレクトリにスクリプトを含むスキルは、アップロード中に拒否されます。スクリプト実行は、エージェントが安全なコーディング環境にアクセスすると、将来のリリースで有効になります。 + **サイズ制限** – zip ファイルの合計サイズは 6 MB を超えることはできません (すべてのファイルを含む）。 + **SKILL.md 必須** – zip ファイルには、有効なフロントマターを含む SKILL.md ファイルが含まれている必要があります。 **命名スキルのベストプラクティス:** 一般的な名前ではなく、rds-throttling-investigation」のような明確でわかりやすい名前を使用します。優れたスキル名は、それが対処する特定のシナリオやサービスを反映しているため、適切なスキルを簡単に一目で特定できます。 ## スキルの管理 AWS DevOps エージェントは、オペレーターウェブアプリを通じて包括的なスキル管理機能を提供します。 **スキルの一覧表示** – エージェントスペース内のすべてのスキルを表示します。スキルページには、スキル名、アクティブまたは非アクティブのステータス、作成日、最終更新日、使用可能なアクションが表示されます。 **スキルの表示** – 任意のスキルをクリックすると、その詳細ビューが表示されます。UI で作成されたスキルには編集可能なコンテンツが表示され、UI で名前、説明、または手順を直接変更し、「保存」をクリックして更新できます。zip ファイルとしてアップロードされたスキルには、SKILL.md と references/ や assets/ などの追加のディレクトリを示すファイルツリーが表示されます。ツリー内のファイルをクリックして、読み取り専用モードでその内容を表示します。 **スキルのエージェントの選択** – 各スキルを作成または編集するときに使用できるエージェントタイプを設定します。エージェントタイプドロップダウンで、**汎用** (デフォルト — すべてのエージェントタイプに適用）、**オンデマンド** (会話型クエリ）、**インシデントトリアージ** (初期インシデント評価）、**インシデント RCA** (根本原因分析）、**インシデント軽減** (自動インシデント対応）、または**評価** (事前推奨事項) のチェックボックスを使用して、1 つ以上のエージェントタイプを選択します。汎用 はデフォルトで選択され、スキルがすべてのエージェントタイプで使用できるようにします。特定のエージェントを対象としたスキルは、コンテキストの消費を減らし、エージェントの集中力を向上させます。 **スキルのアクティブ化と非アクティブ化** – アクティブ/非アクティブトグルを使用して、スキルを削除せずに一時的に無効にします。スキル詳細ビューを開き、切り替えを「非アクティブ」に切り替えて、エージェントがすべてのコンテンツと設定を保持しながら、新しい調査のためにロードしないようにします。進行中の調査では、スキルが引き続き使用されます。「アクティブ」に戻すと、スキルがすぐに再び利用可能になります。 **スキルの更新** – 作成方法に基づいて既存のスキルを変更します。UI で作成されたスキルについては、スキル詳細ビューで「編集」をクリックし、名前、説明、または手順を変更し、「保存」をクリックして更新します。zip ファイルとしてアップロードされたスキルについては、ファイルをローカルで変更し、新しい zip ファイルを作成して、新しいバージョンをアップロードします。 **スキルの削除** – エージェントスペースからスキルを完全に削除します。スキルリストビューを開き、その他のオプションメニュー (⋮) をクリックして「削除」を選択し、永久削除に関する警告を確認し、確認するスキル名を入力し、「スキルの削除」をクリックします。削除を元に戻すことはできません。削除されたスキルをロードしようとすると、進行中の調査が影響を受ける可能性があります。zip ファイルとしてアップロードされたスキルについては、バックアップとして を削除する前に zip ファイルをダウンロードしてください。再度必要になる場合は、削除せずにスキルを無効にすることを検討してください。 ## ランブックからの移行 既存のランブックは、顧客のアクションなしでスキルに自動的に移行されます。エージェントスペースがスキルモデルに移行すると、すべてのランブックがスキルに変換され、スキル UI に表示されます。移行後、次のことができます。 + **移行されたスキルを確認する** – 自動移行がランブックを正しく変換したことを確認します。 + **必要に応じて更新**する – UI でスキルを直接編集して、指示を絞り込んだり、説明を更新したり、エージェントタイプのターゲティングを設定したりできます。 + **リファレンスで拡張**する – 追加のリファレンスマテリアルやアーキテクチャ図から恩恵を受けるスキルについては、リファレンス/ または assets/ ディレクトリを使用して zip アップロードスキルとして再作成します。 + **新しいスキルを作成する** – Runbooks で以前にカバーされていない調査ワークフローに新しいスキルを追加します。 自動的に移行されたスキルに問題がある場合、または移行後の更新に関するサポートが必要な場合は、 AWS サポートにお問い合わせください。