スクリプトによるドキュメント発見
概要
スクリプトファーストで、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 を参照してください。