Smokefarmer/multi-agent-delivery-skill

マルチエージェントデリバリー

概要

このスキルは、タスクが構造化された計画、並行実装、明示的なレビュー、そして完了報告前の実際の検証を必要とするほど大規模な場合に使用します。

委任のオーバーヘッドがタスク自体よりも大きくなるような、小さな単一ファイル編集には使用しないでください。

ワークフロー

1. 変更前に調査する

• 編集を提案する前に、関連するコードパスを読んでください。
• クリティカルパス上の直近のブロッカーを特定してください。
• ブロックしている作業と、並行して実行できるサイドカー作業を区別してください。

2. 簡潔な実行計画を書く

• 重要なタスクについては、実質的な編集の前に簡潔な計画を作成してください。
• 常に1つのステップだけを進行中にしてください。
• スコープが変更されたとき、または分析から実装、検証へと移行するときに計画を更新してください。

3. 作業を重複のないスライスに分割する

• メインスレッドは統合、競合解決、最終検証を担当し続けてください。
• エクスプローラーは、範囲が限定されたコードベースの質問やホットスポットの発見に使用してください。
• ワーカーは、明示的なファイル所有権を持つ具体的な実装スライスに使用してください。
• 各ワーカーに重複のない書き込みスコープを与え、無関係なダーティなワークツリーの変更を元に戻さないように指示してください。
• 次のアクションが即座にそれに依存する場合、緊急のクリティカルパス作業はローカルに留めてください。

4. 明確な所有権を持って委任する

すべてのワーカープロンプトには以下を含める必要があります：

• それが所有する正確なファイルまたはモジュール
• 期待される具体的な成果
• 他のエージェントもリポジトリを編集しているという警告
• 所有範囲外のファイルに触れないようにする指示
• 対象を絞った検証と変更ファイルのサマリーの要求

5. 実装後にレビューする

• コード変更後、統合結果に対して少なくとも1回のレビューパスを実行してください。
• 認証、入力処理、RPC、支払い、トランザクション関連の作業には、セキュリティに焦点を当てたレビューを追加してください。
• スマートコントラクトの変更には、Rust/Anchorレビューを追加してください。
• 重大度の高いレビュー所見は、完了報告前に修正してください。

6. 完了宣言の前に検証する

影響を受けるレイヤーに対して、最も実用的な強力な検証を実行してください：

• 型チェック
• Lint
• テスト
• 該当する場合はコントラクトのビルド/テスト

広範なクリーンアップキャンペーンの場合は、最初にスライスごとに対象を絞った検証を実行し、その後、影響を受けるレイヤーに対してリポジトリ全体のパスを実行してください。

必要な検証がまだ失敗している間は、「完了」と報告しないでください。

7. 結果を明確に報告する

最終報告書には以下を含める必要があります：

• 高レベルで何が変更されたか
• どの検証が合格したか（可能であれば件数も）
• どのような負債や残存リスクが残っているか
• 実行されなかったもの（もしあれば）

委任ルール

• 並行エージェントは、それらの書き込みスコープが重複しない場合にのみ優先してください。
• メインスレッドとワーカーの間で作業を重複させないでください。
• wait_agent は控えめに使用し、エージェントの実行中は有用なローカル作業を続けてください。
• 不要になったエージェントはクローズしてください。

推奨パターン

典型的な重要なタスクの場合：

1. 調査し、簡潔な計画を書く。
2. ホットスポット分析が必要な場合は、1つのエクスプローラーを起動する。
3. 重複のないスライスに対して1〜3のワーカーを起動する。
4. ワーカーの実行中にローカル統合作業を続ける。
5. 結果を統合し、競合をローカルで解決する。
6. レビューパスを実行する。
7. 完全な検証を実行する。
8. 結果と残存負債を報告する。