當使用者詢問關於函式庫、框架或需要程式碼範例時,請使用 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,請使用它們
- 優先使用官方來源:當有多個匹配結果時,優先選擇官方/主要套件,而非社群分支