用途:在陌生仓库中建立结构地图并定位相关代码。适用于新仓库/新模块上手、回答“X 在哪里”“Y 怎么工作”,以及在实现功能前寻找入口点与依赖。
主要能力与流程:先看仓库根目录的 README、CONTRIBUTING、许可证与依赖/清单文件(package.json、requirements.txt、go.mod、Cargo.toml),记录语言、框架、主脚本和顶层目录(app/、src/、lib/、tests/、docs/、scripts/);再找入口点(如 index.js、main.py、cmd/server、Next.js app 目录、Django ROOT_URLCONF),从入口跟到路由、服务、数据库等子系统;借助 *Controller、*Service、*Repository、api/、components/、hooks/、handlers/ 等命名约定和领域词搜索推断用途;对关注区域追踪导入与被导入关系,用搜索构建最小调用链(如“Route → Handler → Service → Repository”);查看测试与配置/环境文件以确认用法和边界;最后产出简短结构地图与后续步骤建议。
按问题类型处理:“X 在哪”搜领域词与同义词,查路由、处理器、入口和测试;“Y 怎么工作”从入口追输入到存储/外部,3–5 步总结;“Z 加在哪”找同类功能所在层并推荐文件与模式;“结构是什么”列出顶层目录与主要子系统。
限制与规则:优先读代码和配置而非猜测,使用项目自身的术语与模块名;大型仓库不宣称完整,只说“就已探索区域而言”并建议下一步查看位置;不要用单个文件描述整个系统,不要套用“典型 MVC”等臆测结构。
本技能的具体安装命令、运行环境要求、是否收费或价格信息暂未提供。