Cursor Projects 完整教程：一个 Coordinator + 数千 Subagents 如何开发完整项目

摘要： 本文完整拆解 Cursor Projects 的工作方式：一个 Coordinator 不直接写代码，而是持续规划项目、拆解任务、创建和管理 Subagents，再把实现结果带回给用户检查。Cursor 官方宣布 Projects 能在数月级共享上下文中将工作委派给数千个 Subagents，并支持 Cloud Agents、Local Agents、Slack/PR/定时订阅。最重要的判断是：“数千”代表大型 Project 生命周期中的委派规模，不等于允许数千个 Agent 同时修改同一分支；真正可落地的团队需要任务依赖图、隔离分支、接口契约、验证 Agent、合并队列、预算门与人工发布审批。本文提供从零创建完整项目的步骤、Agent 配置、目录结构、任务卡、验收和故障恢复方案。

核心结论

Cursor Projects 适合把“一个功能、一次迁移或一套完整应用”交给长期运行的 Agent 团队。Coordinator 负责理解目标、维护共享上下文、拆解依赖、调度 Cloud/Local Subagents 和汇总成果；真正的代码实现由 Subagents完成。官方确实使用了“thousands of subagents”的表述，但尚未公布固定的同时并发上限、单项目硬上限或统一价格公式，因此不能把它解释为数千个写 Agent 无限制并行。

• 值得使用： 适合跨数周或数月的应用开发、迁移、持续维护和多仓库项目，不适合只改一行代码的小任务。
• 正确角色分工： Coordinator 只规划、委派、追踪和收敛；Implementer、Tester、Reviewer、Security等Subagents完成具体工作。
• 扩展关键： 先按边界拆任务，再按依赖分批并行；有写冲突的任务必须使用隔离 Worktree、独立 VM 或独立分支。
• 质量关键： 实现 Agent 不能同时作为最终批准者；至少设置独立 Verifier、CI、Code Owner 和合并门禁。
• 成本关键： 每个 Subagent拥有独立上下文和 Token 使用，Cursor 文档明确提醒五个并行 Subagents大致会消耗单 Agent五倍的 Token。

如果你正在搭建 AI Coding Agent 软件工厂，可同时参考 AI Stack Nav 的 Cursor Agent 教程 和 多Agent开发工作流，把本文框架用于 WordPress、n8n、前端应用或企业内部系统。

Cursor Projects 是什么

Cursor 于 2026 年 9 月 10 日在 Changelog 中发布 Projects Beta。官方给出的目标不是“再开一个聊天窗口”，而是处理更大的工作体量，例如完整功能、系统迁移或完整应用。Project 可维护数月上下文、执行无需每次提示的 recurring work，并将任务交给大量 Subagents。

官方说明 Coordinator Agent 不自己写代码。它的职责是规划工作、把任务委派给实现 Agent、管理这些 Agent，并将完成结果带回给用户检查。这一设计把传统“一个 Agent既当项目经理又当程序员”的单体模式改成层级式 Agent Team。

对象	核心职责	持有的上下文	典型输出
Project	长期目标、共享文件、订阅和历史	数月级项目知识	项目状态与共享资产
Coordinator	规划、拆解、派发、收敛、升级	全局目标与任务图	任务卡、依赖、汇总和决策请求
Subagent	在隔离上下文中完成专业任务	完成该任务所需最小上下文	代码、研究、测试或审查结果
Cloud Agent	在独立云计算机和分支工作	仓库、云环境与任务输入	PR、构建、Artifact、预览
Local Agent	在需要本地测试时执行	本地工具、设备或私有环境	本地验证结果
Shared Context	跨云端和本地 Agent 同步知识	研究、Artifact、代码库经验	测试命令、架构约束、团队偏好
Subscription	监听 Slack、PR 或时间信号	事件源与触发规则	自动唤醒 Coordinator

Project 在自己的云端计算机上运行，因此关闭笔记本不会中止它。当任务必须在用户机器测试时，Coordinator 可以启动 Local Agent。共享上下文会在不同 Cloud/Local机器间同步；某个 Agent发现服务测试方法后，后续 Agent可复用该知识。

“数千 Subagents”到底意味着什么

官方公告明确说 Projects can “delegate tasks to thousands of subagents”。这验证了标题的传播点，但必须结合 Subagents 文档理解。

Subagent 是具有独立上下文窗口的专业助手，接收父 Agent提供的必要信息，独立工作并返回最终结果。它可以前台阻塞运行，也可以后台异步运行；可以使用继承模型或指定模型；还可以被恢复并继续原对话。

“数千”更合理的工程解释是：一个长期 Project可累计创建和协调非常多的任务执行单元，而不是任何仓库都应该在同一秒启动数千个写 Agent。原因有四个：

1. 官方没有公布 Projects 的固定同时并发上限。
2. Subagents默认共享父 Agent的 Checkout，并行写文件可能互相覆盖。
3. 每个 Subagent独立使用上下文和 Token，并行数量直接放大成本。
4. 代码任务存在依赖、接口、迁移顺序和共享测试资源，不可能全部无依赖并行。

因此，Project 的核心不是“Agent数量越多越好”，而是 Coordinator 能持续创建恰当的工作批次：分析任务可大规模并行，写任务按文件所有权和依赖图受控并行，验证任务独立执行，合并任务串行收敛。

Coordinator、Subagent 与普通 Agent 的差别

Coordinator 不应该写代码

Coordinator 的最佳输出是清晰的任务图，而不是直接修改实现。它应维护：

• 产品目标和非目标；
• 架构决策记录；
• 模块与接口所有权；
• 任务依赖和阻塞条件；
• Subagent 输入/输出契约；
• 验收证据；
• 风险、预算与需要人类决策的事项。

