---

name: context7-documentation description: 使用 Context7 MCP 工具查詢最新函式庫文件。確保回答基於即時、正確的官方文件，而非過時的訓練資料。適用於任何需要查詢 npm、PyPI、crates.io 等套件文件的場景。

Context7 Documentation 技能

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

何時使用此技能

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

核心原則

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

必要工作流程

步驟 1：識別函式庫 🔍

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

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

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

必須先呼叫此工具：

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

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

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

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

必須接著呼叫此工具：

Copymcp_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 驗證
• ❌ 使用過時的模式 — 檢查文件中的當前建議
• ❌ 忽略版本 — 版本對準確性至關重要
• ❌ 跳過版本檢查 — 永遠檢查並告知升級資訊
• ❌ 虛構功能 — 如果文件未提及，可能不存在

參考文件

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