バッチリファクタリングのオーケストレーション

概要

このスキルを使用して、大規模なリファクタリングを安全に実行します。 並列でスコープを分析し、単一の計画を統合し、サブエージェントで独立した作業パケットを実行します。

入力

• リポジトリパスとターゲットスコープ(パス、モジュール、または機能領域)
• 目標タイプ: リファクタリング、リライト、またはハイブリッド
• 制約: 動作の互換性、API安定性、期限、テスト要件

並列化をいつ使用するか

• このスキルは多数のファイルまたはサブシステムに影響する中程度～大規模なスコープに使用してください。
• 小規模な編集または高度に結合された単一ファイルの作業では、マルチエージェント実行をスキップしてください。

コアワークフロー

1. スコープと成功基準を定義します。
   • ターゲットパス/モジュールと非目標をリストアップします。
   • 動作の制約を明記します(例: 外部の動作を保持する)。
2. 最初に並列分析を実行します。
   • ターゲットスコープを分析レーンに分割します。
   • explorer サブエージェントを並列で生成して各レーンを分析します。
   • 各エージェントに意図マップ、結合リスク、候補作業パケット、必要な検証を要求します。
3. 1つの依存関係を考慮した計画を構築します。
   • エクスプローラの出力を単一の作業グラフにマージします。
   • ファイルの所有権が明確な作業パケットと検証コマンドを作成します。
   • パケットを依存レベルで順序付けし、独立したパケットのみを並列で実行します。
4. ワーカーエージェントで実行します。
   • 独立したパケットごとに1つの worker を生成します。
   • 明示的な所有権(ファイル/責任)を割り当てます。
   • すべてのワーカーに、彼らがコードベース内で単独ではなく、関連のない編集を無視する必要があることを指示します。
5. 統合および検証します。
   • パケット出力をレビューし、重複を解決し、検証ゲートを実行します。
   • パケットごとにターゲットテストを実行し、次に統合スコープのためのより広いスイートを実行します。
6. レポートと終了します。
   • パケット結果、主要なリファクタリング、解決された競合、および残存するリスクを要約します。

作業パケットのルール

• 実行波ごと、ファイルごとに1人の所有者。
• 重複するファイルセットでの並列編集なし。
• パケットの目標を絞込み、測定可能に保つ。
• 明示的な完了基準と必要なチェックを含めてください。
• ユーザーが動作変更を明示的に要求しない限り、動作を保持するリファクタリングを優先します。

計画契約

すべてのパケットには以下を含める必要があります:

1. パケットIDと目標。
2. 所有ファイル。
3. 依存関係(なし、またはパケットID)。
4. リスクと保持する不変量。
5. 必要なチェック。
6. メインスレッドへの統合メモ。

正確な形式についてはreferences/work-packet-template.mdを使用してください。

エージェントプロンプト契約

• references/agent-prompt-templates.mdのプロンプトテンプレートを使用してください。
• エクスプローラプロンプトは分析と分解に焦点を当てています。
• ワーカープロンプトは、厳密な所有権の境界を持つ実装と検証に焦点を当てています。

安全ガードレール

• 計画の統合が完了する前にワーカー実行を開始しないでください。
• 未解決の依存関係全体で並列化しないでください。
• 必要なパケットチェックが失敗した場合、完了を主張しないでください。
• パケットの境界が繰り返されたマージ競合を引き起こす場合は、停止して再計画してください。

検証戦略

この順序で実行してください:

1. パケットレベルのチェック(高速でスコープ限定)。
2. クロスパケット統合チェック。
3. スコープが広い場合の完全なプロジェクト安全性チェック。

高速なフィードバックループを優先しますが、必要な動作チェックをスキップしないでください。