jww-bounded-investigation

調査の範囲を限定する

広範な調査を委任し、結論を検証するために必要な証拠を記録して、複数ファイルにまたがる調査の範囲を限定します。対象を絞った読み取りや限定的なコマンドは前提としており、このスキルで追加するものではありません。

使用するタイミング

関連するコードがまだ特定されておらず、調査を行う場合に使用します。たとえば、次のような場合です。

• 所有するファイルが明らかでないスタックトレースやエラー
• 挙動を示す名前はあるものの、ソースが示されていない「Xが起きるのはなぜか」という質問
• 多数のファイルにまたがる監査やコードの経緯調査

関連ファイルが特定できたら使用を終了してください。既知のコードへの通常の編集にも使用しないでください。

検索を分担して並行実行する

実行環境に読み取り専用の検索エージェントが用意されており、委任が許可され、次の両方の条件を満たす場合は、検索の一斉実行を委任します。

• 場所が特定されていない場合 — 候補となるファイルが多数ある、名前が不確かである、またはリポジトリ全体を対象にコード検索する必要がある
• 必要なのが結論であり、周辺のコードではない場合

対象を十分に絞り込めていて出力が少なくなる場合や、対象を見つけることより周辺のコードを判断することのほうが重要な場合は、自分で検索します。統合と検証はプライマリエージェントが行います。委任先の結論に依拠する前に、引用されたソースを確認してください。

証拠台帳をつける

セッション中の作業メモまたは一時ファイルに台帳を記録します。これはコミットしません。各所見について、ソース、観察内容、そして何を裏付けるか、または否定するかを1行で記録します。

src/Session/Store.swift:88 — writes cache off the main actor — explains the
crash, rules out the decoder path

否定された分岐と、確認したものの何も追加されなかったソースも記録します。これらを残さないと、同じ調査中に同じファイルを再び読むことになります。

この台帳は引き継ぎの元資料になります。各行が jww-handoff の Decisions セクションと Touched セクションになるため、台帳をつけておけば引き継ぎをほぼ手間なく作成できます。

報告

まず結論を述べ、次にそれを裏付ける証拠と、結論を信頼するうえで考慮すべき注意点を示します。検索を再現しなくても推論を再確認できるように、ファイル名と行番号を挙げて引用してください。