GrepAI検索のコツ

このスキルは、効果的なセマンティック検索クエリを書くためのコツとベストプラクティスを提供します。

このスキルを使う場面

• 検索結果の品質を向上させる
• セマンティック検索テクニックを学ぶ
• クエリの表現方法を理解する
• 不良な検索結果のトラブルシューティング

セマンティック検索の考え方

テキスト検索とは異なる考え方をしてください：

テキスト検索 (grep)	セマンティック検索 (GrepAI)
正確なテキストを検索	意味や意図を検索
"getUserById"	"IDによってデータベースからユーザーを取得"
リテラルマッチ	概念的なマッチ

クエリ作成の原則

1. 実装ではなく意図を説明する

❌ 良くない: getUserById ✅ 良い: fetch user record from database using ID

❌ 良くない: handleError ✅ 良い: error handling and response to client

❌ 良くない: validateInput ✅ 良い: check if user input is valid and safe

2. 説明的な言葉を使う

❌ 良くない: auth ✅ 良い: user authentication and authorization

❌ 良くない: db ✅ 良い: database connection and queries

❌ 良くない: config ✅ 良い: application configuration loading

3. コンテキストについて具体的に説明する

❌ 良くない: validation ✅ 良い: validate email address format

❌ 良くない: parse ✅ 良い: parse JSON request body

❌ 良くない: send ✅ 良い: send email notification to user

4. 3～7単語を使う

長さ	例	品質
短すぎる	"auth"	⚠️ 曖昧
良い	"user authentication middleware"	✅ 具体的
長すぎる	"the code that handles user authentication and validates JWT tokens in the middleware layer"	⚠️ 冗長

5. 英語を使う

埋め込みモデルは主に英語で学習されています：

❌ authentification utilisateur (フランス語) ✅ user authentication

コードコメントが別の言語で書かれていても、英語のクエリが最適に機能します。

クエリのパターン

動作によるコード検索

grepai search "validate user credentials before login"
grepai search "send notification when order is placed"
grepai search "calculate total price with discounts"
grepai search "retry failed HTTP requests"

目的によるコード検索

grepai search "middleware that checks authentication"
grepai search "function that formats dates"
grepai search "service that sends emails"
grepai search "handler for payment processing"

エラーハンドリングの検索

grepai search "handle errors from API calls"
grepai search "catch and log exceptions"
grepai search "error response to client"
grepai search "validation error messages"

データ操作の検索

grepai search "save user to database"
grepai search "query products by category"
grepai search "cache frequently accessed data"
grepai search "transform data before storage"

設定の検索

grepai search "load configuration from environment"
grepai search "database connection settings"
grepai search "API keys and secrets management"
grepai search "feature flags and toggles"

セキュリティコードの検索

grepai search "password hashing and verification"
grepai search "input sanitization to prevent injection"
grepai search "rate limiting for API endpoints"
grepai search "CORS configuration"

段階的な改善

結果が良くない場合は、段階的に改善してください：

広く始める

grepai search "authentication"
# 結果が多すぎる

コンテキストを追加する

grepai search "JWT authentication"
# より良いが、まだ広い

具体的にする

grepai search "JWT token validation middleware"
# 正確な結果

同義語の使用

セマンティック検索は同義語を理解します。異なる表現を試してください：

# これらは同様の結果を返すかもしれません：
grepai search "user authentication"
grepai search "user login verification"
grepai search "credential validation"
grepai search "identity verification"

ドメイン固有の用語

あなたのドメイン語彙を使用してください：

# Eコマース
grepai search "shopping cart checkout process"
grepai search "inventory stock management"

# 金融
grepai search "transaction processing"
grepai search "payment reconciliation"

# ヘルスケア
grepai search "patient record retrieval"
grepai search "appointment scheduling"

質問形式のクエリ

自然な質問はうまく機能します：

grepai search "how are users authenticated"
grepai search "where is the database connection configured"
grepai search "what happens when a request fails"
grepai search "how are errors logged"

よくある間違いを避ける

❌ 正確な関数名を使わない

関数名が正確にわかっている場合はgrepを使用してください：

grep -r "getUserById" .  # テキスト検索

正確な名前がわからない場合にGrepAIを使用してください：

grepai search "retrieve user from database"  # セマンティック検索

❌ 抽象的すぎないようにする

# 抽象的すぎる
grepai search "business logic"

# より具体的
grepai search "calculate order total with tax"

❌ コード構文を使わない

# これをしないでください
grepai search "function() { return }"

# これをしてください
grepai search "function that returns early"

❌ 過度に詳細化しない

# 過度に詳細化 (無関係な詳細を言及)
grepai search "async function in TypeScript file that uses axios to fetch"

# より良い
grepai search "fetch data from external API"

結果の解釈

高スコア (0.85以上)

強力なマッチです。このコードはあなたが説明したことを実行している可能性が高いです。

中程度のスコア (0.70-0.84)

関連するコード。あなたが求めているものかもしれませんし、隣接する機能かもしれません。

低スコア (0.60-0.69)

疎に関連しています。クエリを改善することを検討してください。

非常に低いスコア (0.60未満)

弱いマッチです。その概念がコードベースに存在しない、またはクエリの改作が必要な可能性があります。

GrepAIが結果を見つけない場合

1. インデックスを確認: grepai status
2. ファイルがインデックスされていることを確認: 無視パターンにはないか？
3. より単純なクエリを試す: 具体性を削除する
4. 別の単語を試す: 同義語を使う
5. コードが存在するかチェック: もしかしてまだ存在していない？

クイックリファレンスカード

状況	クエリスタイル
動作を知っている	"validates email format"
ドメインを知っている	"payment processing flow"
探索中	"how errors are handled"
エントリーポイントを検索	"main application startup"
依存関係を検索	"where database is connected"

出力形式

コツのサマリー：

📝 GrepAI検索のコツ

✅ すべきこと：
- 実装ではなく意図を説明する
- 3～7個の説明的な単語を使う
- 英語のクエリを使う
- 段階的に改善する

❌ すべきではないこと：
- 正確な関数名を使う (grepを使用)
- クエリが短すぎる ("auth")
- クエリが長すぎる
- クエリにコード構文を使う

例の変換：
  "auth"            → "user authentication and login"
  "getUserById"     → "fetch user by ID from database"
  "handleError"     → "error handling and logging"