writing-system-prompts

システムプロンプトエンジニアリング

巧妙さより構成を。抽象的な指示より具体例を。

システムプロンプトは、モデルとの契約です。各行は、誰かがテストできる形でモデルの動作を変えるものでなければなりません。それ以外は、モデルやそのハーネスがデフォルトですでに行っていることも含め、削除してください。

セクションの順序

次の順序に従い、該当しないセクションは省略します。各セクションのルールと良い例・悪い例については、セクションのガイダンスをお読みください。

1. Identity and role
2. Mission and stop criteria
3. Communication style
4. Core workflow
5. Tool usage rules
6. Domain-specific rules
7. Safety and constraints
8. Edge cases and error handling
9. Examples
10. Runtime context (injected at run time)

良いプロンプトに含まれるもの

• 「AI アシスタント」ではなく、具体的な役割。
• 明確な完了基準：いつ終了し、いつ代わりに質問するか。
• 回答の長さは、「簡潔に」のような形容詞ではなく、「4 行未満」のように数値で上限を設定します。
• エージェントの再試行回数の上限と、エスカレーションの手順。
• セキュリティ上重要な操作や破壊的な操作への制約と、それぞれの理由を一度だけ明記します。
• 回答の長さやトーン、ツール呼び出しの判断、エッジケースを示す具体例を 3～10 個用意し、少なくとも 1 組の悪い例から良い例への対比を含めます。例は、プロンプトの中で最も効果の高い要素です。
• セッションごとに変わる値を記載する、実行時コンテキストのセクション。

作成

• 会話や提供されたファイルから、すでに分かる内容を推測します。
• 残りの事項だけを 1 回のメッセージで尋ね、返答を待ちます。AI が何をするのか、ユーザーは誰か、どのツールを使えるのか、「完了」とは何か、絶対にしてはいけないこと、期待される出力形式を確認します。
• プロンプトをコードフェンスで囲んで提示し、続けて、自分が置いた前提を 1 行ずつ記載します。

レビュー

プロンプトをセクションの順序に照らし合わせ、不足しているセクションと配置が不適切なセクションを記録します。該当するレビューのアンチパターンをそれぞれ指摘します。その後、修正します。ユーザーが別の形式を求めていない限り、次の形式で報告します。

## Findings

| Section | Issue | Fix |
| ------- | ----- | --- |

## Revised prompt

```text
<the full revised prompt>
```