スクリプトによるドキュメント発見
概要
スクリプトファーストのドキュメント発見を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 > .claude/skills/docs-seeker/.env > .claude/skills/.env > .claude/.env
設定オプションについては.env.exampleを参照してください。