documentation-lookup

documentation-lookup 技能總覽

documentation-lookup 的用途

documentation-lookup 技能能幫助 agent 直接根據最新文件回答 library、framework 與 API 問題，而不是依賴記憶。當使用者需要可靠的安裝與設定協助、精確的方法名稱，或要符合工具最新版的程式碼範例時，它特別適合。

適合哪些人

當你使用 React、Next.js、Prisma、Supabase、Tailwind 這類變動很快的生態系，或任何過時訓練資料風險很高的 library 時，就適合用 documentation-lookup 技能。它尤其適用於實作任務、升級遷移問題，以及「這個要怎麼做才正確？」這類需求。

為什麼它不一樣

它的主要優勢在於 Context7 工作流程：先解析 library ID，再查詢即時文件。這樣可以大幅降低猜測成分，通常也能比一般提示詞得到更好的答案，因為 agent 可以引用最新的 API、設定模式與範例。

如何使用 documentation-lookup 技能

安裝並觸發

要進行 documentation-lookup 安裝，請依照 repository 的 skill 安裝流程把這個 skill 加入你的 Claude Code 或相容設定，並確認 Context7 MCP 已可使用。當使用者要你根據文件回答問題、點名某個 framework，或需要與特定套件版本一致的程式碼時，就應該觸發它。

從正確的輸入開始

一個好的 documentation-lookup 使用提示詞，會同時寫出 library、任務，以及必要時的版本或環境。像是：「使用 Next.js App Router，怎麼加 middleware 做 auth？」或「在 Prisma 5 中，這個 query 的正確 relation filter 怎麼寫？」都很好。像「幫我看 Next.js」這種太模糊的提示，通常只會帶來更多來回確認。

建議工作流程

先讀 SKILL.md，理解先解析再查詢的模式；如果你要把這個 skill 調整到其他 agent 設定，再看看附近的 repository 指引。實務上，流程應該是：先辨識 library，再解析 library ID，接著針對精確主題查文件，最後在確認即時參考內容後，再產出程式碼或步驟。

提升輸出的實用技巧

直接告訴系統你要哪一種結果，例如：「給我最精簡的安裝方式」、「示範官方建議的寫法」，或「比較目前 API 和舊版差異」。如果任務涉及 framework 功能，請一開始就說明 runtime 或生態系限制，例如 Node 版本、app router 與 pages router，或 server component 與 client component 的情境。

documentation-lookup 技能 FAQ

什麼時候該用 documentation-lookup？

當答案取決於最新文件、精確 API 行為，或套件專屬設定時，就該用 documentation-lookup。它很適合安裝、設定與程式碼生成這類問題，因為過時範例在這些情境下代價很高。

documentation-lookup 比一般提示詞更好嗎？

如果正確性依賴即時文件，答案是肯定的。一般提示詞仍然可以用來做概念性說明，但當你需要最新語法、支援選項，或與特定 library 版本綁定的範例時，documentation-lookup 技能更合適。

初學者也需要用嗎？

不用。這個 skill 對初學者和進階使用者都很有幫助。初學者能從更清楚的設定路徑受益；有經驗的使用者則能更快確認目前 API，並減少版本不相容的情況。

什麼情況下不適合用？

如果問題只是概念性建議、偏好導向的架構討論，或不依賴外部文件的任務，就不要用 documentation-lookup。若只靠一般推理就能安全產出答案，查即時文件反而可能沒有必要。

如何提升 documentation-lookup 技能

提供更好的查找目標

品質提升最大的關鍵，在於把精確的 library、套件與功能名稱講清楚。對 documentation-lookup 來說，「React forms」就不如「React Hook Form 的 controller 使用方式搭配 Zod validation」明確。目標越精準，agent 就越容易更快解析到正確文件，也越不會落入範圍太廣、雜訊太多的搜尋。

盡早加入環境限制

在要求程式碼之前，先說明 framework 版本、runtime 與專案形態。「Next.js 14 App Router、TypeScript、server components」就比單說「Next.js」有用得多。這些限制會改變正確的文件路徑，也能避免看起來正確、實際卻不符合你技術棧的答案。

要求符合你的目標的輸出

如果你要的是實作協助，就直接說你想要最小片段、可上線的設定，還是遷移指引。例如：「示範 Prisma 搭配分頁查資料的建議寫法，並說明任何注意事項。」這樣能提升第一次回答的命中率，也能減少後續修正。

用文件結果持續迭代

如果第一次答案接近但還不完全正確，就請 agent 重新查更小的子主題、替代 API，或特定版本行為。documentation-lookup 技能最適合用在短回饋迴圈：先解析 library、再檢視相關文件區段，然後逐步收斂提示詞，直到範例真的符合你的使用情境。