Jeffrey Emanuel（@doodlestein）のスレッド

実は、最初に出てきたものも気に入っているので、両方とも AGENTS dot md に含めるつもりです。 --- ### Morph Warp Grep — AIを活用したコード検索 **「X はどのように動作するのか」という探索的な質問には `mcp__morph-mcp__warp_grep` を使用します。** AI 検索エージェントがクエリを複数の検索パターンに自動的に拡張し、コードベースを grep し、関連ファイルを読み取り、完全なコンテキストを含む正確な行範囲を返します。これらはすべて 1 回の呼び出しで実行されます。 **対象を絞った検索には `ripgrep` (Grep ツール経由) を使用します。** 探しているもの (特定の関数名、エラー メッセージ、構成キーなど) が正確にわかっている場合は、ripgrep の方が高速かつ直接的です。 **構造コード パターンには `ast-grep` を使用します。** コメントや文字列を無視しながら AST ノードを一致/書き換える必要がある場合、またはコードベース全体のルールを適用する必要がある場合。 **何をいつ使うか** | シナリオ | ツール | 理由 | |----------|------|-----| | 「認証はどのように実装されていますか?」 | `warp_grep` | 探索的; どこから始めればよいかわかりません | | 「L3 ガーディアン アピール システムはどこにありますか?」 | `warp_grep` | アーキテクチャを理解し、複数の関連ファイルを見つける必要があります | | 「`useQuery(` のすべての使用箇所を検索」 | `ripgrep` | 対象を絞ったリテラル検索 | | 「`console.log` でファイルを検索する」| `ripgrep` | 単純なパターン、既知のターゲット | | 「`getUserById` を `fetchUser` に名前変更」| `ast-grep` | 構造的なリファクタリング、コメント/文字列の回避 | | 「すべての `var` を `let` に置き換えます」| `ast-grep` | コードベース全体の Codemod | **warp_grep の強み** * **コンテキスト汚染を軽減**: ファイル全体ではなく、関連する行範囲のみを返します。 * **インテリジェントな拡張**: 「appeals system」を「appeal」、「Appeals」、「guardian」、「L3」などの検索に変換します。 * **ワンショット回答**: 手動の grep → 読み取りサイクルではなく、正確な場所で最も関連性の高い 3 ～ 5 個のファイルを検索します。 * **自然言語**:「どのように」、「どこで」、「何を」などの質問に適しています。 **warp_grep の使い方** 「」 mcp__morph-mcp__warp_grep( リポジトリパス: "/data/projects/communitai", 質問: 「L3 Guardian の異議申し立てシステムはどのように実装されていますか?」 ） 「」 ファイル パス、行範囲、抽出されたコード スニペットを含む構造化された結果を返します。 **経験則** * **どこを探せばいいかわからない** → `warp_grep` (AIに見つけさせる) * **パターンを知る** → `ripgrep` (最速) * **AST 精度が必要** → `ast-grep` (書き換えに最も安全) **アンチパターン** * ❌ `warp_grep` を使用して、すでにわかっている特定の関数名を検索する → `ripgrep` を使用する * ❌ `ripgrep` を使って「X がどのように動作するか」を理解する → 手動でのファイル読み取りで時間を無駄にする * ❌ codemods に `ripgrep` を使用する → コメントや文字列が抜け落ち、付随的な編集のリスクがある