スクリプトによるドキュメント検索
概要
スクリプト優先のドキュメント検索を、llms.txt標準に基づいて行います。
スクリプトを実行してワークフロー全体を処理します。手動でURLを構築する必要はありません。
基本ワークフロー
常に次の順序でスクリプトを実行してください:
# 1. クエリタイプを検出(トピック固有か一般か)
node scripts/detect-topic.js "<ユーザークエリ>"
# 2. スクリプトの出力を使ってドキュメントを取得
node scripts/fetch-docs.js "<ユーザークエリ>"
# 3. 結果を分析(複数URLが返された場合)
cat llms.txt | node scripts/analyze-llms-txt.js -
スクリプトはURLの構築、フォールバックチェーン、エラー処理を自動的に行います。
スクリプト
detect-topic.js - クエリタイプを分類
- トピック固有クエリと一般クエリを識別
- ライブラリ名 + トピックキーワードを抽出
- JSONを返す:
{topic, library, isTopicSpecific} - ゼロトークン実行
fetch-docs.js - ドキュメントを取得
- context7.comのURLを自動構築
- フォールバック処理: トピック → 一般 → エラー
- llms.txtの内容またはエラーメッセージを出力
- ゼロトークン実行
analyze-llms-txt.js - llms.txtを処理
- URLを分類(重要/普通/補足)
- エージェントの分散を推奨(1エージェント、3エージェント、7エージェント、段階的)
- 戦略を含むJSONを返す
- ゼロトークン実行
ワークフロー参照
トピック固有検索 - 最速のパス(10〜15秒)
一般ライブラリ検索 - 包括的なカバレッジ(30〜60秒)
リポジトリ分析 - フォールバック戦略
参考資料
context7-patterns.md - URLパターン、既知のリポジトリ
errors.md - エラー処理、フォールバック戦略
advanced.md - エッジケース、バージョン管理、多言語対応
実行原則
- スクリプト優先 - 手動でURLを構築する代わりにスクリプトを実行
- ゼロトークンオーバーヘッド - スクリプトはコンテキストを読み込まずに実行
- 自動フォールバック - スクリプトがトピック→一般→エラーのチェーンを処理
- 段階的な開示 - ワークフロー/参照は必要なときだけ読み込む
- エージェント分散 - スクリプトが並列エージェント戦略を推奨
クイックスタート
トピッククエリ: 「shadcnでdate pickerを使うには?」
node scripts/detect-topic.js "<クエリ>" # → {topic, library, isTopicSpecific}
node scripts/fetch-docs.js "<クエリ>" # → 2〜3つのURL
# WebFetchでURLを読み込む
一般クエリ: 「Next.jsのドキュメント」
node scripts/detect-topic.js "<クエリ>" # → {isTopicSpecific: false}
node scripts/fetch-docs.js "<クエリ>" # → 8つ以上のURL
cat llms.txt | node scripts/analyze-llms-txt.js - # → {totalUrls, distribution}
# 推奨に従ってエージェントを配置
環境
スクリプトは.envを読み込みます: process.env > .opencode/skills/docs-seeker/.env > .opencode/skills/.env > .opencode/.env
設定オプションについては.env.exampleを参照してください。