mcpField
F
file-search

file-search

github.com/netresearch開発42528 回インストール3 日前に更新
リポジトリ

file-search について

File Search Skillは、AIエージェント向けに検索内容に応じたコマンドラインツールの選び方を案内します。テキスト、ファイル名、コード構造、ルール、文書、コード指標を扱い、実行例と外部情報への引き継ぎ方も示します。

主な機能

  1. 01検索内容に応じたCLIツールの選択
  2. 02テキスト・ファイル名・コード構造の検索
  3. 03ルールスキャンと文書アーカイブ検索
  4. 04コード量と複雑度の計測
  5. 05コマンド例と外部検索への引き継ぎ

活用シーン

  1. 01コード内のテキストや構文パターンを検索
  2. 02ファイル名からテストファイルを特定
  3. 03PDF・Office文書・アーカイブを検索
  4. 04プロジェクトのコード量と複雑度を計測

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/netresearch/file-search-skill --skill file-search

インストール後、Claude Code で/file-searchを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

evals/
evals.json
references/
ast-grep-patterns.md
code-metrics.md
enforcement-hook.md
fd-guide.md
remote-handoff.md
rga-guide.md
ripgrep-patterns.md
search-strategies.md
semgrep-patterns.md

詳細

ファイル検索スキル

AI エージェント向けの効率的な CLI 検索ツールです。

ツール選択ガイド

タスク使用するもの代わりに使うもの
コードファイル内のテキスト検索rg (ripgrep)grep、grep -r
ファイル名／パスによるファイル検索fdfind、ls -R
構造／構文を考慮したコード検索sg (ast-grep)正規表現を使った回避策
ルールパック（セキュリティ／lint、taint）の適用semgrep正規表現による CI チェック
PDF、Office 文書、アーカイブの検索rga (ripgrep-all)手動での抽出
言語別のコード行数のカウントtokeicloc、wc -l
複雑度メトリクスを含むコード統計scccloc、tokei

判断フロー： テキスト → rg | 構造 → sg | ルールパック → semgrep | ファイル名 → fd | PDF／アーカイブ → rga | LOC → tokei／scc

クイック例

rg 'def \w+\(' -t py src/          # rg: text search in Python files
rg -c 'TODO' -t js | wc -l         # rg: count first, then drill down
sg --pattern 'console.log($$$)' --rewrite 'logger.info($$$)' --lang js  # sg: structural replace
fd -g '*.test.ts' --changed-within 1d  # fd: -g for compound suffixes (NOT -e)
fd -g '*_test.go' -X rg 'func Test'   # fd+rg: find files, verify contents
rga 'quarterly revenue' docs/       # rga: search inside PDFs/archives
tokei --sort code                   # tokei: language stats
scc --wide                          # scc: complexity + COCOMO

ベストプラクティス

  1. 対象を絞って始めます。 型（-t、--lang、-e）や対象ディレクトリを指定し、まず件数を確認します（rg -c）。
  2. ノイズを除外します（-g '!vendor/'、fd -E node_modules）。
  3. 独立したクエリをまとめて実行します。 パターンを rg -e P1 -e P2 -e P3 でまとめる（1 回の走査）か、1 つのメッセージ内で別々のクエリを並列のツール呼び出しとして実行します。&& で連鎖させて順番に実行することは避けてください。
  4. プログラムで処理する場合は --json を使います。
  5. rg と fd の型指定は異なります。 rg -t ts は .tsx を含みますが、fd -e ts は含みません。rg には -t tsx はありません。

references/search-strategies.md を参照してください。

ローカルファイル以外の検索

ローカル検索で見つからず、コンテキストが issue／PR／外部ドキュメントにある場合は、検索を引き継ぎます（gh、Jira、WebFetch）。コメントにある issue キーが手がかりになります。

references/remote-handoff.md を参照してください。

参考資料

トピックファイル
rg のフラグ、パターン、レシピreferences/ripgrep-patterns.md
言語別の ast-grep パターンreferences/ast-grep-patterns.md
semgrep のルールと taint モードreferences/semgrep-patterns.md
fd のフラグ、使い方、fd と rg の組み合わせreferences/fd-guide.md
rga の形式、使い方、キャッシュreferences/rga-guide.md
tokei と scc の使い方references/code-metrics.md
PreToolUse の注意喚起（プラグインに同梱）references/enforcement-hook.md
検索対象の絞り込み戦略references/search-strategies.md
リモートコンテキストへの引き継ぎガイドreferences/remote-handoff.md
最新 CLI ツールの比較（旧式→最新、全分野）cli-tools SKILL.md#preferred-modern-tools

コメント

Markdown 対応