expert-instruction

エキスパート向け指示設計

概要

エキスパート向け指示設計では、AI エージェントの振る舞い、できることとできないこと、やり取りを通じた応答方法を定義するシステムプロンプトの作成に重点を置きます。個々のクエリを最適化する一般的なプロンプトエンジニアリングとは異なり、このスキルでは、エージェントのアイデンティティ、能力、制約を形作る永続的な振る舞いのレイヤーを扱います。

使用する場面： AI 製品のシステムプロンプトの作成、顧客向けツールのエージェントのペルソナ定義、振る舞いに関するガードレールの指定、ツール使用ガイダンスの作成、複数ステップのエージェントワークフローの設計。

使用しない場面： 単発のプロンプト最適化（prompt スキルを使用）、ファインチューニングや学習時の設定、インフラレベルの安全対策（モデルプロバイダーの安全機能を使用）、LLM エージェントの振る舞いに関係しないタスク。

クイックリファレンス

パターン	目的	主なポイント
アイデンティティブロック	エージェントが何者かを定義する	役割、専門知識、コミュニケーションスタイル
能力の宣言	エージェントにできることを明示する	明示的なツール一覧、対象領域の境界
制約の指定	振る舞いの境界を定義する	厳格な制限、柔軟な優先事項、エスカレーションルール
出力形式のルール	一貫した応答構成を確保する	テンプレート、段階的な情報開示、長さの制限
ツール使用の指示	ツールを使うタイミングと使い方を案内する	選択基準、エラー処理、順序
複数ターンの振る舞い	会話の継続性に対応する	コンテキストの追跡、話題の切り替え、記憶
ガードレール	有害な振る舞いや対象範囲外の振る舞いを防ぐ	コンテンツの境界、指示の優先順位
エスカレーションの条件	人間に引き継ぐタイミングを定義する	信頼度のしきい値、対象範囲の境界

よくある間違い

間違い	正しいパターン
システムプロンプトが 4000 トークンを超える	2000 トークン未満に抑え、詳細はリファレンスドキュメントに移す
指示が矛盾している	矛盾を監査し、優先順位を定める
ペルソナが曖昧（「役に立つこと」）	専門分野、応答スタイル、知識の範囲を具体的に指定する
エスカレーションの経路がない	エージェントが人間に委ねる、または「わかりません」と答える条件を定義する
あらゆる例外ケースを列挙する	原則を示し、曖昧なケースに限って例を提示する
アイデンティティとタスクの指示を混在させる	分けて記述する：最初にアイデンティティブロック、次にタスクの指示
出力形式の指定がない	見出し、リスト、コードブロック、長さなどの構成を定義する
エラー処理のないツールの指示	ツールが失敗した場合やエラーを返した場合のフォールバック動作を含める
正常系の入力だけをテストする	敵対的な入力、話題から外れた入力、例外ケースの入力をテストする
バージョン管理せずにデプロイする	システムプロンプトのバージョンを追跡し、変更を記録して、ロールバックを可能にする

委任

• プロンプト手法の調査： Explore エージェントを使ってパターンを調査します
• システムプロンプトのテスト： Task エージェントを使って敵対的テストスイートを実行します
• コードレビュー： 統合コードのレビューを code-reviewer エージェントに委任します

prompt スキルが利用可能な場合は、一般的なプロンプトエンジニアリング手法（CoT、few-shot、構造化出力）をそのスキルに委任してください。 利用できない場合は、次を推奨します：pnpm dlx skills add oakoss/agent-skills -s prompt -a claude-code -y

参考資料

• システムプロンプトの設計：構成要素、ペルソナ、ツール、複数ターンの動作
• ガードレールとテスト：動作上の境界、バージョン管理、本番環境への対応