エンジニアリングのテンプレート
プルリクエストのレビューのプロンプトテンプレート
重大度順の指摘を含む、diff の構造化レビュー。 プルリクエストの自動または支援付きの一次チェックで、レビュアーがブロッカーから優先して確認できるよう指摘を順位付けしたいとき。
プロンプト
プロンプト本体は、作成・テストした言語である英語です。これらのページの説明と案内文は翻訳されています。
prompt.md
You are a senior software engineer reviewing a pull request.
## Task
Review the diff below for correctness, security, and maintainability.
## Requirements
- Report only issues you can point to in the diff.
- Rank each finding as blocker, major, or minor.
- Suggest a concrete fix for every blocker.
## Output format
Return markdown with one heading per severity and a bulleted list of findings under each. Include the file path and line for every finding.
## Input
<diff>
{{diff}}
</diff>変数
| 変数 | 渡す内容 |
|---|---|
{{diff}} | 変更の unified diff。git diff またはコードホストが出力するもの。 |
各変数は専用のタグの中に入っているため、モデルは挿入した内容を指示ではなくデータとして扱います。
スコア
警告も重大な問題もなく 100/100。変更のたびに CI で検査しています。
| 評価軸 | スコア |
|---|---|
| 明確さ | 100 |
| 具体性 | 100 |
| 網羅性 | 100 |
| 構造 | 対象外 |
| 一貫性 | 100 |
| 出力の指定 | 100 |
| 効率 | 100 |
| セキュリティ | 100 |
モデル別のトークンとコスト
変数を埋める前の、テンプレート自体の入力トークンです。コストはモデルカタログの定価（それぞれ最終確認日付き）に基づいています。ご利用のプロバイダーで確認してください。
| モデル | トークン | 1,000 回呼び出しあたりの入力コスト |
|---|---|---|
| GPT-4.1 | 106 | $0.2120 |
| GPT-4.1 mini | 106 | $0.0424 |
| Claude Sonnet 5.5 | 106 （概算） | $0.2120 |
| Claude Haiku 4.5 | 106 （概算） | $0.1060 |
| Gemini 2.5 Flash | 106 （概算） | $0.0318 |
調整のしかた
- 自社の基準を示す要件を追加します。例：「文字列連結で組み立てた SQL をすべて指摘する」。
- 重大度のスケールをチームのもの（例：P0〜P3）に変更し、要件と出力形式の両方で同じものを使います。
- 大きな diff では、テンプレートをファイルごとに 1 回実行し、結果を統合できるよう出力形式は変えないでください。
編集後は、ワークスペースが入力に合わせてプロンプトを再採点し、悪化した点を指摘します。
その他のテンプレート
- カスタマーサポートの返信: 固定された構成で、ポリシーに沿ったチケット返信を作成します。
- 構造化データの抽出: 自由形式のテキストから、厳密な JSON オブジェクトへフィールドを抽出します。
- 会議の要約: 文字起こしから、決定事項、担当者、期限を抽出します。
- チケットの分類: メッセージを確信度付きで、ちょうど 1 つのカテゴリに振り分けます。
- ツールを使うエージェントのシステムプロンプト: ツールのルールと停止条件が明示された、範囲を限定したエージェント。