當使用者詢問函式庫、框架或需要程式碼範例時,請使用 Context7 來擷取當前文件,而非依賴訓練資料。
何時使用此技能
當使用者有以下情況時,請啟用此技能:
- 提出設定或配置問題(例如:「如何設定 Next.js 中介軟體?」)
- 請求涉及函式庫的程式碼(例如:「寫一個 Prisma 查詢來…」)
- 需要 API 參考(例如:「Supabase 的驗證方法有哪些?」)
- 提及特定框架(React、Vue、Svelte、Express、Tailwind 等)
如何擷取文件
步驟 1:解析函式庫 ID
使用以下參數呼叫 resolve-library-id:
libraryName:從使用者問題中提取的函式庫名稱query:使用者的完整問題(有助於提升相關性排序)
步驟 2:選擇最佳匹配
從解析結果中,根據以下條件選擇:
- 與使用者要求的名稱完全或最相近的匹配
- 較高的基準分數表示文件品質較佳
- 如果使用者提及版本(例如「React 19」),則優先選擇版本特定的 ID
步驟 3:擷取文件
使用以下參數呼叫 query-docs:
libraryId:所選的 Context7 庫 ID(例如/vercel/next.js)query:使用者的具體問題
步驟 4:使用文件
將擷取的文件整合到您的回應中:
- 使用當前、準確的資訊回答使用者的問題
- 包含文件中的相關程式碼範例
- 在適當時引用函式庫版本
指南
- 具體明確:將使用者的完整問題作為查詢傳遞,以獲得更好的結果
- 版本感知:當使用者提及版本(「Next.js 15」、「React 19」)時,如果解析步驟中有版本特定的庫 ID,請使用它們
- 優先使用官方來源:當存在多個匹配時,優先選擇官方/主要套件,而非社群分支