promptbyprompt/agent-briefs

サブエージェントに作業を委譲する前に、1ページのブリーフを作成します。エージェントツール、ワークフロー、バックグラウンドジョブ、または複数ステップにわたる長時間タスクを開始する際に使用します。大規模な構築を段階的に計画するときにも役立ちます。ブリーフには、エージェントが最初に読むべきファイル、目標、依頼者自身の言葉、測定可能な完了条件、機械的ルールとハードルール、時間予算、テスト予算、停止ルール、優先順位、交換可能な成果物、進捗ファイル、固定された返却形式が含まれます。また、ステージ計画、書き込みアクセス権のない批評家、対象を絞ったテストポリシー、品質作業の前にリファレンスと照らし合わせた測定もカバーします。

agent-briefs とは?

このスキルは、Claude CodeやCursor、CodexなどのAIエージェントに複雑なタスクを委譲する際に、ブリーフ(簡潔な指示書)を体系的に作成するためのテンプレートとルールセットです。サブエージェントは空のメモリから開始するため、人間が明確なコンテキストを与える必要があります。本スキルは、目標、ファイル参照、完了基準、時間・テスト予算、優先順位、成果物リスト、進捗ファイル、返却形式など、ブリーフのすべての必須項目を定義し、エージェントが迷わず作業を完了できるようにします。特に大規模なタスクはプランナーエージェントで複数のステージに分割し、各ステージに個別のブリーフを作成します。また、品質が重要な作業(音楽、サウンド、ビジュアル、文体など)では、最初にリファレンスを収集・測定し、プロトタイプを依頼者が確認してから本作業に入るプロセスを推奨します。さらに、長時間動作するエージェントにはウォッチドッグ(タイムアウト監視)を並行実行し、予算超過時に自動通知・停止・延長の判断を行えるようにします。批評家(critic)テンプレートを使った並行レビューや、対象を絞ったテストポリシー、以前の失敗をルールとして引き継ぐ仕組みも含まれており、人間がエージェントと協業する際の生産性と信頼性を大幅に向上させます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/promptbyprompt/claude-brief-kit/tree/HEAD/agent-briefs

Installed? Explore more 生産性&コラボレーション skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

エージェントブリーフ

サブエージェントは空のメモリから開始します。あなたが書いたことだけを知っています。サブエージェント、ワークフロー、または長時間タスクを開始する前に、このスキルのフォルダにある templates/brief.md を使ってブリーフを作成してください。

手順

  1. 複数の部分からなる大きなタスク:まず、templates/planner.md を使ったプランニングエージェントを実行します。これにより、各ステージに測定可能な done_when を持つ5〜8のステージが返されます。その後、各ステージごとに個別のブリーフを作成します。
  2. 品質作業(音楽、サウンド、ビジュアル、文体):最初に templates/reference.md に従います。2〜3のリファレンスを収集し、それらを測定し、ギャップを書き、1つの作品をプロトタイプし、残りの作業の前に依頼者に判断してもらいます。
  3. templates/brief.md のすべての見出しを使ってブリーフを作成します。該当しない見出しの下には「なし」と記入します。何かを構築または変更するすべてのブリーフに templates/test-policy.md を貼り付けます。
  4. ビルドステップの後、同じ記録されたマテリアルに対して、templates/critic.md から2〜3人の批評家を並行してレビューに起用します。マージされた must_fix リストを1人の修正エージェントに渡します。
  5. 約15分以上実行されるすべてのエージェントの横にウォッチドッグを起動します(下記参照)。
  6. 開始した内容、予算、および正直な見積もりをユーザーに伝えます。不確実な点についても伝えます。

すべてのブリーフのルール

  • 最初に読む:長いコンテキストを貼り付ける代わりに、ファイルやセクションをポイントします。
  • 依頼者の言葉を引用します(必要に応じて翻訳)。これにより、エージェントは実際に何が求められたかを認識できます。
  • 依頼者が不在の場合は、その旨を明記します:「依頼者は回答できません。自分で判断し、すべての決定を記録してください。」
  • 完了条件は、スクリプト、テスト、または測定によってチェック可能でなければなりません。数値と範囲を使用します。
  • エージェントは人間のように見たり聞いたりできません。測定(スクリーンショット、フレーム数、ラウドネス、ピーク)を行わせ、誰も見たり聞いたりしていないことをレポートに明記し、味覚については依頼者に委ねます。
  • すべてのブリーフには、時間予算、テスト予算、および停止ルールがあります:「時間を使い切ったら、停止し、残っていることを書き留めて返却する。」長時間タスクにはチェックポイントも含めます(「2時間時点でXが開始されていない場合は、Yにフォールバックする」)。
  • 制限なしに「すべての以前のテストを再実行」または「すべてを動かし続ける」と決して書かないでください。新しい部分はその場所でテストします。カバー範囲を変更した場合にのみ、古いテストを再実行します。
  • 時間切れの場合に備えて、最も重要なものから優先順位をリストアップし、残りがどうなるかを明記します。
  • 成果物は、置き換えるものと同じ名前、形式、長さを維持します。これにより、次のステップでそれらを交換できます。
  • 進捗ファイルには、完了したピースごとにタイムスタンプ付きの行を1行追加します。これにより、中断後も作業が復元可能になります。
  • ハードルールはその理由を明記します(「Xを保存しないでください:保存するとその参照が消去されます」)。
  • 以前の失敗をルールとして引き継ぎます(「以前のクリップが黒く表示された:Mainプロファイルとyuv420pを使用する」)。
  • リスクのあるサイドクエストには時間制限を設けます:「最大15分を費やし、その後Yにフォールバックする」。
  • 並行エージェントにはスコープフェンスを設定します:「ステップ3はあなたの仕事ではありません:AまたはBに触れないでください。」
  • 固定された返却形式を要求します:完了したこと、スキップされた理由とその内容、測定値、テスト時間、使用時間、残りの見積もり、ファイルの場所。

ウォッチドッグ

各長時間エージェントの横で、時間予算を待ってから1行を出力するバックグラウンドコマンドを起動します:

sleep 5400; echo "予算超過:ステージ3(90分)"

バックグラウンドで実行します(Claude Codeは終了時に通知します)。発火した場合:エージェントの進捗ファイルを読み、エージェントに終了して戻るように指示するか、停止するか、予算を1回延長してユーザーに通知します。エージェントが早期に戻った場合は、ウォッチドッグを停止します。

関連スキル