エージェントブリーフ
サブエージェントは空のメモリから開始します。あなたが書いたことだけを知っています。サブエージェント、ワークフロー、または長時間タスクを開始する前に、このスキルのフォルダにある templates/brief.md を使ってブリーフを作成してください。
手順
- 複数の部分からなる大きなタスク:まず、
templates/planner.mdを使ったプランニングエージェントを実行します。これにより、各ステージに測定可能なdone_whenを持つ5〜8のステージが返されます。その後、各ステージごとに個別のブリーフを作成します。 - 品質作業(音楽、サウンド、ビジュアル、文体):最初に
templates/reference.mdに従います。2〜3のリファレンスを収集し、それらを測定し、ギャップを書き、1つの作品をプロトタイプし、残りの作業の前に依頼者に判断してもらいます。 templates/brief.mdのすべての見出しを使ってブリーフを作成します。該当しない見出しの下には「なし」と記入します。何かを構築または変更するすべてのブリーフにtemplates/test-policy.mdを貼り付けます。- ビルドステップの後、同じ記録されたマテリアルに対して、
templates/critic.mdから2〜3人の批評家を並行してレビューに起用します。マージされたmust_fixリストを1人の修正エージェントに渡します。 - 約15分以上実行されるすべてのエージェントの横にウォッチドッグを起動します(下記参照)。
- 開始した内容、予算、および正直な見積もりをユーザーに伝えます。不確実な点についても伝えます。
すべてのブリーフのルール
- 最初に読む:長いコンテキストを貼り付ける代わりに、ファイルやセクションをポイントします。
- 依頼者の言葉を引用します(必要に応じて翻訳)。これにより、エージェントは実際に何が求められたかを認識できます。
- 依頼者が不在の場合は、その旨を明記します:「依頼者は回答できません。自分で判断し、すべての決定を記録してください。」
- 完了条件は、スクリプト、テスト、または測定によってチェック可能でなければなりません。数値と範囲を使用します。
- エージェントは人間のように見たり聞いたりできません。測定(スクリーンショット、フレーム数、ラウドネス、ピーク)を行わせ、誰も見たり聞いたりしていないことをレポートに明記し、味覚については依頼者に委ねます。
- すべてのブリーフには、時間予算、テスト予算、および停止ルールがあります:「時間を使い切ったら、停止し、残っていることを書き留めて返却する。」長時間タスクにはチェックポイントも含めます(「2時間時点でXが開始されていない場合は、Yにフォールバックする」)。
- 制限なしに「すべての以前のテストを再実行」または「すべてを動かし続ける」と決して書かないでください。新しい部分はその場所でテストします。カバー範囲を変更した場合にのみ、古いテストを再実行します。
- 時間切れの場合に備えて、最も重要なものから優先順位をリストアップし、残りがどうなるかを明記します。
- 成果物は、置き換えるものと同じ名前、形式、長さを維持します。これにより、次のステップでそれらを交換できます。
- 進捗ファイルには、完了したピースごとにタイムスタンプ付きの行を1行追加します。これにより、中断後も作業が復元可能になります。
- ハードルールはその理由を明記します(「Xを保存しないでください:保存するとその参照が消去されます」)。
- 以前の失敗をルールとして引き継ぎます(「以前のクリップが黒く表示された:Mainプロファイルとyuv420pを使用する」)。
- リスクのあるサイドクエストには時間制限を設けます:「最大15分を費やし、その後Yにフォールバックする」。
- 並行エージェントにはスコープフェンスを設定します:「ステップ3はあなたの仕事ではありません:AまたはBに触れないでください。」
- 固定された返却形式を要求します:完了したこと、スキップされた理由とその内容、測定値、テスト時間、使用時間、残りの見積もり、ファイルの場所。
ウォッチドッグ
各長時間エージェントの横で、時間予算を待ってから1行を出力するバックグラウンドコマンドを起動します:
sleep 5400; echo "予算超過:ステージ3(90分)"
バックグラウンドで実行します(Claude Codeは終了時に通知します)。発火した場合:エージェントの進捗ファイルを読み、エージェントに終了して戻るように指示するか、停止するか、予算を1回延長してユーザーに通知します。エージェントが早期に戻った場合は、ウォッチドッグを停止します。