Communityライティング&編集github.com

DerrickZeng33/find-files-with-everything

Everything CLIを使用した高速Windowsファイル検索(Codex、Claude Code、および互換性のあるAIエージェント向け)

find-files-with-everything とは?

このスキルは、Windows用の高速ファイル検索ツール「Everything」のコマンドラインインターフェース`es.exe`を活用して、AIエージェントがファイルを効率的に発見できるようにします。既存のEverythingインデックスを読み取り専用で使用するため、検索が高速でシステム負荷も最小限に抑えられます。Codex、Claude Code、Cursorなどの主要なAIエージェントプラットフォームで動作し、ワークスペース外やコンピューター全体のファイル、インデックスされたメタデータに基づく検索に最適です。このスキルは、検索のルーティング(既知のパス、ワークスペース内、Everything優先)、効率的なクエリ実行(存在確認の最適化、結果の絞り込み、適切なオプションの選択)、結果の適切な報告(最小限のパス出力、ゼロ結果の解釈)という3段階のワークフローを提供し、ツール呼び出しと返却テキストを最小化するよう設計されています。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add DerrickZeng33/find-files-with-everything

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Everythingでファイルを検索

es.exeを実行中のEverythingインデックスに対する読み取り専用クライアントとして使用します。ツール呼び出しと返却テキストを最小化します。

検索のルーティング

  1. 正確な既知のパスにはTest-PathまたはGet-Itemを使用します。
  2. 既知のワークスペース内のファイル名にはrg --files、既知のツリー内のコンテンツにはrgを使用します。
  3. 位置が不明な場合、ワークスペース外の場合、コンピューター全体の場合、またはインデックスされたメタデータに基づく場合は、最初にEverythingを使用します。

効率的なクエリを実行する

  1. 可用性の確認はセッションごとに最大1回、またはクエリが失敗した後にのみ行います:

    Get-Command es.exe -ErrorAction SilentlyContinue
    

    それ以外の場合は、直接検索を実行します。ESが見つからない場合、またはIPCエラー8が発生した場合は、範囲を狭めたフォールバックを使用します。ユーザーが依頼しない限り、ソフトウェアのインストール、起動、または修復は行わないでください。

  2. 出力を増やす前にクエリを絞り込みます:

    es.exe -n 20 "report"
    es.exe -path "C:\Work" /a-d -n 20 "ext:xlsx"
    es.exe -size -dm -n 20 "size:>1gb"
    

    フォルダには/ad、ファイルには/a-d、サブツリーには-path、そしてext:、size:、dm:、dc:などのEverything検索用語を使用します。スペースを含むパスと用語は引用符で囲みます。

  3. PowerShell 7以降から呼び出す場合は、最初に-argvを指定します。Windows PowerShell 5.1およびその他のシェルでは省略します。

  4. デフォルトではプレーンなパスを返します。構造化されたメタデータが必要な場合のみ-jsonと追加の列を使用します。カウントが重要な場合、または上限付きクエリを絞り込む必要がある場合のみ-get-result-countを使用します。

  5. デフォルトの上限は20に維持します。上限に達した場合は、より多くの結果を要求する前にクエリを絞り込みます。依頼がない限り、結果をファイルにエクスポートしないでください。

結果を報告する

  • 必要最小限の正確なパスセットを返し、省略された一致を要約します。
  • 結果が見つからない場合は、クエリまたはスコープを明記します。
  • ゼロ結果の検索は、現在のEverythingインデックスに関する証拠として扱い、インデックス化されていない場所が空であることの証明としては扱いません。
  • 既知のプロジェクトツリーに対してcontent:を避けてください。デフォルトではインデックス化されておらず、通常はrgよりも効率が悪いです。

検索は読み取り専用に保つ

-exit、-reindex、-save-db、実行カウント設定、保存設定の変更など、ESの状態を変更するオプションは使用しないでください。ユーザーが個別に要求しない限り、結果の削除、移動、コピー、または開封は行わないでください。

関連スキル