為什麼文件很重要
- 最新的 API 與參數
- 最佳實務
- 組織慣例
- 領域術語
模型知識截止點
- 最近的函式庫更新可能不會反映出來
- 新的框架或工具可能不被模型識別
- 截止日期之後的 API 變更會被漏掉
- 自訓練以來,最佳實務可能已經演進
我該用哪個工具?
心智模型
工具 | 心智模型 |
---|---|
@Docs | 就像瀏覽並閱讀官方文件 |
@Web | 就像在網路上搜尋解答 |
MCP | 就像存取自己的內部文件 |
公開文件
使用 @Docs
@Docs
會把 Cursor 連接到熱門工具與框架的官方文件。當你需要最新、權威的資訊時就用它,像是:
- API 參考:函式簽名、參數、回傳型別
- 快速上手指南:安裝、設定、基本用法
- 最佳實務:官方建議的設計模式與做法
- 框架專屬除錯:官方疑難排解指南
@
@Docs Next.js How do I set up dynamic routing with catch-all routes?
∞
Agent⌘I
Auto
使用 @Web
@Web
會在即時網路上搜尋最新資訊、部落格文章和社群討論。需要以下內容時就用它:
- 最新教學:社群產出的內容與範例
- 比較:比較不同做法的文章
- 最新動態:最新的更新或公告
- 多元觀點:針對問題的不同解法
@
@Web latest performance optimizations for React 19
∞
Agent⌘I
Auto
內部文件
- 內部 API:自訂服務與微服務
- 公司標準:程式碼規範、架構模式
- 專有系統:自訂工具、資料庫、工作流程
- 網域知識:商業邏輯、法規遵循需求
使用 MCP 存取內部文件
- 模型無法猜出你的內部慣例
- 自訂服務的 API 文件不會公開
- 商業邏輯和領域知識對每個組織都是獨一無二的
- 合規與安全需求因公司而異
常見的 MCP 整合
Integration | Access | Examples |
---|---|---|
Confluence | 公司的 Confluence 空間 | 架構文件、內部服務的 API 規格、程式碼標準與指南、流程文件 |
Google Drive | 共用文件與資料夾 | 規格文件、會議筆記與決策記錄、設計文件與需求、團隊知識庫 |
Notion | 工作區資料庫與頁面 | 專案文件、團隊 Wiki、知識庫、產品需求、技術規格 |
Custom | 內部系統與資料庫 | 專有 API、傳統文件系統、自訂知識庫、專用工具與工作流程 |
自訂解決方案
- 擷取內部網站或入口
- 連線專有資料庫
- 存取自訂文件系統
- 從內部 Wiki 或知識庫抓取內容
如果你建立自訂 MCP 伺服器,也可以公開工具讓 Cursor 更新文件
讓文件保持最新狀態
從現有程式碼
@
為這個 Express router 產生 API 文件,包含所有端點、參數與回應格式
∞
Agent⌘I
Auto
來自聊天工作階段
解決複雜問題之後:
@
把我們關於設定認證的對話整理成逐步指南,放到團隊 wiki
∞
Agent⌘I
Auto
重點整理
- 把文件當作上下文能讓 Cursor 更精準、資訊更即時
- 用
@Docs
查官方文件,用@Web
看社群知識 - MCP 把 Cursor 跟你的內部系統接起來
- 從程式碼和對話產生文件,讓知識隨時維持最新
- 結合外部與內部文件來源,打造更完整的理解