上下文与定制
上下文与定制相关的 Cursor 官方教程中文版。
解决反复粘贴背景、重复解释项目规范、工具接入混乱、团队规则不可复用的问题。这一组是 Cursor 的上下文层——Rules、MCP、Skills、Subagents、Hooks、Commands 和 Plugins 决定 Agent 能看见什么、遵守什么、什么时候自动触发。
阅读方式：先看判断和路径，再进入具体章节。Cursor 的资料变化很快，模型、价格、用量和企业策略以官方页面为准。
Rules
用 Project/User/Team Rules 和 AGENTS.md 管理长期指令。
MCP
把外部工具和数据源接入 Cursor Agent。
Skills
用 Skills 封装可复用工作流和任务知识。
Subagents
用 Subagents 拆分复杂任务和专业角色。
Hooks
用 Hooks 在关键事件上执行检查和自动化。
Plugins
理解 Cursor 插件与定制系统的关系。
这组解决什么
Cursor 的 Agent 能力越强，越需要稳定上下文。上下文与定制层负责三件事：
- 让 Agent 自动读取长期规则，而不是每次重新粘贴。
- 让外部系统通过 MCP、插件或命令变成可控工具。
- 让团队把重复工作沉淀成 Skills、Subagents、Hooks 或 Commands。
如果没有这一层，Cursor 很容易变成“每次靠一条长 prompt 临时发挥”。有了这一层，Agent 每次进入项目都能先理解边界、工具和验收标准。
学习顺序
建议按风险从低到高学习：
- Rules：先把稳定约定写清楚。
- MCP：再接外部工具和数据源。
- Skills：把可复用任务流程封装起来。
- Subagents：复杂任务再拆角色，不要一开始就多 agent。
- Hooks / Commands：最后再做自动触发和命令化。
- Plugins：只在需要扩展能力时引入，并检查权限和来源。
这个顺序能避免刚入门就把权限面打开。Rules 是最轻的复用，MCP 和插件会引入外部系统，Hooks 则可能在你没有显式要求时执行动作。
验收标准
每一种定制能力都要能回答四个问题：
- 它什么时候触发。
- 它能读取或修改什么。
- 它失败时如何暴露错误。
- 它是否需要团队级 review。
如果回答不出来，就先不要放进共享项目。尤其是 MCP 和 Hooks，配置错误会让 Agent 拿到过大的工具面，或者在不合适的时机运行命令。
和 Agent 工作流的关系
Agent 工作流是一次任务的执行循环；上下文定制是让每次执行前都自动带上正确背景。比如“不要动生成文件”“提交前跑 typecheck”“所有 API 改动必须补测试”这类规则，应该从 prompt 迁移到项目规则或 Hook。这样团队成员不用记住每条约定，Agent 也更少偏离项目标准。
推荐落地方式
真实项目里可以这样推进：
- 先把已有团队约定整理成 Rules。
- 把只读外部信息接入 MCP，例如文档、issue、日志或搜索。
- 把重复任务封装成 Skills，例如“排查构建失败”“补测试”“生成 release note”。
- 对高风险自动化先做 dry run，再考虑 Hook。
- 所有会写入、上传、删除或提交的能力都要有人工确认边界。
这种顺序能让定制系统逐步变强，同时保持可审查。不要在第一天同时启用 MCP、Hooks、Subagents 和插件市场，否则很难判断一次错误来自哪里。
维护检查
每次 Cursor 或团队流程升级后，回看这些配置：
- Rules 是否仍然准确。
- MCP token 和 tool allowlist 是否过宽。
- Skills 是否有过期命令。
- Hooks 是否还能在本地和 CI 中稳定运行。
- Plugins 是否仍来自可信来源。
上下文定制不是一次性配置。它会随着项目结构、工具链和团队规范变化，需要定期清理。
如果一个配置已经没有人能解释用途，就先移除或降级为手动命令。可解释性比功能数量更重要，也更适合团队长期维护、协作和复盘。
先少后多，才可控、可查、可恢复、可复盘。这是底线。