28 · 团队功能

当一个人用好 Cursor 也许只是效率翻倍，但当整个团队都用好 Cursor——开发流程、代码质量、知识管理都将发生质变。本章详解 Cursor 的企业级团队功能，从规则引擎到安全治理，助你打造 AI-native 开发团队。

01 · 团队规则（Team Rules）—— 代码风格的 “宪法”

团队协作最大的痛点之一，就是风格不一致。你的代码用 2 空格缩进，他用 Tab；你习惯写 JSDoc，他信奉 “代码即文档”；你强制 type 导入用 import type，他随手一行 `any”。

传统的 ESLint / Prettier 可以拦截一部分，但它们是静态的。Cursor Team Rules 是 动态的、上下文感知的编码约束——它不仅仅告诉你 “哪里错了”，更在 AI 生成代码的瞬间就遵循你的团队规范。

规则的定义与管理

Team Rules 由团队管理员在 Dashboard（dashboard.cursor.com）上统一编写和管理，以 Markdown 文件形式存储在团队的配置空间中。每条规则都包含：

• 规则名称：简短标识，如 no-any-in-production
• 适用范围：可限定到特定项目、目录、文件类型
• 规则内容：Markdown 格式的自然语言描述，可附带代码示例
• 严重级别：error（必须遵守）/ warning（建议遵守）

示例规则：

# 规则：禁止在生产代码中使用 `any`
 
- 适用范围: `src/**/*.ts` `src/**/*.tsx`
- 严重级别: error
 
在所有 TypeScript 生产代码中，禁止显式使用 `any` 类型。
如果遇到无法确定的类型，使用 `unknown` 替代并进行类型收窄。
 
// ❌ 禁止
const data: any = await fetchData();
 
// ✅ 推荐
const data: unknown = await fetchData();
if (isValidResponse(data)) {
  // 安全使用 data
}

当一个开发者打开 Cursor 并开始编码时，这些规则会自动同步到他的本地环境。当他在 src/ 目录下写了一个 any，即使只是通过 Tab 补全，Cursor 的 Composer 和 Tab 补全都会阻止这个输出，或者用 warning 高亮提醒。

与传统 Linter 的对比

心法模型：Team Rules = 团队的 “肌肉记忆”

把 Team Rules 想象成你给团队注入的集体肌肉记忆。新人加入时，不需要背诵厚厚的编码规范文档——只要你把规则写进 Dashboard，Cursor 会在每一次补全中自然体现规范。代码规范不再是 “事后审查”，而是 “事前预防”。

02 · 共享 Notepads —— 团队知识库的活文档

Cursor 的 Notepad（笔记）功能在个人层面是一个强大的上下文管理工具，而在团队层面，共享 Notepads 成为团队的活文档系统。

核心用途

共享 Notepads 可以存放：

• 项目架构文档：目录结构、模块职责、数据流图
• API 使用规范：内部服务的调用方式、认证机制、错误处理约定
• 常用代码片段库：团队封装的基础工具函数、模板代码
• 技术决策记录（ADR）：为什么选择某个方案，取舍是什么
• Onboarding 指南：新环境配置步骤、常用命令、故障排查

在 Cursor 中直接引用

共享 Notepad 的最大优势是：开发者无需离开编辑器即可引用。在 Chat 或 Composer 中输入 @Notepad，即可快速调取对应的团队知识。

举例：

@Notepad 请根据 API 规范中的鉴权流程，生成一个获取用户信息的接口调用代码。

Cursor 会自动读取 Notepad 中的 API 规范内容，作为生成的上下文，确保代码完全符合团队的约定。

版本控制

共享 Notepads 是有版本历史的，每次编辑都会保存快照。管理员可以回滚到某个历史版本，也可以 diff 查看两次编辑之间的变化。这意味着团队的知识文档不再是 “飘在 Wiki 里无人维护的死页面”，而是随着项目演进而不断更新的活文档。

03 · 团队插件市场 —— 私有 AI 工具生态

个人版的 Cursor 可以安装 VS Code 扩展，但团队版更进一步：团队插件市场（Team Extensions Marketplace） 允许管理员发布仅供团队内部使用的私有插件。

私有扩展的优势

1. 定制化 Lint 规则：团队特有的代码检查规则，作为 VS Code 扩展形式发布
2. 内部工具集成：连接团队内部的 API 网关、代码生成器、脚手架工具
3. 领域特定命令：例如一键生成微服务模板、自动添加日志埋点、调用内部的代码审查服务
4. 安全审查：所有扩展经过管理员审批才可上架，避免恶意插件

部署流程

管理员编写扩展 → 上传到团队市场 → 设置可见范围 → 
团队成员直接在 Cursor 扩展面板中搜索安装 → 自动更新

整个过程无需走 VS Code Marketplace 公开审核，发布和更新都在团队内部闭环完成。

对比公开插件

04 · 组织级隐私控制 —— AI 时代的数据安全

很多企业对 AI 编程工具的顾虑集中在数据安全：“我的代码会不会被拿去训练模型？""敏感信息会不会通过 AI 请求泄露？”

Cursor 的 Organization-level Privacy Controls（组织级隐私控制）就是为解决这些问题而设计的。

四大控制维度

1. 隐私模式（Privacy Mode）

• 开启后，所有代码上下文、对话内容、补全请求不会用于模型训练
• 零数据保留（Zero Data Retention）：请求完成后即丢弃
• 建议：所有商业项目强制开启

2. 数据地域（Data Residency）

• 选择数据存储的物理地域：美国 / 欧洲
• 符合 GDPR、SOC 2 等合规要求
• 适用于有数据本地化要求的行业（金融、医疗、政务）

3. 审计日志（Audit Logs）

• 记录每个成员使用 Cursor 的完整轨迹
• 包含：AI 请求次数、补全接受率、使用的模型、API 调用详情
• 导出格式：CSV / JSON，可对接 SIEM 系统

4. 域名白名单（Allowed Domains）

• 限制 AI 搜索功能可访问的外部网站
• 防止通过联网搜索泄露内部项目信息

心法模型：隐私控制 = 数字边界

把组织级隐私控制想象成你为团队画的一个数字围栏。围栏之内，Cursor 可以自由发挥全部能力；围栏之外，任何数据都不会越界。安全团队可以通过 Dashboard 一目了然地看到当前的安全状态，无需逐人检查。

05 · 管理后台（Admin Dashboard）—— 团队的指挥中心

Admin Dashboard（admin.cursor.com）是团队管理员的核心工作台。它整合了所有管理功能，提供统一的操作界面。

核心面板

概览面板

• 团队活跃成员数
• 今日 / 本周 / 本月 AI 调用量
• 平均补全接受率（衡量 AI 辅助效率的关键指标）
• 热门使用的模型分布

成员管理面板

• 成员列表：姓名、邮箱、角色、最后活跃时间
• 角色分配：Admin / Member / Billing 三种预设角色
• 批量操作：邀请 / 移除 / 角色变更 / 席位调整

规则管理面板

• 所有 Team Rules 的列表、状态、最后修改时间
• 规则生效热力图：哪些规则被触发次数最多
• 规则测试沙箱：编写新规则后可以先模拟测试

账单面板

• 当前订阅计划和使用量
• 预估月度费用
• 席位变更历史

常用管理操作

# Admin Dashboard 典型操作流程
新增成员:
  1. 进入 Members 页面
  2. 点击 "Invite Members"
  3. 输入邮箱（支持批量输入）
  4. 选择角色（Member / Admin）
  5. 选择是否发送 Onboarding 邮件
  6. 确认 → 成员收到邀请链接
 
更新团队规则:
  1. 进入 Rules 页面
  2. 选择要编辑的规则或 "Create Rule"
  3. 编写 Markdown 规则内容
  4. 设置适用范围和严重级别
  5. 点击 "Push to Team" → 所有成员即时生效
 
查看使用报告:
  1. 进入 Analytics 页面
  2. 选择时间范围（7天 / 30天 / 自定义）
  3. 筛选维度（按成员 / 按项目 / 按功能）
  4. 点击 "Export" 导出报告

06 · 成员管理 —— 规模化团队的必修课

当一个团队从几个人扩张到几十人甚至上百人时，成员管理就成为基础而关键的一环。

角色体系

批量导入与管理

对于大规模团队，Cursor Dashboard 支持：

• SSO / SCIM 集成：通过 Okta、Azure AD、Google Workspace 自动同步组织架构
• CSV 批量导入：从 Excel 或 HR 系统导出成员列表，一次导入
• 自动席位分配：按部门 / 项目组自动分配席位，减少手动操作
• 离职自动回收：与 SCIM 联动，成员在 IdP 中移除后自动回收席位

席位管理技巧

如果团队使用 “按需付费”（Usage-based）模型，建议开启 冷席位自动回收：超过 30 天未活跃的席位自动释放，下个月不再计费。这对于有季节性开发人员的团队（如实习生项目）特别实用。

07 · 用 Team Rules 落地编码规范

理论讲了很多，现在看一个完整的实战案例：如何用 Team Rules 在团队中强制推行基于函数式编程的风格规范。

场景

你的团队决定在 React 项目中全面采用函数式组件 + Hooks，禁止 Class 组件；同时要求所有组件使用 React.memo 包裹以提高性能。

步骤一：编写规则

在 Dashboard 中创建两条规则：

# 规则：禁止使用 Class 组件
- 适用范围: `src/components/**/*.tsx`
- 严重级别: error
 
禁止在 `src/components/` 下使用 React Class 组件。
所有组件必须是函数式组件。
 
// ❌ 禁止
class UserProfile extends React.Component {
  render() {
    return <div>{this.props.name}</div>;
  }
}
 
// ✅ 推荐
function UserProfile({ name }: { name: string }) {
  return <div>{name}</div>;
}
 
为了迁移兼容，`src/legacy/` 目录下的文件不受此规则限制。

# 规则：组件默认使用 memo
- 适用范围: `src/components/**/*.tsx`
- 严重级别: warning
 
新创建的组件应默认使用 React.memo 包裹。
如果组件不需要 memo，在文件顶部添加注释 `// @no-memo` 并说明原因。
 
