用途:在人工所有者可审查计划、diff、测试与回滚的前提下,用 Cursor Composer 处理有边界的多文件提案。
主要能力:Agent 模式可自主串联工具调用(读文件、语义与文本搜索代码库、执行终端命令、写文件、编辑文件、列目录),循环运行至完成或触及 25 次工具调用上限,写文件与编辑文件会先显示 diff,执行终端命令需点击 Allow。可同时运行最多 8 个 Composer 代理,每个在独立标签页中拥有自己的上下文与对话历史,可并行开发功能,但同一文件重叠时后写覆盖先写;缓解办法是分配不重叠的文件范围、对共享文件串行执行、或用 git cherry-pick 挑选改动。
使用方式:先索要计划与受影响文件列表,再限定在已批准范围内并提供验收检查与非目标;逐条检查 diff、运行聚焦验证,超出范围的改动要拆分或拒绝;只提交经审查、有测试支撑的改动并保留回滚路径。可给出约束(如不改测试文件、保留 prop types、替换为 useEffect、运行 npm test);大重构可用分阶段检查点,每阶段后停下看摘要。也可通过 .cursor/rules 规则约束生成代码风格。
适用场景:多文件重构、架构迁移、跨包(monorepo)功能添加、并行功能开发、先写测试再重构等。
限制与注意:Agent 模式可能生成错误导入路径、错误类型或不存在的方法;可能产生 SQL 注入或 XSS 等安全问题,需审计;使用推理模型时单次会话可能消耗大量 token;重复错误处理可抽取共享工具后再替换。应用后用 npm run build、npm run lint、npm run test 验证,必要时用 git checkout . 或 git checkout -- <file> 回滚。企业使用需考虑许可证合规、安全与审计追踪。