---
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="/docs/cursor/official/02-context-customization/20-rules" />
  <Card title="MCP" description="把外部工具和数据源接入 Cursor Agent。" href="/docs/cursor/official/02-context-customization/21-mcp" />
  <Card title="Skills" description="用 Skills 封装可复用工作流和任务知识。" href="/docs/cursor/official/02-context-customization/22-skills" />
  <Card title="Subagents" description="用 Subagents 拆分复杂任务和专业角色。" href="/docs/cursor/official/02-context-customization/23-subagents" />
  <Card title="Hooks" description="用 Hooks 在关键事件上执行检查和自动化。" href="/docs/cursor/official/02-context-customization/24-hooks" />
  <Card title="Plugins" description="理解 Cursor 插件与定制系统的关系。" href="/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)
