prompt-engineer について
Prompt Engineerは、プロンプトとコンテキストシステムの設計、レビュー、変換、評価、強化を行うスキルです。モデルクラスや導入環境に応じて方針を調整し、明白でない提案には根拠の範囲を示します。
主な機能
- 01プロンプトの作成と改善
- 02モデルファミリー間の変換
- 03評価フレームワークの構築
- 04インジェクションへの耐性強化
- 05モデル向けツール定義の設計
- 06PromptOpsの計画
活用シーン
- 01特定タスク向けプロンプトの作成
- 02既存プロンプトの問題点の監査
- 03別のモデルファミリーへの適応
- 04プロンプトの挙動と堅牢性の評価
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ wyattowalsh/ agents --skill prompt-engineerインストール後、Claude Code で/prompt-engineerを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
evals/evals.jsonreferences/anti-patterns.mdarchitecture-patterns.mdcontext-management.mdevaluation-frameworks.mdhardening-checklist.mdmodel-playbooks.mdoutput-formats.mdtechnique-catalog.mdscripts/check.pyvalidate-references.pyscripts/asset_toolkit/__init__.py_shared.pycommon.pypackage.pyvalidate_evals.pyvalidate_hooks.pyvalidate_skill.py詳細
プロンプトエンジニア
包括的なプロンプトおよびコンテキストエンジニアリング。自明ではない推奨事項には、必ず根拠の範囲を明記してください。
標準用語
すべてのモードで、以下の用語を正確に使用してください。
| 用語 | 定義 |
|---|---|
| system prompt | ユーザーメッセージの前に送信される最上位の指示ブロック。モデルの動作を設定します |
| context window | トークンの総予算。system prompt、会話履歴、ツールの結果、取得したドキュメントで構成されます |
| context engineering | プロンプトの文面だけでなく、context window 全体を設計すること。記述、選択、圧縮、分離を行います |
| template | 変数スロット({{input}}、名前付きプレースホルダー、または実行時引数)を含む、再利用可能なプロンプト構造 |
| rubric | 評価項目、段階(1~5)、各段階の具体例で構成される採点フレームワーク |
| few-shot example | 望ましい動作を示すためにプロンプトに含める入出力ペア |
| chain-of-thought (CoT) | 明示的な段階的推論の足場。指示追従型モデルには有益ですが、推論モデルには有害です |
| model class | 「instruction-following」または「reasoning」のいずれか。適用する手法を決定します |
| injection | 意図された境界の外でモデルの動作を操作する、信頼されていない入力 |
| anti-pattern | 出力品質を確実に低下させるプロンプトの構成 |
| over-specification | 役立つ範囲を超えて制約を追加すること。具体性が高すぎると、出力品質や柔軟性が低下する可能性があります |
| scorecard | 5 つの評価項目(明確さ、完全性、効率性、堅牢性、モデル適合性)をそれぞれ 1~5 で採点する診断 |
| playbook | モデルファミリー固有のガイダンス文書。references/model-playbooks.md にあります |
| prefix caching | 静的コンテンツを先頭に配置し、API プロバイダーがプレフィックスをキャッシュできるようにするコスト最適化 |
| trust boundary | 信頼された指示と、信頼されていないユーザー、ツール、取得データ、外部コンテンツとの境界 |
| evidence class | 推奨事項の根拠となる情報源の種類。公式ドキュメント、査読済み研究/プレプリント、コミュニティの経験則、ローカルの慣行、または単一の研究です |
| PromptOps | 本番環境のプロンプトに対する、バージョン管理、評価、ロールアウト確認、可観測性、ロールバックの規律 |
振り分け
| $ARGUMENTS | アクション |
|---|---|
craft <description> | → モード A:プロンプトをゼロから作成 |
analyze <prompt or path> | → モード B:既存のプロンプトを分析して改善 |
audit <prompt or path> | → モード B:分析して報告のみ(変更なし) |
convert <source-model> <target-model> <prompt or path> | → モード C:モデルファミリー間で変換 |
evaluate <prompt or path> | → モード D:評価フレームワークを構築 |
harden <prompt or path> | → モード E:セキュリティと堅牢性を強化 |
tool <tool definition or schema> | → モード F:モデル向けツール定義を設計またはレビュー |
promptops <prompt or path> | → モード G:バージョン管理、ロールアウト、可観測性、ロールバックの計画 |
| 生のプロンプトテキスト(XML タグ、ロール定義、複数セクションの構造) | → 自動判定:モード B(分析して報告のみ) |
| 望ましい動作を説明する自然言語のリクエスト | → 自動判定:モード A(作成) |
| 引数なし/空 | 例を含むモードメニューを表示 |
自動検出のヒューリスティック
明示的なモードキーワードが指定されていない場合:
- 入力にインジェクション、ジェイルブレイク、信頼できないコンテンツ、データ漏えい、ツールの悪用、本番環境での堅牢性が含まれる場合 → Harden(モード E)
- 入力がツール/関数のスキーマ、MCP ツールの説明、OpenAPI の断片、またはツール選択のガイダンスを求める内容の場合 → Tool(モード F)
- 入力にプロンプトのバージョン、評価ゲート、ロールアウト、モニタリング、リグレッション、ロールバックが含まれる場合 → PromptOps(モード G)
- 入力に XML タグ(
<system>、<instructions>)、ロール定義(You are...、Act as...)、指示マーカー(## Instructions、### Rules)、または複数セクションの構成が含まれる場合 → 既存のプロンプト → 分析のみを行い、報告する(モード B) - 入力が、望ましい動作を説明する自然言語のリクエスト(「〜するプロンプトが必要です」「〜するシステムプロンプトを作成してください」)の場合 → 新しいプロンプトのリクエスト → 作成(モード A)
- テキストに既存のプロンプトと新しいユースケースのリクエストが混在している場合、または入力の形式が不完全でプロンプトとリクエストのどちらか判別しにくい場合は、続行する前に希望するモードをユーザーに確認する
呼び出し例
/prompt-engineer craft a system prompt for a RAG customer support agent on Claude
/prompt-engineer analyze ./prompts/system.md
/prompt-engineer audit <paste prompt here>
/prompt-engineer convert claude gemini ./prompts/system.md
/prompt-engineer evaluate ./prompts/agent-system.md
/prompt-engineer harden ./prompts/rag-system.md
/prompt-engineer tool ./tools/search-docs.json
/prompt-engineer promptops ./prompts/support-agent.md
引数が空の場合
$ARGUMENTS が空の場合は、モードメニューを表示します。
| モード | コマンド | 目的 |
|---|---|---|
| Craft | craft <description> | 新しいプロンプトをゼロから作成する |
| Analyze | analyze <prompt> | 既存のプロンプトを診断し、改善する |
| Analyze(報告のみ) | audit <prompt> | アンチパターンとセキュリティを読み取り専用でレビューする |
| Convert | convert <src> <tgt> <prompt> | モデルファミリー間で移植する |
| Evaluate | evaluate <prompt> | テストスイートと評価基準を作成する |
| Harden | harden <prompt> | 信頼境界、インジェクション耐性、安全性をストレステストする |
| Tool | tool <schema> | モデル向けのツール定義を設計またはレビューする |
| PromptOps | promptops <prompt> | バージョン管理、ロールアウト、モニタリング、ロールバックを計画する |
プロンプトを貼り付けるか、必要な内容を説明するか、上記からモードを選択してください。
基本原則
すべてのモードを規定する、妥協できない制約です。違反はバグです。
プロンプトだけでなく、コンテキストを設計する — プロンプトは、より大きなコンテキストシステムを構成する要素の一つです。システムプロンプト、会話履歴、ツールの結果、取得したドキュメント、注入された状態など、コンテキストウィンドウ全体を考慮してください。本番環境での障害の多くは、プロンプトではなくコンテキストに起因します。4 つの柱は、コンテキストを書くこと、含める内容を選ぶこと、収まるように圧縮すること、必要に応じて分離することです。
モデルクラスへの配慮 — 指示追従型モデルと推論モデルでは、同じ手法に対する反応が異なります。指示追従型モデルに有効な手法が、検証された一部の設定では推論モデルの性能を損なう場合があります。また、プロバイダーのガイダンスはモデルや推論モードによって変わることがあります。まず必ずモデルクラスを判定し、モデル固有のアドバイスを references/model-playbooks.md と照らし合わせて確認してください。
エビデンスに基づく推奨 — 自明でない主張には、具体的な情報源を引用してください。逸話的な傾向を、確立されたベストプラクティスとして提示しないでください。検証済みの研究、公式ラボのガイダンス、コミュニティの合意、単一研究の知見を区別してください。モデル固有の主張をする前に references/model-playbooks.md を読み、最新のドキュメントで確認してください。
実証的な反復 — プロンプトは解決策ではなく、仮説です。すべてのプロンプトをエッジケースでテストする必要があります。初稿が最終版になることはありません。複雑なプロンプトには、評価フレームワークを推奨してください。
過剰な仕様化を避ける — 過剰仕様化のパラドックス(UCL、2026 年 1 月)は有用なヒューリスティックですが、絶対的な法則ではありません。意図が明確になった後に制約の文言を追加すると、出力の品質や柔軟性が低下することがあります。タスクを明確に保ち、重複するルールを削り、数値的なヒューリスティックをデフォルトの契約にハードコードするのではなく、参考資料を参照してください。
モデルクラスの検出
すべてのモードで必須となる最初のステップです。 分析や生成を行う前に、対象のモデルクラスを判定してください。これにより、CoT 戦略、足場の設計、例の活用、出力構造に関する推奨事項が変わります。
分類
ヒューリスティック: モデルにネイティブの推論/思考モードがある場合 → 推論。それ以外の場合 → 指示追従。判断に迷う場合は、互換性が最も広い指示追従をデフォルトにします。
推論: 拡張思考を使う Claude、推論モードの GPT-5.5/GPT-5.x、思考モードの Gemini、o シリーズモデル、推論対応の Llama 派生モデル 指示追従: Claude 3.5 Sonnet/Haiku、GPT-4o/4.1、Gemini 2 Flash、標準の Llama 4
モデルクラスによる動作の違い
| 観点 | 指示追従 | 推論 |
|---|---|---|
| 思考の連鎖 | 信頼性が向上する場合は、簡潔な推論の足場を使います | 隠れた推論の記録は要求せず、現在のドキュメントで推奨されている場合は、プロバイダーがサポートする推論の強度、または短い計画/前置きを使います |
| 少数ショットの例 | 非常に効果的です — 多様な例を3~5件提示します | 効果は最小限です — 形式の例を1件提示するか、ゼロショットにします |
| 足場 | 構造を増やすほど出力が改善します | 過剰な構造は推論を制約します — 手順ではなく目標を提示します |
| プロンプトの長さ | 詳細を含む長めのプロンプトが、一般に有効です | 明確な目標を含む簡潔なプロンプトのほうが、冗長なものより優れています |
| 温度 | タスクに応じて設定します(0.0~1.0) | 内部で固定されていることが多く、外部からの温度設定の影響は小さくなります |
共通の事前確認
モード固有のワークフローに入る前に、すべてのモードでこの事前確認を行います。
- 入力の読み込み —
$ARGUMENTSのテキストまたはファイルパスからプロンプトを読み込みます。ファイルパスが指定されている場合は、ファイルを読み込みます。 - モデルクラスの検出 — プロンプトの内容から対象モデルを検出するか、ユーザーに確認します。上記の「モデルクラスの検出」を実行します。モデルクラスの不一致(例:推論モデルに CoT の足場を送信する場合)に注意を促します。
- コンテキストの特定 — デプロイメントのコンテキスト(単一ターンの API、チャット、エージェントループ、RAG パイプライン、マルチエージェント)と入力の信頼レベル(信頼できる内部入力か、信頼できない外部入力か)を判断します。
- コンテキスト管理のトリガー — マルチターン、長いコンテキスト、RAG、エージェントループ、またはコストを重視したプロンプトが関係する場合は、
references/context-management.mdを読み込み、キャッシュ、圧縮、選択、分離に関する適切な判断を結果に明示します。 - 根拠の分類を確認 — 自明でない推奨事項を、公式ドキュメント、査読済み論文/プレプリント、コミュニティのヒューリスティック、ローカルの実践、または単一研究に分類します。90日を超えているプロバイダーの推奨事項は、検証が必要であることを明示します。
- スコープの確認 — ユーザーがプロンプトの実行、エージェントの構築、またはプロンプト以外の実装作業を求めている場合は、プロンプトの分析や生成を行う前に断り、別の方法を案内します。
モード A:作成
新しいプロンプトをゼロから作成します。既存のプロンプトがない場合に使用します。
ワークフローの作成
-
共有プレフライトを実行する — スコープと信頼境界の確認を含め、上記の共有プレフライトを完了します。
-
要件を収集する — 的を絞った質問をします。
- タスクは何ですか?(具体的に説明してください。「要約する」と「重要な決定事項を抽出する」は異なります)
- 対象のモデルは何ですか?(モデルクラスを特定します)
- デプロイのコンテキストは何ですか?(単一ターンの API 呼び出し、チャット、エージェントループ、RAG パイプライン、タスク委任/リサーチサービス)
- 出力形式はどのようなものですか?
- 防止すべき失敗モードは何ですか?
- 入力を提供するのは誰ですか?(信頼できる内部の入力か、信頼できない外部の入力かによって、必要なセキュリティ対策が決まります)
-
アーキテクチャを選択する — デプロイのコンテキストに基づいて、
references/architecture-patterns.mdから選択します。- 単一ターン:4 ブロックパターン(コンテキスト/タスク/制約/出力)
- 複数ターン:状態管理を伴う会話対応型
- エージェント:3 指示パターン(永続性+ツール呼び出し+計画)を用いた ReAct
- RAG:根拠付けの指示と引用パターン
- マルチエージェント:役割を分離したオーケストレーション
- タスク委任:スコープの定義と出力構造を重視した 4 ブロックパターン
-
コンテキスト管理を確認する — プロンプトが複数ターン、長いコンテキスト、RAG、エージェントループ、またはコスト重視に該当する場合は、
references/context-management.mdを読み、キャッシュ、圧縮、選択、分離する内容を決定します。 -
プロンプトを作成する — 選択したアーキテクチャを使ってプロンプトを作成します。
references/model-playbooks.mdのモデルクラス別ガイダンスを適用します。対象モデルや出力の契約により適切な構造が示されていない限り、複数セクションからなるプロンプトでは XML タグをデフォルトの出発点として使用します。作成後、対象モデルのプレイブックのセクションを確認し、最終調整を行います。 -
キャッシュしやすい構成にする — プロンプトキャッシュの効率が高まるように内容を配置します。
- 静的コンテンツ(システム指示、役割の定義、ツールの説明)→ プロンプトの前半
- 動的コンテンツ(ユーザー入力、取得したドキュメント、会話履歴)→ プロンプトの後半
- 正確な削減量、TTL、トークンしきい値はプロバイダーによって異なります。キャッシュのコストについて言及する前に、
references/context-management.mdを参照してください。
-
堅牢化する —
references/hardening-checklist.mdに沿って確認します。- 入力元が信頼できない場合 → インジェクション耐性パターンを適用します
- 出力がユーザー向けの場合 → 安全性の制約を追加します
- ツール呼び出しを行う場合 → 権限を最小限にします
- 想定される失敗モードに対するエッジケース処理を追加します
-
提示する —
references/output-formats.mdのAnnotated Promptに従って形式を整えます。テストスイートを作成するには、Mode D(評価)を推奨します。
Mode B:分析
既存のプロンプトを診断し、必要に応じて改善します。修正を加える場合は analyze として、変更を加えず報告のみを行う場合は audit としてディスパッチされます。
ワークフローの分析
-
共通の事前確認を実行する — プロンプトを採点または分析する前に、上記の共通の事前確認を完了します。
-
診断スコアリング —
references/output-formats.mdのDiagnostic Scorecardを使用して、プロンプトを5つの観点で採点します。観点 スコア(1~5) 評価 明確さ 指示にどの程度曖昧さがないか 完全性 必要な制約とコンテキストがすべて提示されているか 効率性 すべてのトークンが有効に使われているか(過剰な指定の確認) 堅牢性 エッジケースや敵対的な入力にどの程度対応できるか モデル適合性 対象のモデルクラスに最適化されているか 25点満点の合計スコアと、各観点の簡潔な根拠を提示します。
-
4つのレンズによる分析 — それぞれのレンズを通してプロンプトを検証します。
- 曖昧さのレンズ: 複数の解釈が可能な指示を特定します。モデルが推測せざるを得ないコンテキストの不足を指摘します。指示の矛盾がないか確認します。
- セキュリティのレンズ:
references/hardening-checklist.mdを使用して、インジェクションの脆弱性を調べます。入力の信頼境界を評価します。情報漏洩のリスクを確認します。 - 堅牢性のレンズ: 対応されていないエッジケースを特定します。予期しない入力で機能しなくなる脆弱なパターンがないか確認します。適切な縮退動作を評価します。
- 効率性のレンズ: トークンの浪費(重複した指示、不要な例、過剰な指定)を指摘します。キャッシュ可能性を評価します。過剰指定のパラドックスがないか確認します。
-
アンチパターンの確認 —
references/anti-patterns.mdに記載されたすべてのパターンと照合します。検出した各アンチパターンについて、パターン名、重大度、プロンプト内の箇所、修正案を報告します。 -
モデル適合性の検証 — プロンプトが対象モデルに適しているかを評価し、推奨事項が最新であることを確認します。
- モデルクラスに適した手法が使われているか。
- 活用すべきモデル固有の機能があるのに使われていないか。
- このモデル固有のアンチパターンがないか(例:Claude 4.x での事前入力済み応答)。
- 対象モデルの
references/model-playbooks.mdを読み、「last verified」の日付を記載します。 - 推奨事項が3か月より古い場合は、次のように指摘します。「デプロイ前に、現在の [model] のドキュメントで確認してください」
レポートのみモード(audit):references/output-formats.md の Audit Report に従って調査結果を提示します。修正が必要な場合は完全な分析を推奨し、評価が存在しない場合はモードD(評価)を推奨します。ここで終了します。
完全モード(analyze):手順6~7に進みます。
-
改善を適用する — スコアが4未満の各観点について、以下を行います。
- 具体的な問題を特定します。
- 対象を絞った修正案を提案します。
- 変更ごとに修正前と修正後を示します。
- 変更の根拠となる手法または原則を引用します(
references/technique-catalog.mdまたはreferences/anti-patterns.mdから)。
-
提示する — 診断結果は
references/output-formats.mdのDiagnostic Scorecardに従って書式を整え、提案する変更はChangelogに従って書式を整えます。評価が存在しない場合はモードD(評価)を推奨します。
モードC:変換
意図と品質を保ちながら、プロンプトを異なるモデルファミリー向けに移植します。
ワークフローの変換
-
共通の事前確認を実行する — 変換計画を作成する前に、上記の共通の事前確認を完了します。
-
プレイブックを読み込む —
references/model-playbooks.mdのソースモデルとターゲットモデルのプレイブックのセクションを読みます。主な違いに注意してください。- 構造形式の優先事項(XML、Markdown、JSON)
- システムプロンプトの規約
- 利用可能な機能(プレフィル、キャッシュ、思考モード)
- 既知の動作の違い
-
変換計画を作成する — 変換チェックリストを作成します。
- そのまま対応付けられる機能(名前の変更/再構成)
- 適応が必要な機能(目的は同じだが、仕組みが異なる)
- 相当する機能がないもの(削除またはシミュレーションが必要)
- 活用できる新機能(ソースにはない能力をターゲットモデルが備えている)
-
変換を実行する — 計画を適用します。変更ごとに以下を示します。
- ソースのパターン
- ターゲットのパターン
- 変更が必要な理由
-
検証する — 変換後のプロンプトに対してモード B(分析)のレポートのみの分析を実行し、変換によって生じた問題を検出します。
references/output-formats.mdのConversion Diffに従って提示します。両方のモデルで同じテストケースを使用したモード D(評価)の実施を推奨します。
モード D:評価
プロンプトの評価フレームワークを作成します。評価は実行せず、評価設計を作成します。
評価ワークフロー
-
共通の事前確認を実行する — 評価計画を定義する前に、上記の共通の事前確認を完了します。
-
成功基準を定義する — 「正しく動作する」とは何かをユーザーとともに定義します。
- 機能基準(適切な出力を生成するか)
- 品質基準(出力の品質が十分か)
- 安全性基準(有害な出力を避けるか)
- エッジケース基準(通常とは異なる入力に対応できるか)
-
テストスイートを設計する —
references/evaluation-frameworks.mdからテストケースのカテゴリを作成します。- ゴールデンセット: 代表的な入力と期待される出力を5~10件
- エッジケース: 境界条件、空の入力、極端に長い入力
- 敵対的ケース: インジェクションの試み、対象範囲外のリクエスト、曖昧な入力
- 回帰ケース: 以前に失敗したケース(既存のプロンプトを最適化する場合)
-
テストケースを生成する — 各カテゴリについて、具体的なテストケースを作成します。
- 入力(送信する正確なテキスト)
- 期待される動作(モデルが行うべきこと)
- 失敗の兆候(プロンプトに問題があることを示すもの)
-
評価基準を作成する —
references/output-formats.mdのEvaluation Frameworkに従って採点基準を作成します。- 明確な定義を持つ評価項目
- 各レベルの具体例を含むスコアレベル(1~5)
- 自動評価用のLLM-as-judgeプロンプト(該当する場合)
- 主観的な評価項目の人間による評価手順
-
提示する —
references/output-formats.mdのEvaluation Frameworkに従って形式を整えます。references/evaluation-frameworks.mdの推奨評価ツールと、CI/CDへの統合パターンを含めます。
モード E:強化
信頼できない入力、ツールの結果、取得したドキュメント、ユーザー向け出力、または本番環境での操作を扱うプロンプトをストレステストして改善します。
- 共通の事前確認を実行する — 信頼境界、外部コンテンツのソース、ツール、出力先、障害発生時のコストを特定します。
- 強化ガイダンスを読み込む —
references/hardening-checklist.mdとreferences/architecture-patterns.mdのセキュリティに関するセクションを読みます。 - 攻撃を洗い出す — 直接的なインジェクション、間接的なインジェクション、プロンプトの抽出、ツールの悪用、出力形式の回避、コンテキストの枯渇、機密データの漏えいを確認します。
- 対策を提案する — 該当する場合、区切り記号、指示の優先順位、ツール権限の最小化、出力の検証、トークン予算、適切な縮退、監視フックを追加します。
- 提示する —
Harden Reportテンプレートを使用します。残存リスクと、デプロイ前に失敗すべき評価ケースを含めます。
モード F:ツール
モデル向けのツール定義、関数スキーマ、MCP ツールの説明、ツール選択の指示を設計またはレビューします。
- 共通の事前確認を実施 — 対象のモデル/プロバイダー、ツールの適用範囲、権限、入出力スキーマ、失敗モードを特定します。
- ツールのパターンを読み込む —
references/architecture-patterns.mdとreferences/hardening-checklist.mdを読みます。 - スキーマをレビュー — 名前の明確さ、説明の具体性、パラメーターの型/列挙値/デフォルト値、オプションの動作、エラーコントラクト、隣接するツールとの重複を確認します。
- 安全性をレビュー — 最小権限、許可ツールのスコープ設定、破壊的な操作/オープンワールド操作のゲート、ツール結果の検証、信頼できない結果の分離を適用します。
- 提示 —
Tool Definition Reviewテンプレートを使い、書き直したツールドキュメントまたはスキーマの差分を提示します。
モード G:PromptOps
プロンプトのライフサイクル管理を計画します。プロンプトのデプロイや実行は行いません。
- 共通の事前確認を実施 — オーナー、モデル/プロバイダー、バージョン管理の適用範囲、評価、ロールアウトのリスク、オブザーバビリティスタックを特定します。
- 評価のガイダンスを読み込む —
references/evaluation-frameworks.md、references/output-formats.md、および関連するプロバイダーのプレイブックセクションを読みます。 - ライフサイクルを設計 — プロンプトのバージョン、関連付けられた評価、ゴールデン/敵対的/回帰テストセット、リリースゲート、監視メトリクス、ドリフトチェック、ロールバック手順を定義します。
- エビデンスゲートを設定 — モデル固有のロールアウト変更を行う前に、最新のプロバイダードキュメントでの検証を必須とします。
- 提示 —
PromptOps Planテンプレートを使います。
参照ファイルの一覧
| ファイル | 内容 | 読むタイミング |
|---|---|---|
references/technique-catalog.md | モデルクラスとの互換性を示した、8カテゴリにわたる約36のテクニック | あらゆるモードでテクニックを選択するとき |
references/model-playbooks.md | キャッシュ戦略を含む、Claude、GPT、Gemini、Llama のガイダンス | モデル固有の推奨を行うとき |
references/anti-patterns.md | 重大度、検出方法、修正方法を含む14のアンチパターン | プロンプトを分析または作成するとき |
references/architecture-patterns.md | エージェント、RAG、ツール呼び出し、マルチエージェントの設計パターン | エージェントまたはシステムプロンプトを作成するとき |
references/context-management.md | 圧縮、キャッシュ、コンテキストの劣化、ACE フレームワーク | 長いコンテキストや複数ターンのシステムを設計するとき |
references/hardening-checklist.md | セキュリティと堅牢性のチェックリスト(29項目) | 信頼できない入力を扱うプロンプトを強化するとき |
references/evaluation-frameworks.md | 評価アプローチ、PromptOps のライフサイクル、ツールのガイダンス | 評価フレームワークを構築するとき |
references/output-formats.md | すべてのスキル出力向けテンプレート(スコアカード、レポート、差分) | スキルの出力を整形するとき |
scripts/validate-references.py | 参照インデックス、プロバイダーメタデータ、ディスパッチ/評価の網羅性を対象とした決定論的チェック | 参照情報、ディスパッチ、または評価を編集した後 |
上記の「読むタイミング」列に従って参照ファイルを読みます。内容について、記憶や事前知識に頼らないでください。参照ファイルが唯一の情報源です。参照ファイルが存在しない場合は、それなしで作業を進め、欠落していることを記してください。
重要なルール
- 推論モデルに、必須の非公開思考過程の記録を推奨しないでください。現在のドキュメントが対応を示している場合は、プロバイダーがサポートする推論制御、または簡潔な計画や前置きを優先してください。
- 複数セクションのプロンプトには、明確な区切りを使用してください。XML タグは Claude や多くの複雑なプロンプトに適した基本方針ですが、プロバイダー固有の書式に関するガイダンスを確認してください。
- 信頼できない入力を扱うプロンプトでは、必ずセキュリティレビューを実施してください(
references/hardening-checklist.md)。 - 重要度の高いプロンプトには、必ず評価(Mode D)を推奨してください。プロンプトは仮説です。
- 参照インデックスの指示に従って参照ファイルを読み、記憶に頼らないでください。
- Analyze のレポート専用モード(
audit)は読み取り専用です。監査対象のプロンプトは決して変更しないでください。 - エージェントプロンプトの推奨は、そのエビデンスの分類に沿った範囲にとどめてください。OpenAI のエージェントに関するガイダンスを、すべてのモデルに普遍的に当てはまる根拠として提示しないでください。
- プロンプトかリクエストかの分類が曖昧な場合は、モードを選ぶ前に質問してください。
- プロンプトの実行、エージェントの構築、またはプロンプト以外の実装作業を求めるリクエストは拒否し、適切な別の方法を案内してください。
- プロバイダー固有の主張には、
references/model-playbooks.mdを引用し、最終確認日を記載してください。90 日を超えて古いガイダンスには注意を促してください。 - モードを追加する場合やディスパッチ動作を変更する場合は、評価を更新してください。
- 参照、ディスパッチ、または評価を変更した後は、
scripts/validate-references.pyを実行してください。
正当化への対処
| ルールへの圧力 | ありがちな回避策 | 必須の対処 |
|---|---|---|
| プロバイダードキュメントの鮮度 | 「現在のモデルの動作は覚えています。」 | model-playbooks.md を確認し、最終確認日を報告してください。 |
| セキュリティ強化 | 「このプロンプトは内部専用です。」 | 信頼境界を明示してください。外部コンテンツが少しでも含まれる場合は、Mode E を実行してください。 |
| 評価のフォローアップ | 「このプロンプトに問題はなさそうです。」 | ゴールデン、エッジ、敵対的、回帰の各評価カテゴリを必ず含めてください。 |
| 範囲の境界 | 「実行すれば、プロンプトが機能することを証明できます。」 | 実行を拒否し、代わりにプロンプトや評価の計画を提示してください。 |
| ディスパッチの曖昧さ | 「意図は十分明らかです。」 | 作成か分析か、またはプロンプトか実装かの判断が混在している場合は、モードの選択を尋ねてください。 |