透過腳本探索文件
概述
腳本優先的文件探索,使用 llms.txt 標準。
執行腳本處理整個工作流程 —— 無需手動建構 URL。
主要工作流程
請務必依序執行腳本:
# 1. 偵測查詢類型(主題特定 vs 一般)
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 - 分類查詢類型
- 識別主題特定 vs 一般查詢
- 擷取函式庫名稱 + 主題關鍵字
- 回傳 JSON:
{topic, library, isTopicSpecific} - 零 token 執行
fetch-docs.js - 擷取文件
- 自動建構 context7.com URL
- 處理備援:主題 → 一般 → 錯誤
- 輸出 llms.txt 內容或錯誤訊息
- 零 token 執行
analyze-llms-txt.js - 處理 llms.txt
- 分類 URL(重要/次要/補充)
- 建議代理分配(1 個代理、3 個代理、7 個代理、分階段)
- 回傳 JSON 附策略
- 零 token 執行
工作流程參考
主題特定搜尋 - 最快路徑(10-15 秒)
一般函式庫搜尋 - 全面涵蓋(30-60 秒)
儲存庫分析 - 備援策略
參考資料
context7-patterns.md - URL 模式、已知儲存庫
errors.md - 錯誤處理、備援策略
advanced.md - 邊界案例、版本控制、多語言
執行原則
- 腳本優先 - 執行腳本而非手動建構 URL
- 零 token 開銷 - 腳本在無上下文載入下執行
- 自動備援 - 腳本處理主題 → 一般 → 錯誤鏈
- 漸進揭露 - 只在需要時載入工作流程/參考
- 代理分配 - 腳本建議平行代理策略
快速開始
主題查詢:「如何在 shadcn 中使用日期選擇器?」
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 取得設定選項。