system-prompt-structure について
System Prompt Structure は、AI プロダクトのシステムプロンプト設計ガイドです。役割、コンテキスト、行動ルール、出力要件、例を整理し、明確で検証可能な指示を作るための構成原則を示します。
主な機能
- 01プロンプトの構成要素を整理
- 02役割とコンテキストの定義
- 03行動と出力の指定
- 04期待する応答を例示
- 05構成レビューの原則
活用シーン
- 01AI プロダクトのシステムプロンプト作成
- 02指示の矛盾を点検
- 03出力要件を検証可能にする
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ owl-listener/ ai-design-skills --skill system-prompt-structureインストール後、Claude Code で/system-prompt-structureを入力して読み込まれたか確認します。
詳細
システムプロンプトの構造
システムプロンプトは、AI 製品の設計において最も重要な要素です。AI がどのような存在で、何を知っていて、どのように振る舞い、何を生成するかを定義します。これは、ブランドガイド、インタラクション仕様、行動規範を一つの文書にまとめたものに相当します。
システムプロンプトの構成
適切に構成されたシステムプロンプトには、明確なセクションがあり、それぞれが特定の目的を果たします。 1. アイデンティティと役割 AI は何者ですか?目的は何ですか?この部分が、その後のすべての基盤となります。
- 「あなたは、デザインチームを支援するシニア UX リサーチャーです……」
- 具体的にしてください。「あなたは親切なアシスタントです」では曖昧すぎて、一貫した振る舞いを引き出せません。 2. コンテキストと知識 AI は何を知っていますか?どのような領域を扱いますか?どのような情報を基に作業しますか?
- 領域の境界:専門とする分野と、対象外の範囲
- タスクに関連する背景情報
- ユーザーのコンテキスト:誰と話し、相手が何を必要としているか 3. 行動ルール AI はどのように振る舞うべきですか?すべきことと、してはいけないことは何ですか?
- トーンと表現の仕様
- 回答形式の希望
- ガードレールと禁止される振る舞い
- インタラクションのスタイル(確認の質問をする、簡潔にする、段階的に考える) 4. 出力仕様 AI は何を生成すべきですか?どのような形式で出力しますか?
- 期待される出力の構成
- 長さの指針
- 形式の要件(markdown、JSON、プレーンテキスト)
- 品質基準 5. 例(任意ですが効果的) 期待される振る舞いを具体的に示します。
- 理想的な回答を示す入力と出力のペア
- 難しい状況への対処方法を示すエッジケース
構造の原則
- 順序が重要です:モデルは、プロンプトの冒頭と末尾の内容により注意を払います。最も重要な指示を先に配置してください。
- 簡潔さより具体性が重要です:短く具体的なプロンプトは、長く曖昧なプロンプトよりも効果的です。
- 否定的な指示より肯定的な指示が効果的です:「Y をするな」より「X をしてください」のほうが明確です。ただし、どちらにも使いどころがあります。
- 関心事の分離:アイデンティティ、ルール、出力仕様は、それぞれ別のセクションにまとめてください。
- テスト可能性:プロンプト内のすべての指示は、テスト可能であるべきです。AI が指示に従ったかどうかを判断できない場合は、書き直してください。
よくある構造上の誤り
- 詰め込みすぎたプロンプト:考えられる指示をすべて詰め込むこと。モデルは優先順位を付けられません。
- 矛盾する指示:互いに相反するルールがあり、モデルがどちらに従うか判断を迫られます。
- 暗黙の期待:明示しなくても、モデルが望むことを理解していると思い込むこと。
- 指示の散在:同じトピックが複数箇所で扱われ、一貫性が損なわれます。
- 固定されたプロンプト:実際に効果があった内容に基づいて、プロンプトを更新しないこと。
設計成果物
- セクションにラベルを付けたシステムプロンプト文書
- プロンプト要件仕様(プロンプトが達成すべきこと)
- プロンプトレビューのチェックリスト
- 変更理由を記録したバージョン履歴
コメント
Markdown 対応