透過腳本進行文件探索
概述
腳本優先的文件探索,採用 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} - 零代幣執行
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 中使用日期選擇器?"
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 了解設定選項。