prompt-engineer

プロンプトエンジニアリング

ユーザーが対象とするモデル向けのプロンプトを作成または改訂します。共通のプロンプトは移植性を保ち、関連するモデルガイドのみを読み込みます。各ページでは、観察された挙動をプロンプトの調整、プロンプトの文言、注意事項に結び付けています。ガイド全体をプロンプトに貼り付けるのではなく、一致するパターンを使用してください。各ガイドが扱うのはプロンプトであり、API リクエストの設定ではありません。また、あるモデルでの挙動が別のモデルに自動的に引き継がれるわけではありません。

ワークフロー

1. 目標、対象者、モデル、権限、出力、代表的な失敗例を確認します。プロンプトに重大な影響を与える情報が不足している場合にのみ質問します。
2. 必要な共通リファレンスと、以下にある対象モデルのページを読みます。パスはこのスキルのディレクトリを基準に解決してください。
3. 新しい文言を追加する前に、古くなった指示や冗長な指示を削除します。拘束力のある要件は維持してください。
4. 複雑なプロンプトでは、Role · Goal · Success criteria · Constraints · Tools · Output · Stop rules を使用します。挙動を変えないセクションは省略してください。
5. プロンプトまたは設定の変数を一度に1つだけ変更し、代表的なケースで比較します。可能な場合は、タスクの成功率、出力の妥当性、ツールの挙動、レイテンシ、トークン数、コストを測定します。
6. 改訂後のプロンプト、簡潔な変更概要、検証結果または検証計画を提示します。実施していない確認項目には、その旨を明記してください。

共通リファレンス

読むファイル	読むタイミング
references/core_prompting.md	明確さ、コンテキスト、役割、出力、例、またはグラウンディングを定義するとき
references/advanced_patterns.md	エージェント、ツールのルーティング、委任、長いコンテキスト、または引き継ぎを設計するとき
references/quality_improvement.md	蓄積されたスキルやリポジトリの指示を監査するとき、またはプロンプトを最適化、評価、保護、トラブルシューティングするとき

モデルガイド

対象	参照先	主な違い
GPT-6.1 Sol	references/gpt_6_1_sol.md	対応する effort への移行、タスクと承認の契約、Astra で観測されたテンプレートの選択的な採用、ツールと会話の互換性
GPT-6.1 Terra	references/gpt_6_1_terra.md	視覚、コンピューター操作、執筆タスクの契約、effort は medium から開始（none にも対応）、GPT-5.6 Terra から同じ effort への移行、Astra で観測されたテンプレートの選択的な採用
GPT-6 Astra、Sol、Luna	references/gpt_6.md	承認のための一時停止、スキルの指示の競合、執筆スタイル、委任、検証に関する OpenAI 公式テンプレート、Sol／Luna の effort 感度
GPT-5.6 Sol、Terra、Luna	references/gpt_5_6.md	簡潔なプロンプト、簡潔さを重視したデフォルト設定、高 effort および pro モードのプロンプト、プログラムによるツールの段階的な実行、キャッシュに適した順序
GPT-5.5	references/gpt_5_5.md	結果を優先する基本方針、検索の制限、根拠に基づく草稿、明示的な検証
Claude Fable 5.1	references/claude_fable_5_1.md	進捗の可視化、バッチ処理、追記のみのリマインダー、出力上限内での完了
Claude Fable 5	references/claude_fable_5.md	長時間タスクの完了、根拠に基づく進捗、タスク単位での独立した検証、拒否への対応
Claude Opus 5.5	references/claude_opus_5_5.md	常時有効な思考、進捗の頻度、無人での継続に対する制限、貼り付けられたコンテンツの境界
Claude Haiku 5.5	references/claude_haiku_5_5.md	effort、日付を手がかりにした検索、JSON とツールの使用、長時間のエージェントタスクの完了、検証、拒否
Claude Opus 5	references/claude_opus_5.md	応答の長さと effort の分離、冗長な検証の削減、委任の制限
Claude Opus 4.8	references/claude_opus_4_8.md	調整可能な思考、文字どおりのスコープ、ツールの呼び出し、設計の代替案
Claude Sonnet 5.5	references/claude_sonnet_5_5.md	再調整された effort、コーディング作業の完遂、スコープの制限、無言のツールループ、検索と検証のプロンプト、ターン途中のメッセージ配置
Claude Sonnet 5	references/claude_sonnet_5.md	デフォルトで有効な思考、サンプリングではなくプロンプトによる多様性、文字どおりのスコープとレビューの想起

移行する場合は、移行元と移行先の両方が一覧にあるときは、両方のページを参照してください。複数モデル向けのプロンプトでは、共通要件をメインの契約にまとめ、動作に影響する違いだけを切り分けてください。単一モデルのタスクで、すべてのページを読み込む必要はありません。

共通ルール

• 結果と完了の基準を示し、通常のパス選択はモデルに任せます。
• 関連するコンテキストと、重要な制約を設ける簡潔な理由を示します。
• 絶対的な表現は、安全性、権限、必須フィールド、禁止行為など、真に不変の要件に限って使用します。判断を要する場合は条件付きのルールを使用します。
• ユーザーまたはパーサーが依存する場合は、出力の長さ、セクション、形式、検証を指定します。ホストが機械出力を強制する場合は、スキーマを使用します。
• 役立つ場合は、説明的な XML タグを使って、混在する指示、コンテキスト、例、信頼できない文書を分けます。単純なプロンプトにマークアップは不要です。
• 測定可能な動作の改善につながる場合に限り、例を含めます。例が文書化された契約に従っていることを確認します。
• 重大な主張には根拠を求め、不確実性を認め、根拠がない場合の対応を定めます。
• 結論、根拠、観察された動作、検証結果を求めます。応答文で非公開の推論を再構成するようモデルに求めないでください。
• 検証と委任は、モデルとタスクに合わせて調整します。必要なチェック、実際の承認ゲート、ハーネスの並行実行および実行ルールを維持します。
• プロンプトでツールや機能に言及しても、それらが利用可能になるわけではありません。ホストが実際に公開しているツールに限ってプロンプトに記述します。

プロンプトはエラーを減らしますが、なくすことはできません。最適化する際も、安全性、ビジネス、根拠、権限、後続パーサーの制約を維持してください。