Cursor Claude Code 子代理创建与调用完全指南适配你已掌握的子Agent管理、渐进式披露、SPEC/PLAN流程帮你快速搭建专属AI开发团队。一、核心概念回顾子代理Subagent是主Agent派生的专业智能体拥有独立上下文窗口、工具集和执行环境专注特定任务后返回结果摘要避免全局上下文污染完美契合渐进式披露设计哲学。二、Cursor 子代理创建与调用全流程2.1 两种创建方式方式1手动创建文件推荐精细控制在项目根目录创建.cursor/agents/文件夹新建markdown文件如security-auditor.md格式如下--- name: security-auditor # 子代理唯一标识小写连字符 description: 检测代码中OWASP Top 10漏洞包括SQL注入、XSS、硬编码密钥等使用最小权限原则 model: claude-3-sonnet-20240229 # 可选指定模型 tools: # 按需授权工具遵循最小权限 - Read - Grep - Glob - Bash effort: medium # 执行成本low/medium/high maxTurns: 20 # 最大交互轮次 --- # 安全审计专家子代理 ## 核心职责 1. 审查代码中的安全漏洞 2. 提供修复建议和代码示例 3. 生成详细审计报告 ## 审计流程 1. 使用Grep搜索敏感关键词password、secret、token等 2. 检查输入验证和输出编码 3. 验证权限控制逻辑 4. 扫描依赖包漏洞保存后Cursor自动识别无需重启方式2命令行快速创建在Cursor聊天框输入/subagent或/agent按提示输入子代理名称、描述、工具集系统自动生成配置文件并保存到.cursor/agents/目录2.2 三种调用方式调用类型语法示例适用场景执行模式自动调用提交代码后主Agent自动检测并调用重复任务代码审查、测试生成后台执行不阻塞主流程显式调用/subagent --namesecurity-auditor 审查用户认证模块专项任务、精准控制前台执行主Agent等待结果PLAN集成在PLAN中指定子Agentsecurity-auditor 负责安全审计复杂项目分工、并行执行按计划自动调度关键调用技巧前台vs后台执行# 前台执行等待结果 /subagent --nametest-runner 执行单元测试 --foreground # 后台执行立即返回 /subagent --namelong-task 分析10GB日志 --background结果处理子代理执行完毕后主Agent自动接收摘要不传递完整上下文保持对话清爽2.3 Cursor内置子代理Cursor默认提供3个核心子代理可直接使用verifier验证代码实现是否符合SPEC运行测试并报告结果refactorer代码重构专家优化结构、提升性能test-writer自动生成单元测试和集成测试三、Claude Code 子代理创建与调用全流程3.1 三种创建方式方式1/agents 命令推荐可视化操作聊天框输入/agents打开管理界面选择Create new agent→ 选择作用域User-level全局可用保存到~/.claude/agents/Project-level仅当前项目可用保存到.claude/agents/输入名称、描述、工具集Claude自动生成配置按e编辑系统提示完成定制方式2手动创建文件创建.claude/agents/目录新建markdown文件格式与Cursor类似字段略有扩展--- name: gis-data-processor description: 处理地理空间数据包括格式转换、投影变换、DEM分析遵循GIS最佳实践 model: claude-3-opus-20240229 tools: - Read - Grep - GDAL # 自定义GIS工具 - ArcGIS effort: high maxTurns: 30 use_proactively: true # 主Agent自动识别调用场景 --- # GIS数据处理专家 ## 核心能力 1. Shapefile → GeoJSON 格式转换 2. DEM空洞修复与地形分析 3. 遥感影像语义分割集成Geo-SAM 4. 生成GIS分析报告与可视化地图保存后Claude Code自动加载方式3CLI临时创建会话级claude--agents{ temp-gis-agent: { description: 临时GIS数据处理子代理, prompt: 你是GIS专家..., tools: [Read, GDAL] } }仅当前会话有效关闭后失效3.2 四种调用方式调用类型语法示例触发机制适用场景自动调用输入帮我处理这个Shapefile描述匹配子代理职责日常开发、快速任务显式指定“Use the gis-data-processor to convert this file”明确提及子代理名称复杂任务、精准分工命令行调用/agent gis-data-processor 分析DEM数据直接命令触发紧急任务、手动调度SPEC/PLAN集成在PLAN中写入子Agentgis-data-processor 负责数据转换计划驱动全流程自动化提升自动调用概率的关键技巧描述中加入use proactively或MUST BE USED关键词职责单一化一个子代理只负责一项核心任务工具最小化只授权完成任务必需的工具遵循最小权限原则四、子代理配置核心参数详解YAML Frontmatter五、主代理调用子代理的完整工作流Mermaid示意图用户需求开发带GIS功能的电商平台主Agent基于SPEC生成PLAN任务拆解1.架构设计 2.后端开发 3.GIS数据处理 4.安全审计调用子Agent1architecture-designer 负责架构设计调用子Agent2backend-developer 负责后端开发调用子Agent3gis-data-processor 负责GIS功能调用子Agent4security-auditor 负责安全审计并行执行独立上下文窗口返回结果摘要给主Agent主Agent整合结果验证SPEC输出最终代码文档六、与现有技术的联动最佳实践6.1 结合 SPEC/PLAN 流程SPEC阶段子代理作为验收专家验证需求边界和标准PLAN阶段将任务精准分配给对应子代理实现专业分工执行阶段子代理并行执行主Agent专注整合与验收收尾阶段子代理自动生成测试用例和文档确保符合SPEC6.2 结合 Agentic RAG子代理内置RAG能力专注特定领域知识检索主Agent负责全局规划子代理负责专业领域信息挖掘只给子代理核心入口和搜索工具遵循渐进式披露原则6.3 结合渐进式披露子代理描述只放核心职责详细规则独立成文件工具采用延迟加载子代理需用时再搜索完整文档避免一次性传递全量信息保持上下文轻量化七、避坑指南常见问题与解决方案问题原因解决方案子代理不自动调用描述模糊、职责过多简化描述一个子代理只负责一项任务上下文污染子代理返回完整内容确保子代理只返回结果摘要不传递原始数据执行效率低工具过多、模型选择不当精简工具集复杂任务用高性能模型权限问题子代理无必要工具权限检查tools配置遵循最小权限原则结果不符合预期系统提示不明确优化子代理提示词加入详细执行步骤八、实战案例全栈项目中的子代理协作需求开发带地理定位功能的电商后台创建子代理api-designer设计RESTful APIdb-expert数据库设计与优化gis-processor地理数据处理security-reviewer安全审计test-writer生成测试用例SPEC→PLAN→执行流程# 第一步生成SPEC 先输出完整SPEC明确API接口、数据库结构、GIS功能标准 # 第二步生成PLAN 基于SPEC生成包含5个子代理分工的执行计划 # 第三步执行 主Agent自动调度子代理并行执行每完成一步返回摘要 # 第四步验收 主Agent调用verifier子代理对照SPEC逐条验证关键命令# 显式调用安全审计子代理 /subagent --namesecurity-reviewer 审查用户认证模块的JWT实现 # 在PLAN中指定GIS子代理 PLANGIS功能由gis-processor子代理负责完成后返回数据接口文档九、总结子代理是AI编程IDE的分身术通过独立上下文专业分工并行执行大幅提升开发效率和代码质量。核心要点创建手动文件更灵活/agents命令更便捷调用自动调用提效率显式调用保精准配置描述清晰、工具精简、职责单一联动与SPEC/PLAN、Agentic RAG、渐进式披露深度融合记住给AI最小必要信息自主探索能力它反而能发挥出远超预期的潜力——这正是Claude Code渐进式披露设计哲学的核心价值。需要我提供一套可直接复制的子代理模板含API设计、GIS处理、安全审计等常用场景和对应的SPEC/PLAN提示词吗