---
title: "上下文與定製"
description: "上下文與定製相關的 Cursor 官方教程中文版。"
verifiedAt: "2026-05-09"
---

解決反覆貼上背景、重複解釋專案規範、工具接入混亂、團隊規則不可複用的問題。這一組是 Cursor 的上下文層——Rules、MCP、Skills、Subagents、Hooks、Commands 和 Plugins 決定 Agent 能看見什麼、遵守什麼、什麼時候自動觸發。

> [!NOTE]
> **閱讀方式**：先看判斷和路徑，再進入具體章節。Cursor 的資料變化很快，模型、價格、用量和企業策略以官方頁面為準。

<Cards>
  <Card title="Rules" description="用 Project/User/Team Rules 和 AGENTS.md 管理長期指令。" href="/zh-Hant/docs/cursor/official/02-context-customization/20-rules" />
  <Card title="MCP" description="把外部工具和資料來源接入 Cursor Agent。" href="/zh-Hant/docs/cursor/official/02-context-customization/21-mcp" />
  <Card title="Skills" description="用 Skills 封裝可複用工作流和任務知識。" href="/zh-Hant/docs/cursor/official/02-context-customization/22-skills" />
  <Card title="Subagents" description="用 Subagents 拆分複雜任務和專業角色。" href="/zh-Hant/docs/cursor/official/02-context-customization/23-subagents" />
  <Card title="Hooks" description="用 Hooks 在關鍵事件上執行檢查和自動化。" href="/zh-Hant/docs/cursor/official/02-context-customization/24-hooks" />
  <Card title="Plugins" description="理解 Cursor 外掛與定製系統的關係。" href="/zh-Hant/docs/cursor/official/02-context-customization/25-plugins" />
</Cards>

## 這組解決什麼

Cursor 的 Agent 能力越強，越需要穩定上下文。上下文與定製層負責三件事：

- 讓 Agent 自動讀取長期規則，而不是每次重新貼上。
- 讓外部系統透過 MCP、外掛或命令變成可控工具。
- 讓團隊把重複工作沉澱成 Skills、Subagents、Hooks 或 Commands。

如果沒有這一層，Cursor 很容易變成“每次靠一條長 prompt 臨時發揮”。有了這一層，Agent 每次進入專案都能先理解邊界、工具和驗收標準。

## 學習順序

建議按風險從低到高學習：

1. Rules：先把穩定約定寫清楚。
2. MCP：再接外部工具和資料來源。
3. Skills：把可複用任務流程封裝起來。
4. Subagents：複雜任務再拆角色，不要一開始就多 agent。
5. Hooks / Commands：最後再做自動觸發和命令化。
6. Plugins：只在需要擴充套件能力時引入，並檢查許可權和來源。

這個順序能避免剛入門就把許可權面開啟。Rules 是最輕的複用，MCP 和外掛會引入外部系統，Hooks 則可能在你沒有顯式要求時執行動作。

## 驗收標準

每一種定製能力都要能回答四個問題：

- 它什麼時候觸發。
- 它能讀取或修改什麼。
- 它失敗時如何暴露錯誤。
- 它是否需要團隊級 review。

如果回答不出來，就先不要放進共享專案。尤其是 MCP 和 Hooks，配置錯誤會讓 Agent 拿到過大的工具面，或者在不合適的時機執行命令。

## 和 Agent 工作流的關係

Agent 工作流是一次任務的執行迴圈；上下文定製是讓每次執行前都自動帶上正確背景。比如“不要動生成檔案”“提交前跑 typecheck”“所有 API 改動必須補測試”這類規則，應該從 prompt 遷移到專案規則或 Hook。這樣團隊成員不用記住每條約定，Agent 也更少偏離專案標準。

## 推薦落地方式

真實專案裡可以這樣推進：

1. 先把已有團隊約定整理成 Rules。
2. 把只讀外部資訊接入 MCP，例如文件、issue、日誌或搜尋。
3. 把重複任務封裝成 Skills，例如“排查構建失敗”“補測試”“生成 release note”。
4. 對高風險自動化先做 dry run，再考慮 Hook。
5. 所有會寫入、上傳、刪除或提交的能力都要有人工確認邊界。

這種順序能讓定製系統逐步變強，同時保持可審查。不要在第一天同時啟用 MCP、Hooks、Subagents 和外掛市場，否則很難判斷一次錯誤來自哪裡。

## 維護檢查

每次 Cursor 或團隊流程升級後，回看這些配置：

- Rules 是否仍然準確。
- MCP token 和 tool allowlist 是否過寬。
- Skills 是否有過期命令。
- Hooks 是否還能在本地和 CI 中穩定執行。
- Plugins 是否仍來自可信來源。

上下文定製不是一次性配置。它會隨著專案結構、工具鏈和團隊規範變化，需要定期清理。

如果一個配置已經沒有人能解釋用途，就先移除或降級為手動命令。可解釋性比功能數量更重要，也更適合團隊長期維護、協作和覆盤。

先少後多，才可控、可查、可恢復、可覆盤。這是底線。


## 官方來源

- [Cursor Docs](https://cursor.com/docs)
- [Cursor llms.txt](https://cursor.com/llms.txt)
- [Cursor Help Center](https://cursor.com/help)
