07. Agentを使いこなすコツ (4/5)

用途に応じたファイル分割の具体例
※ 必要な時に必要なファイルだけを読み込ませることで、トークン消費量を抑え、
応答の安定性や効率の改善にも繋がります。

prompts
呼び出せる依頼文テンプレート
よく使う依頼文を呼び出すためのファイルです。
例えば .github/prompts に review.prompt.md を置くと、
/review で呼び出せるようになります。
具体例
  • レビュー依頼を毎回同じ観点で実行する
  • 長い依頼文を毎回入力しないようにする
*.instructions / references
覚えさせるルール
共通ルール以外に拡張子やパスに対応した目的別ルール、拡張子やパスでは決められない運用ルールを共通ルールと分けることが出来ます。
具体例
  • API仕様書・DB定義書
  • 詳細なコーディング規約
skills
守らせる手順
「どう埋めるか」「どういう観点で書くか」といった、作業手順やプロセスを守らせるための指示書です。
具体例
  • 設計書・テスト仕様書の作成ルール
  • デプロイ・テストの実行手順
template
出力の型
設計書やテスト仕様書などの「実際のフォーマット」を定義し、出力形式を統一します。
具体例
  • 設計書・仕様書のフォーマット
  • ロードマップの出力形式
全てを最初から整える必要はありません。作業を進めるなかですこしづつ育てていきましょう。