需要快速理解大型陌生代码库时，用并行 explore…

在接手新项目、梳理架构或排查跨层关注点时，把代码库拆成多个逻辑区域并同时启动只读探索子代理，快速拼出全貌。

适用场景

解决思路

1. 把代码库拆成若干逻辑区域，典型全栈应用可分为：前端（组件、页面、路由、状态管理）、后端（API 路由、数据库模型、中间件、鉴权）、基础设施（CI/CD、Docker、部署配置）、共享层（类型、工具函数、常量）。
2. 为每个区域各启动一个 explore 子代理：使用 Task 工具并设置 subagent_type: "explore"，在一条消息里同时发起全部任务以并发执行。
3. 给每个子代理写明确的探索指令，指明要查找的内容和要检查的目录，例如前端任务："Explore the frontend — find the main pages, routing setup, state management approach, and UI component library. Check src/app/, src/components/, src/pages/. Report the framework, router, styling approach, and key components."
4. 后端任务示例："Explore the backend — find the API routes, database setup, ORM, auth middleware, and data models. Check src/server/, src/api/, lib/, prisma/. Report the framework, database, auth strategy, and key endpoints."
5. 基础设施任务示例："Explore the infrastructure — find CI/CD config, Docker setup, deployment targets, and environment variable management. Check .github/, docker*, *.config.*, .env*. Report the deploy target, CI provider, and any IaC."
6. 所有子代理返回后汇总结果，形成连贯认识：技术栈总结（前端、后端、数据库、基础设施）、架构图（描述数据流）、关键文件与入口点、潜在问题或技术债。
7. 跨层调查场景：例如查"用户鉴权在哪里校验"，可同时启动子代理分别搜索前端（路由守卫）、后端（中间件）、数据库（会话存储）。
8. 依赖审计场景：启动多个子代理分别检查依赖树的不同部分，查找过时包、安全问题、未使用的 import。
9. 迁移规划场景：让子代理同时评估前端、后端和测试，估算框架迁移的工作量范围。
10. 在提示词中使用 thoroughness: "very thorough" 以获得更全面的分析。
11. 利用每个子代理独立的上下文窗口，让它们各自读取大量文件而不会超出空间。
12. 若只是单个聚焦问题，直接用 Grep 或 SemanticSearch，不要用子代理。

适用边界 · 注意事项

• 只是单个聚焦的小问题——直接用 Grep 或 SemanticSearch 即可，子代理适合广泛探索。
• 需要修改文件的场景——explore 子代理是只读的，无法改动代码。