// ✅ 推荐
export const UserCard = React.memo(function UserCard({ user }: Props) {
  return <div>{user.name}</div>;
});

步骤二：推送规则

点击 “Push to Team”，所有成员无需任何操作即可收到更新。正在编写代码的成员在下一次补全时，规则就已经生效。

步骤三：监控执行

Admin Dashboard 的 Analytics 页面会显示：

• 两条规则各被触发多少次
• 哪些成员的代码触发了规则
• 规则触发后的操作（自动修正 / 仅警告 / 被忽略）

效果对比

核心结论：Team Rules 将编码规范的执行从 “人工审查” 转移到 “AI 生成约束”，从根本上消除了规范违规的源头。

08 · 用 Cursor 做团队 Onboarding —— 新人 1 天上手

新成员加入团队时，传统流程是：配环境 → 读文档 → 跑 Demo → 改 Bug → 交第一个 PR。这个过程通常需要 1-2 周才能勉强产出有价值代码。

借助 Cursor 的团队功能，可以把 Onboarding 压缩到 1 天。

Onboarding 流程设计

上午：环境准备（2 小时）

1. 邀请新成员加入 Cursor Organization（Dashboard 一键发送邀请）
2. 新成员登录后，Team Rules 自动同步
3. 共享 Notepads 中的 Onboarding Guide 自动出现在其 Notepad 列表中
4. 团队插件市场中的必要扩展（如内部工具链）自动推荐安装

