プロンプトの管理 - Amazon Q Developer
プロンプトタイプについてコマンドプロンプトの使用MCP プロンプトに引数を渡すストレージの場所優先度システム拡張機能MCP 統合例

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

プロンプトの管理

Amazon Q Developer CLI は、ローカルプロンプトとモデルコンテキストプロトコル (MCP) プロンプトの両方に包括的なプロンプト管理機能を提供します。このシステムを使用すると、開発ワークフロー全体で再利用可能なプロンプトを作成、編集、整理、使用できます。

プロンプトタイプについて

プロンプトシステムは 3 種類のプロンプトをサポートしています。

  • ローカルプロンプト: ワークスペースに保存されているプロジェクト固有のプロンプト

  • グローバルプロンプト: すべてのプロジェクトで利用可能なユーザー全体のプロンプト

  • MCP プロンプト: 強化された機能を備えた MCP サーバーによって提供されるプロンプト

コマンド

プロンプト管理はすべて、さまざまなサブ/promptsコマンドを使用して コマンドを介してアクセスされます。

プロンプトを一覧表示する

/prompts list

使用可能なすべてのプロンプトを 3 列レイアウトで表示し、名前、説明、ソースを表示します。プロンプト数を表示し、ローカルストレージ、グローバルストレージ、または MCP サーバーからのプロンプトを示します。

プロンプトの作成

/prompts create --name name [--content content]

現在のワークスペースに新しいローカルプロンプトを作成します。

パラメータ
name (必須)

プロンプト名 (最大 50 文字)

--content content (オプション)

直接コンテンツの仕様

動作:

  • --content が指定されている場合、 は指定されたコンテンツを含むプロンプトを作成します。

  • コンテンツが指定されていない場合は、デフォルトのエディタを開いてコンテンツを作成します。

  • プロンプトは現在のワークスペース.amazonq/prompts/の に保存されます。

プロンプトの編集

/prompts edit name

変更する既存のプロンプトをデフォルトのエディタで開きます。

サポートされているプロンプト:

  • ローカルワークスペースプロンプト

  • グローバルユーザープロンプト

  • MCP プロンプト (サーバーでサポートされている場合)

プロンプトの詳細を表示する

/prompts details name

次のようなプロンプトに関する包括的な情報を表示します。

  • メタデータと引数の詳細

  • AI 処理前にプロンプトコンテンツを完了する

  • パラメータの要件と例

  • ソース情報 (ローカル、グローバル、または MCP サーバー)

プロンプトの使用

プロンプトを作成したら、@ プレフィックスを使用してチャットで呼び出します。

@prompt-name

例

@code-review
# Uses your local code-review prompt
@team-standup
# Uses your team-standup prompt

MCP プロンプトに引数を渡す

MCP サーバープロンプトは、引数を受け入れて動作をカスタマイズできます。ファイルベースのプロンプト (ローカルおよびグローバル) は引数をサポートしていません。

MCP プロンプト引数の構文

@server-name/prompt-name <required-arg> [optional-arg]

を使用して/prompts details prompt-name、MCP プロンプトが受け入れる引数を確認します。

# Example: Using MCP prompt with arguments
@dev-tools/analyze "performance issue" "detailed"
@security-tools/scan "web-app" "high-severity"

ストレージの場所

ローカルプロンプト (ワークスペース固有)

  • 場所: project/.amazonq/prompts/

  • スコープ: 現在のプロジェクト内でのみ使用可能

  • Priority: Highest (グローバルプロンプトと MCP プロンプトを同じ名前で上書き)

グローバルプロンプト (ユーザー全体)

  • 場所: ~/.aws/amazonq/prompts/

  • スコープ: すべてのプロジェクトで使用可能

  • Priority: Medium (同じ名前の MCP プロンプトを上書き)

MCP プロンプト

  • ソース: 設定された MCP サーバーによって提供される

  • スコープ: サーバー設定によって異なります

  • Priority: Lowest (ローカルプロンプトとグローバルプロンプトによって上書き)

優先度システム

複数のプロンプトの名前が同じ場合、システムは次の優先順位を使用します。

  1. ローカルプロンプト (最高優先度)

  2. グローバルプロンプト

  3. MCP プロンプト (最低優先度)

これにより、必要に応じて MCP またはグローバルプロンプトをプロジェクト固有のバージョンで上書きできます。

拡張機能

コンテンツプレビュー

AI モデルに送信する前に完全なプロンプトコンテンツが表示され、実際に処理された情報に関する混乱がなくなります。

エラー処理を改善

  • MCP サーバーエラーはユーザーフレンドリーなメッセージに変換されます

  • プロンプトメタデータから役立つ使用例が生成されます

  • 無効なパラメータまたは欠落している要件に関する明確なガイダンス

ビジュアルフォーマット

  • すべてのプロンプトオペレーションで一貫したターミナルスタイル

  • すべてのプロンプトメッセージタイプに適切なコンテンツ表示

  • リストの読みやすさを向上させる 3 列レイアウト

MCP 統合

プロンプトシステムは MCP サーバーとシームレスに統合されます。

  • 自動検出: MCP プロンプトは設定されたサーバーから自動的に検出されます

  • 拡張 UX: MCP プロンプト管理のユーザーエクスペリエンスを改善

  • エラー変換: Raw JSON エラーは実用的なメッセージに変換されます

  • コンテンツプレビュー: 実行前の MCP プロンプトの完全なコンテンツプレビュー

例

これらの例は、ファイルベースのプロンプト作成と MCP プロンプトの使用を示しています。

ファイルベースの基本的なプロンプトの作成と使用

# Create a simple prompt without arguments
/prompts create --name code-review --content "Please review this code for best practices, security issues, and potential improvements:"

# Use the prompt (no arguments supported for file-based prompts)
@code-review

引数を使用した MCP プロンプトの使用

# Using MCP prompts with arguments
@dev-tools/analyze "performance bottleneck" "cpu usage"
@security-tools/scan "web-app" "high-severity"
@aws-tools/deploy "my-service" "production" "us-west-2"