mcpField
P
parallel-exploring

parallel-exploring

github.com/spencerpauly开发868465 次安装13 周前更新
代码仓库

关于 parallel-exploring

这是一项 Cursor 技能,通过并行只读子 Agent 探索大型或陌生代码库,适合项目熟悉和跨层调查,并汇总架构与关键文件信息。

主要功能

  1. 01并行探索代码库
  2. 02只读 explore 子 Agent
  3. 03按代码库区域拆分任务
  4. 04汇总架构与关键文件

适用场景

  1. 01熟悉陌生项目
  2. 02跨层追踪功能实现
  3. 03调查横向问题

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/spencerpauly/awesome-cursor-skills --skill parallel-exploring

安装后在 Claude Code 中输入/parallel-exploring确认已加载。

详细介绍

并行探索

当你需要快速了解大型或不熟悉的代码库时,可以使用此技能,例如熟悉新项目、调查跨多个层级的功能实现,或梳理架构。

工作原理

Cursor 的 explore 子 Agent 是一种快速、只读的 Agent,专为搜索和阅读代码而优化。你可以在一条消息中启动多个 explore Agent,它们会并发运行,各自调查不同的区域。

步骤

  1. 确定要探索的区域 — 将代码库划分为逻辑区域。对于典型的全栈应用:

    • 前端:组件、页面、路由、状态管理
    • 后端:API 路由、数据库模型、中间件、身份验证
    • 基础设施:CI/CD、Docker、部署配置
    • 共享部分:类型、实用程序、常量
  2. 并行启动 explore Agent — 针对每个区域,使用 Task 工具并设置 subagent_type: "explore"。在一条消息中启动它们:

    Task 1: "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."
    
    Task 2: "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."
    
    Task 3: "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."
    
  3. 综合结果 — 等所有 Agent 返回后,将发现整合为清晰的概述:

    • 技术栈概述(前端、后端、数据库、基础设施)
    • 架构图(描述数据流)
    • 关键文件和入口点
    • 潜在问题或技术债务

其他用例

  • 跨领域调查:“在哪里检查用户身份验证?” — 同时启动多个 Agent,分别搜索前端(路由守卫)、后端(中间件)和数据库(会话存储)。
  • 依赖项审计:启动多个 Agent,分别检查依赖树的不同部分,查找过时的软件包、安全问题和未使用的导入。
  • 迁移规划:让多个 Agent 同时评估前端、后端和测试,以估算框架迁移的范围。

注意事项

  • Explore Agent 为只读,无法修改文件。
  • 如需全面分析,请在提示词中使用 thoroughness: "very thorough"。
  • 每个 Agent 都有自己的上下文窗口,因此可以分别阅读许多文件而不会耗尽空间。
  • 对于单个、聚焦的问题,直接使用 Grep 或 SemanticSearch 即可 — 子 Agent 适用于广泛探索。

评论

支持 Markdown