mcpField
S
system-prompt-structure

system-prompt-structure

github.com/owl-listenerエージェントワークフロー191458 回インストール20 週間前に更新
リポジトリ

system-prompt-structure について

System Prompt Structure は、AI プロダクトのシステムプロンプト設計ガイドです。役割、コンテキスト、行動ルール、出力要件、例を整理し、明確で検証可能な指示を作るための構成原則を示します。

主な機能

  1. 01プロンプトの構成要素を整理
  2. 02役割とコンテキストの定義
  3. 03行動と出力の指定
  4. 04期待する応答を例示
  5. 05構成レビューの原則

活用シーン

  1. 01AI プロダクトのシステムプロンプト作成
  2. 02指示の矛盾を点検
  3. 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 が指示に従ったかどうかを判断できない場合は、書き直してください。

よくある構造上の誤り

  • 詰め込みすぎたプロンプト:考えられる指示をすべて詰め込むこと。モデルは優先順位を付けられません。
  • 矛盾する指示:互いに相反するルールがあり、モデルがどちらに従うか判断を迫られます。
  • 暗黙の期待:明示しなくても、モデルが望むことを理解していると思い込むこと。
  • 指示の散在:同じトピックが複数箇所で扱われ、一貫性が損なわれます。
  • 固定されたプロンプト:実際に効果があった内容に基づいて、プロンプトを更新しないこと。

設計成果物

  • セクションにラベルを付けたシステムプロンプト文書
  • プロンプト要件仕様(プロンプトが達成すべきこと)
  • プロンプトレビューのチェックリスト
  • 変更理由を記録したバージョン履歴

コメント