上午：项目概览（1.5 小时）

5. 新人打开项目仓库，在 Cursor Chat 中输入：

   @Notepad(项目架构概览) 请给我一个 10 分钟就能读完的项目导览

   Cursor 会结合 Notepad 中的架构文档和实际的代码仓库，生成一份个性化的项目导览。

下午：第一个任务（3 小时）

6. 分配一个小型但真实的任务（如修复一个低优先级的 Bug）
7. 新人在 Composer 中使用 @Notepad(编码规范) + @Notepad(API 规范) 作为上下文
8. AI 生成的代码天然符合团队规范，无需大量 Review 迭代
9. 提交 PR，Code Reviewer 只需要关注业务逻辑是否正确，而不是代码风格是否规范

下午：提交第一个 PR（1 小时）

10. 第一个 PR 合并完成，新人获得正反馈

量化对比

心法模型：Onboarding = 知识蒸馏

Cursor 的 Onboarding 体验背后是一种知识蒸馏的思维——团队多年来积累的架构决策、编码规范、领域知识，通过 Team Rules 和 Notepads 蒸馏为一套可执行的上下文。新人不是通过 “阅读文档” 来学习，而是通过 “在 AI 辅助下做真实任务” 来内化知识。学习效率的提升不是线性的，而是指数级的。

09 · 组织层面的策略建议

当团队决定采用 Cursor 的企业版时，以下策略可以帮助你平稳落地、最大化 ROI。

阶段一：试点（第 1-2 周）

• 选定 5-10 名早期采用者（Enthusiasts）
• 搭建基础 Team Rules（10 条以内，聚焦最重要的编码规范）
• 建立 2-3 个共享 Notepad（项目架构 + API 规范 + Onboarding Guide）
• 目标：验证效果，收集反馈

阶段二：推广（第 3-8 周）

• 扩大到整个工程团队（50 人以内）
• 完善 Team Rules（扩展到 20-30 条，覆盖更多场景）
• 建立团队插件市场中的 1-2 个核心插件
• 打开数据分析面板，监控采纳率
• 目标：70% 以上成员的日常开发已依赖 Cursor

阶段三：深化（第 9-16 周）

• 全员覆盖，包括 QA、DevOps、数据工程师
• 建立规则评审流程：定期回顾 Team Rules 的有效性，淘汰无效规则
• 鼓励成员贡献共享 Notepad
• 将 Cursor 使用数据接入团队 OKR / KPI
• 目标：Cursor 成为团队基础设施的一部分

关键成功因素

• 管理层支持：团队负责人要率先使用，成为榜样
• 低摩擦推广：不要强制，让开发者自己体验效率提升
• 持续优化：Team Rules 不是一次写完就完事的，需要持续迭代
• 安全优先：从一开始就启用隐私模式，避免后续合规问题

10 · 总结

Cursor 的团队功能将 AI 编程助手从个人工具升级为团队基础设施。核心要点：

如果你的团队还在用 “人治” 的方式管理代码规范——靠 Code Review 来纠正每一个缩进、每一个命名、每一个模式选择——那么是时候让 AI 来承担这部分工作了。不是取代人的判断力，而是把人的精力释放到真正需要创造力的事情上。

当团队中每个人的 Cursor 都共享同一套规则、同一份知识、同一个安全边界，你的团队就真正进入了 AI-native 的开发模式。

下一篇：[29 · Cursor in CI/CD] —— 将 Cursor 的能力集成到持续集成和持续部署流水线中，实现 AI 辅助的自动化代码审查与质量门禁。