ローカルコード検索
インストールと注意点
ツールがない場合、このスキルを別のマシンにインストールする場合、アクセラレーションを確認する場合、またはアップデートする場合は、セットアップとトラブルシューティングを読んでください。通常のコードタスクでこのスキルが呼び出されたからといって、ツールをインストールしたり再設定したりしないでください。オプションのポータブルな cgrep ヘルパー は検索フラグを提供します。プラットフォーム固有の設定とその制限についてはセットアップに記載されています。
オリエンテーションから始める
コーディングセッションの開始時、およびリファクタリングや複雑なコードの質問を調査する前に、リポジトリの説明や関連するプロジェクトガイダンスを読み、広範囲のソース読み取りや実装計画の前に、最初のコードナビゲーションとしてスコープ指定されたアウトラインを使用してください。アウトラインブルガイドを読んでください。
関連する最小のパッケージ、ディレクトリ、またはファイルを選択してください。デフォルトでモノレポ全体をアウトライン化しないでください。エリアが不明な場合は、ファイル名または焦点を絞ったColGREPクエリを使用して候補を見つけ、それらをアウトライン化してください。このセッションですでに最新のアウトラインがある場合はそれを再利用し、構造的な編集後は影響を受けるファイルを更新してください。単純な正確な検索、既に理解しているコードの小さな変更、およびコード以外のチャットは直接進めて構いません。これはバックグラウンドプロセスや毎ターンのスキャンではなく、作業習慣です。
次のツールを選択する
ターゲットについて既に知っていることから選択し、関連するサブガイドのみを読んでください。これらのガイドはこのスキルに属するものであり、別個のスキル登録ではありません。
| ニーズ | ツール | サブガイド |
|---|---|---|
| セッションの方向付け、リファクタリング範囲、または複雑なコードの調査 | ast-grep outline | 最初にアウトライン |
| 正確な文字列、エラーメッセージ、ファイル名、または単純な識別子の出現 | rg | 正確な検索 |
| 振る舞いの説明から実装を見つける | ColGREP / cgrep | 意味の発見 |
| コード構造内の構文、関係、繰り返し可能な構文ベースの変更 | ast-grep | 構造検索 |
関連するエリアがわかっている場合は、狭いファイルまたはディレクトリスコープから始めてください。ColGREPで候補を発見し、rgで既知のシンボルを検査し、ast-grepで構文パターンを洗練するのは正常です。3つすべてを自動的に実行しないでください。ファイルの読み取り/編集、テスト、git操作にはネイティブのエージェントツールを使用してください。
検索結果は候補を見つけるものです。振る舞いに関する主張をする前に関連するソースを検査してください。構文マッチを型解決された参照として扱わないでください。
1つの標準的なインストールがCodexとClaude Codeの両方にサービスを提供します。ツールガイダンスはここで維持してください。スタンドアロンのツールスキルを再インストールしたり、重複する検索フックを有効にしたりしないでください。