sourcebot

Sourcebot ガイド

外部ライブラリ、フレームワーク、コードパターンを検索するために Sourcebot MCP を使用する際の専門的なガイダンスです。

使用する場面

• 外部ライブラリの調査： Effect-TS、TanStack、Vercel AI SDK などのコードパターンを探す
• API の調査： 外部ライブラリが特定の機能をどのように実装しているかを理解する
• ドキュメントの例： 公式リポジトリから実際の使用例を探す
• フレームワークのパターン： 外部フレームワークのコードベースからベストプラクティスを学ぶ
• 移行ガイダンス： 外部ライブラリのアップグレードパターンや破壊的変更を探す

使用しない場面

• ローカルプロジェクトのコード： 代わりに codebase_search または osgrep search を使用する
• ローカルコンポーネント： プロジェクトファイルにはローカル検索ツールを使用する
• ローカルユーティリティ： 自分のコードベースに Sourcebot を使用しない

必須のワークフロー

1. 最初に list_repos を呼び出し、 利用可能なリポジトリ ID を取得する
2. 検索に関連するリポジトリ ID を特定する（例：EffectTS の場合は「Effect-TS/effect」）
3. search_code の呼び出し時には必ず filterByRepoIds を指定する
4. 必要に応じて get_file_source を使用し、 特定のファイルの内容を取得する

リポジトリ ID の形式

• 重要： リポジトリ ID は "owner/repo" の形式にする必要があります（例："Effect-TS/effect"、"vercel/ai"）
• github.com/ プレフィックスを含めないでください
• list_repos ツールが "github.com/owner/repo" のような ID を返す場合は、filterByRepoIds で使用する際にプレフィックスを削除してください

使用例

EffectTS のパターンを検索する

{
  "query": "Effect.gen yield",
  "filterByRepoIds": ["Effect-TS/effect"],
  "includeCodeSnippets": true
}

AI SDK を検索する

{
  "query": "streamText tool calling",
  "filterByRepoIds": ["vercel/ai"],
  "includeCodeSnippets": true
}

複数のリポジトリを検索する

{
  "query": "error handling patterns",
  "filterByRepoIds": ["Effect-TS/effect", "vercel/ai"],
  "includeCodeSnippets": true
}

ベストプラクティス

• 説明的なクエリを使用する（キーワードだけでなく、具体的な説明を使う）
• 検索範囲を絞るため、常に filterByRepoIds を指定する
• 実際のコード例が必要な場合は includeCodeSnippets: true を設定する
• 関連ファイルが見つかったら get_file_source を使用して、全体の文脈を確認する

コード検索ツールの優先順位

1. Sourcebot - 外部ライブラリとフレームワーク専用
2. codebase_search（利用可能な場合）- ローカルプロジェクトのコード用
3. osgrep search - codebase_search が利用できない場合のローカルコード用
4. grep/find - 完全一致する文字列を検索する最後の手段

重要な要件

• 必須： 外部ライブラリの調査中に Sourcebot MCP を 5～7 回使用する
• 重要： ローカルプロジェクトのコード検索に Sourcebot を絶対に使用しない
• 重要： すべての search_code 呼び出しで必ず filterByRepoIds を使用する
• タスクの無効化： 外部ライブラリを扱う際に Sourcebot を 5～7 回使用しない場合、タスクは無効になります
• SOURCEBOT の使用後： 外部ライブラリの最新情報を得るため、Perplexity と Context7 も使用する