Cursor 使用技巧：Agent、Rules、MCP 與專案上下文完整教學

為什麼 Cursor 的 Prompt 技巧很重要？

Cursor 的輸出品質不只取決於模型，而是取決於你有沒有把任務、上下文、規則與驗證方式放對位置。一個模糊的指令會讓 Agent 猜測你的架構；一個明確的指令能讓它先讀 repo、列計畫、修改檔案，再用測試或 lint 驗證。

本文以 2026 年的 Cursor 工作流來看：重點不是單一聊天視窗，而是 Agent、Rules、MCP 與 Hooks 如何一起工作。

---

Rules、AGENTS.md、User rules 與 Team rules

Cursor 的專案規則現在更適合拆成多層管理，而不是把所有規範塞進單一舊檔。實務上可以這樣分：

規則位置	適合放什麼	何時使用
.cursor/rules/	專案架構、測試命令、資料夾慣例、禁止事項	跟 repo 一起版本控制
AGENTS.md	給多個 AI coding agent 共用的專案規範	團隊同時用 Codex / Cursor / Claude Code
User rules	個人偏好的回覆風格、固定工作習慣	你每個專案都想套用
Team rules	團隊共用的 code style、review 標準、安全要求	Teams / Enterprise 導入時

如果你正在整理舊專案，建議把規則拆進 .cursor/rules/，再把跨工具共用規範放進 AGENTS.md。這樣比較適合 code review、版本控制與團隊共用。

好規則的寫法

# Build and verify
- After editing TypeScript, run npm run check.
- After public content changes, run the targeted Playwright spec.
- Do not claim deployed until production curl reads the expected marker.

# Architecture
- Keep generated content in src/lib/mock-tools.ts unless a page has a dedicated data file.
- Do not introduce new UI tokens without updating the design standard first.

# Safety
- Never print env files or API tokens.
- Do not rewrite unrelated user changes in a dirty worktree.

規則要寫「成功條件」與「不可踩的坑」，不要只寫角色扮演句。像「你是資深工程師」對結果幫助有限；「改完必須跑哪個驗證」才會真的影響輸出。

---

Agent 指令怎麼寫才穩？

原則：先定義任務邊界，再要求驗證

不好的 prompt：

這頁內容更新一下

好的 prompt：

請更新 @file src/lib/mock-tools.ts 裡 Cursor prompt-guide 與 vs-github-copilot 的 2026 文案。目標是移除舊多檔編輯面板 / 舊規則檔主軸，改成 Agent、Rules、MCP、Cloud agents 與 Teams pricing。不要改 UI。完成後跑 npm run check 與 tests/e2e/verify-tools-deep-p1.spec.ts。

常用 Prompt 模板

除錯（Debug）：

### 預期行為：[描述]

實際結果：[錯誤訊息 / 錯誤行為]
請先列 2-3 個可能根因，讀相關檔案確認後，只做最小修正。
修正後請重跑同一個失敗測試。

重構（Refactor）：

請重構 @file [檔案名稱] 的 [區塊/函式]。
目標：
1. 保持外部行為不變
2. 減少重複
3. 不改 unrelated files
成功條件：[測試 / lint / curl marker]

內容更新（Content refresh）：

請依官方文件更新 [工具/模型] 的功能、定價與限制。
只能寫有來源支持的版本、價格、授權與商用描述。
避免「最強」「保證可商用」「完全免費」等絕對宣稱。

---

Agent、Rules、MCP 與 Hooks 如何配合？

1. Agent 負責做多步驟任務

Agent 適合讀 repo、拆任務、改多個檔案、跑測試與依錯誤修正。你要給它清楚的完成標準，而不是只說「幫我優化」。

2. Rules 固定專案知識

Rules 讓 Agent 不需要每次重新理解專案。應該放部署方式、測試命令、架構禁區、資料來源規則與團隊偏好。

3. MCP 擴充外部上下文

MCP 適合把文件、資料庫、issue、設計系統或內部工具接進工作流。當任務需要外部資料時，不要只靠模型記憶，應要求 Agent 讀官方文件或 MCP 資料源。

4. Hooks 把驗證前移

Hooks 適合在存檔、送出或特定操作前後跑格式化、lint、測試或安全檢查。對團隊來說，Hooks 的價值是把「記得跑檢查」變成流程，而不是靠人記憶。

---

@mentions 實戰技巧

場景	推薦用法
修改特定功能	@file components/Auth.tsx 引用相關檔案
需要整包上下文	@folder src/lib 或讓 Agent 先搜尋相關檔案
需要最新 API 資訊	@web official docs 或連到文件 MCP
遵循專案規範	@file AGENTS.md、@folder .cursor/rules
根據最近變更工作	@git 引用最近 commit diff

---

常見問題

Q：Cursor 還要不要用舊規則檔？ A：可以理解舊專案留下的概念，但新專案建議把規則拆進 .cursor/rules/、AGENTS.md、User rules 與 Team rules。這樣比較能被版本控制、code review 與團隊治理使用。

Q：Agent 做錯了怎麼辦？ A：不要直接要求它「再試一次」。先貼出失敗測試或錯誤輸出，要求它列根因、讀相關檔案確認，再做最小修正。沒有驗證輸出就不算完成。

Q：什麼時候需要 MCP？ A：當任務需要 repo 之外的最新文件、內部資料、issue、資料庫或第三方 API 時，就不要靠模型記憶。MCP 的價值是把外部上下文接進 Agent 工作流。