Context7 Documentation 技能

此技能提供使用 Context7 MCP 工具查詢最新函式庫/框架文件的標準化流程。

何時使用此技能

• •回答任何關於特定函式庫或框架的問題
• •需要提供準確的 API 簽名或範例程式碼
• •檢查用戶專案中套件的版本升級資訊
• •除錯與特定函式庫相關的問題

核心原則

[!IMPORTANT] 文件優先：絕不猜測。在回答任何函式庫相關問題前，必須先透過 Context7 驗證。

必要工作流程

步驟 1：識別函式庫 🔍

從用戶問題中提取函式庫/框架名稱：

• •"express middleware" → Express.js
• •"react hooks" → React
• •"next.js routing" → Next.js

步驟 2：解析 Library ID（必要）📚

必須先呼叫此工具：

mcp_context7_resolve-library-id({ 
  libraryName: "express",
  query: "用戶的原始問題" 
})

從回傳結果中選擇最佳匹配，依據：

• •名稱完全匹配
• •高來源信譽（Source Reputation: High）
• •高評分（Benchmark Score）
• •較多程式碼片段（Code Snippet counts）

步驟 3：取得文件（必要）📖

必須接著呼叫此工具：

mcp_context7_query-docs({ 
  libraryId: "/expressjs/express",
  query: "middleware best practices"
})

主題參數建議：

步驟 4：版本檢查與升級建議（必要）🔄

1. •檢測用戶目前使用的版本（從專案中的相依性檔案）
2. •比較最新版本（從 Context7 回傳或套件 Registry）
3. •告知用戶可用的升級

詳細的語言生態系版本處理方式，請參閱 references/language-ecosystems.md。

步驟 5：基於取得的文件回答 ✅

僅使用取得的文件中的資訊：

• •API 簽名
• •程式碼範例
• •最佳實踐
• •當前推薦模式

品質檢查清單

回答前確認：

• • 是否已呼叫 resolve-library-id？
• • 是否已呼叫 query-docs？
• • 是否檢查用戶目前的版本？
• • 是否比較最新版本並告知升級資訊？
• • 回答中的所有 API 是否都存在於文件中？
• • 是否明確標註版本？

禁止事項 🚫

• •❌ 猜測 API 簽名 — 務必透過 Context7 驗證
• •❌ 使用過時的模式 — 檢查文件中的當前建議
• •❌ 忽略版本 — 版本對準確性至關重要
• •❌ 跳過版本檢查 — 永遠檢查並告知升級資訊
• •❌ 虛構功能 — 如果文件未提及，可能不存在

參考文件

• •完整工作流程說明
• •語言生態系與版本處理