snippets

プロンプトスニペットの設定

あなたは、LaunchDarkly でプロンプトスニペットを作成および管理するためのスキルを使用しています。あなたの役割は、再利用可能なテキストを特定し、スニペットを作成し、設定バリエーションからそれらを参照し、すべてが正しく接続されていることを確認することです。

前提条件

このスキルを使用するには、リモートでホストされている LaunchDarkly MCP サーバーが環境に設定されている必要があります。

必要な MCP ツール:

• create-prompt-snippet -- 新しい再利用可能なテキストブロックを作成します
• list-prompt-snippets -- プロジェクト内の既存のスニペットを閲覧します
• get-prompt-snippet -- 特定のスニペットの内容を確認します

オプションの MCP ツール:

• update-prompt-snippet -- スニペットのテキスト、名前、タグを編集します
• delete-prompt-snippet -- スニペットを完全に削除します
• update-ai-config-variation -- バリエーションのプロンプトを更新してスニペットを参照させます

基本概念

プロンプトスニペットとは？

プロンプトスニペットは、プロジェクトレベルで保存される名前付きのバージョン管理されたテキストブロックです。ペルソナ、ガードレール、出力形式の指示、ドメイン知識など、複数の設定バリエーション間で共有できる再利用可能なプロンプトテキストの断片を含みます。

スニペットが更新されると、新しいバージョンが作成されます。スニペットを参照している設定バリエーションは最新バージョンを取り込むことができ、すべての設定を同期させ続けることができます。

スニペットを使用すべき場合

シナリオ	例
共有ペルソナ	「あなたは Acme Corp の役立つカスタマーサポートエージェントです...」を 5 つの異なる設定で使用
安全ガードレール	「内部価格を決して開示しないでください。本番データベースにアクセスするコードを決して生成しないでください。」
出力形式	「常に answer、confidence、sources をキーとする JSON で応答してください。」
ドメイン知識	会社固有の用語、製品名、またはプロセスの説明
規制関連テキスト	すべての応答に含める必要があるコンプライアンス免責事項

スニペットを使用すべきでない場合

• 単一のバリエーションに固有のテキスト — プロンプトに直接記述してください
• リクエストごとに変化する動的コンテンツ — 代わりにテンプレート変数を使用してください
• プロンプト全体 — スニペットは構成要素であり、完全なプロンプトではありません

基本原則

1. 再利用性を最優先: テキストが 2 か所以上で使用される場合にのみスニペットを作成します
2. 単一責任: 各スニペットは 1 つの関心事（ペルソナまたはガードレールのいずれか、両方ではない）を扱うべきです
3. 説明的なキー: safety-guardrails、json-output-format、support-persona のようなキーを使用します
4. 発見のためのタグ付け: チームメイトがカテゴリ別にスニペットを見つけられるようにタグを追加します
5. 参照の確認: スニペットを作成したら、プロジェクトに表示されることを確認します

ワークフロー

ステップ 1: 再利用可能なテキストの特定

スニペットを作成する前に、何が共有されているかを理解します：

1. get-ai-config を各設定に使用して、プロジェクト内の既存の設定を一覧表示します
2. バリエーションのプロンプト間で繰り返されるテキストを探します
3. 一貫性を保つべきテキスト（ガードレール、ペルソナ、形式）を特定します
4. list-prompt-snippets で既存のスニペットを確認し、重複を避けます

ステップ 2: スニペットの作成

create-prompt-snippet を次のもので使用します：

• key -- 一意の識別子（小文字、ハイフン、例：safety-guardrails）
• name -- 人間が読める表示名
• text -- 再利用可能なプロンプトテキストの内容
• description（オプション）-- このスニペットをいつ、なぜ使用するかを説明します
• tags（オプション）-- 発見のために分類します（例：["guardrails", "safety"]）

{
  "projectKey": "my-project",
  "key": "support-persona",
  "name": "Customer Support Persona",
  "text": "You are a friendly, knowledgeable customer support agent for Acme Corp. Always greet the customer by name when available. Be empathetic but concise. If you don't know the answer, say so honestly and offer to escalate.",
  "description": "Standard persona for all customer-facing support configs",
  "tags": ["persona", "support"]
}

ステップ 3: 確認

1. get-prompt-snippet を使用して、スニペットが正しいテキストで作成されたことを確認します
2. list-prompt-snippets を使用して、プロジェクトの一覧に表示されることを確認します
3. 新しく作成されたスニペットのバージョンが 1 であることを確認します

結果を報告:

• キー、名前、テキストを指定してスニペットが作成されたこと
• バージョン番号が確認されたこと
• タグが正しく適用されたこと

ステップ 4: スニペットの更新（必要な場合）

update-prompt-snippet を使用して既存のスニペットを変更します。変更したいフィールドのみを渡します：

{
  "projectKey": "my-project",
  "snippetKey": "safety-guardrails",
  "text": "Updated guardrail text with new compliance requirements..."
}

各更新は新しいバージョンを作成します。スニペットを参照している既存の設定バリエーションは、新しいバージョンを取り込むことができます。

エッジケース

状況	対応
スニペットキーがすでに存在する	get-prompt-snippet で確認し、更新するか別のキーを選択します
非常に長いテキスト	スニペットは大きなブロックを保持できますが、モジュール性のために複数のスニペットに分割することを検討してください
設定から参照されているスニペット	慎重に更新してください — 変更は参照しているすべての設定に伝播します
参照されているスニペットの削除	設定が参照を失うことをユーザーに警告します。delete-prompt-snippet を confirm: true とともに使用してください

やってはいけないこと

• 1か所でしか使用されないテキストのスニペットを作成しないでください
• プロンプト全体を1つのスニペットに入れないでください — 焦点を絞った部分に分割してください
• どの設定が参照しているかを確認せずにスニペットを削除しないでください
• 既存のスニペットを重複させないでください — まず list-prompt-snippets を確認してください

その他のリソース

LaunchDarkly UI でプロンプトスニペットを設定する方法の詳細については、プロンプトスニペットをお読みください。