如果 Coordinator自己频繁修改代码，它会同时承担计划、实现和验收，失去全局调度能力，也让共享上下文被大量日志、Diff和测试输出污染。

Subagent 需要单一职责

Cursor 官方建议从 2—3 个聚焦的 Custom Subagents开始，而不是预先创建几十个模糊“helper”。Subagent的 description 会影响父 Agent何时委派，所以描述必须说明触发条件和输出。

内置 Subagents包括：Explore负责代码搜索与分析，Bash负责长命令序列，Browser通过 MCP处理浏览器交互。它们把噪声中间结果隔离在自己的上下文中，只把摘要返回父 Agent。

Skills 与 Subagents 不应混用

单次、可复用、无需独立上下文的任务更适合 Skill，例如生成 Changelog 或格式化报告；需要长研究、独立验证、并行 Workstream 或不同模型的任务才适合 Subagent。

创建第一个 Cursor Project

上线检查清单

• Project目标、非目标和成功标准已批准。
• Coordinator明确禁止直接写代码和批准发布。
• 任务卡包含依赖、路径、契约、验收、输出和Owner。
• 写Agent使用隔离Worktree、VM或分支。
• Shared Context有权威文件和更新门禁。
• Subagent从2—3个聚焦角色开始，描述清晰。
• 实际模型、Token、Agent数和成本可观测。
• Verifier只读并在干净环境复验。
• CI、安全扫描、Code Owner和Merge Queue已启用。
• MCP、网络和凭据按任务最小化。
• Subscription有信任边界、去重、限流和Dead Letter。
• 生产发布、迁移、删除和权限变更需要人工批准。
• Beta变化、回退和导出方案已准备。

事实依据与来源

Cursor 2026年9月10日官方Changelog确认Projects发布Beta、维护数月上下文、可向数千Subagents委派任务、支持无需提示的Recurring Work；Coordinator不直接写代码，只负责计划、委派、管理和将成果带回用户检查。Project在独立Cloud Computer运行，必要时Coordinator可启动Local Agent。

Cursor Subagents官方文档确认：每个Subagent有独立上下文，可前台或后台运行，可使用Custom Prompt、工具和模型；Project级配置位于.cursor/agents/，支持readonly和is_background；默认共享Checkout可能覆盖彼此修改，可要求隔离Worktree、分支或Cloud VM；五个并行Subagents大致使用单Agent五倍Token。

官方文档还确认Subagent可以在限制深度内创建子Agent，Cloud Subagents使用团队云端MCP配置；Verifier、Planner→Implementer→Verifier编排属于官方推荐模式。本文的任务卡Schema、Wave调度、SaaS案例、30天路线和治理指标属于实施建议，不是Cursor保证的默认行为。

官方公告没有公布Projects固定同时并发数、单项目硬上限、千Agent固定价格或所有账号即时可用时间。本文没有将“数千”写成无条件同时并发，也没有虚构性能提升和Benchmark。

内容核验日期：2026年09月14日

FAQ

Cursor Projects已经正式GA了吗？

没有。Cursor在2026年9月10日将Projects作为Beta发布，并说明从当天开始逐步向所有用户开放。可用性、功能和限制仍可能变化。

Coordinator会自己写代码吗？

官方明确说不会。Coordinator负责计划、委派、创建和管理Agent，并将完成工作带回用户检查；具体实现由Subagents完成。

“数千Subagents”是同时并发数吗？

官方确认可向数千Subagents委派任务，但没有公布固定同时并发上限。更准确的理解是Project生命周期中的调度规模；真实并发取决于任务依赖、隔离资源、套餐、预算和平台限制。

Subagents默认拥有独立分支吗？

不一定。官方文档说明它们默认共享父Agent的Checkout，并行编辑可能互相覆盖。要求隔离后才能获得Worktree、独立分支或Cloud VM副本。

Subagent能看到Coordinator的所有历史吗？

不能假设可以。Subagent从干净上下文开始，父Agent必须在Prompt或任务卡中传递必要信息；长期共享知识应保存在Project文件中。

可以为不同Subagent指定不同模型吗？

可以在Frontmatter中使用model字段，选择inherit或具体模型及可用参数。但管理员限制、套餐和Legacy Max Mode可能触发模型回退。

并行Subagents一定更快吗？

不一定。它们的核心优势是上下文隔离和独立Workstream。简单任务可能因启动和重新获取上下文更慢；并行还会线性放大Token与集成成本。

Projects能在关掉电脑后继续运行吗？

可以。官方说明Project运行在自己的Cloud Computer上；需要在本机测试时，Coordinator可以启动Local Agent。

Projects可以自动监听Slack和PR吗？

官方公告支持Subscriptions，可监听Slack频道、按计划运行或关注PR。生产使用必须配置可信事件源、限流、去重和审批。

能让Projects自动开发并直接发布完整应用吗？

可以让它完成大量开发、测试和持续修复，但不建议取消独立验收和人工责任。生产发布、数据库迁移、权限修改和不可逆动作应由CI、Code Owner与人工审批控制。

参考来源

• Cursor Changelog：Cursor Projects
• Cursor Subagents官方文档
• Cursor Cloud Agents官方文档
• Cursor Cloud Agent Best Practices
• Cursor Agent Review文档
• Cursor Automations文档
• Cursor Cloud Agent Security文档

会员充值教程

会员充值与订阅排查资料

适合阅读会员充值、订阅购买、权益对比和支付问题类文章后继续转化。

AI 订阅充值失败排查包 整理常见支付失败、地区限制、订单未到账和账号异常处理步骤。 查看资料包 会员权益对比表 对比不同 AI 工具会员权益、价格、适用人群和购买建议。 查看资料包