该技能用于系统性地理解代码库、识别架构模式并梳理系统结构,适用于接手新代码库、在改动前理解不熟悉的代码、调查功能实现方式、映射模块依赖与识别所用架构模式。
其核心是五层发现流程:第一层表层扫描,定位入口文件(main.、index.、app.、server.、cmd/、src/main/、bin/ 脚本)与配置文件(package.json、Makefile、Taskfile、Docker/Compose、CI/CD 配置),并梳理目录结构;第二层依赖映射,分析各生态包管理文件(package.json、requirements.txt/pyproject.toml、go.mod、Cargo.toml、pom.xml/build.gradle)并从入口追踪导入关系,划分表现层、应用层、领域层与基础设施层;第三层架构识别,依据 controllers/models/views、ports/adapters、services/docker-compose、functions/handlers 等特征判断 MVC、六边形、微服务、单体或 Serverless;第四层流程追踪,对 Web 应用按请求到路由、中间件、控制器、服务、仓储、数据库的顺序追踪端到端路径,前端则分析状态存放位置、数据流向与重渲染触发条件;第五层质量评估,检查测试覆盖、依赖版本、文档、构建时间、错误处理,并识别 TODO/FIXME、被禁用测试、超长函数、深层嵌套、重复代码与硬编码等技术债标记。
按目标可裁剪分析范围:修 Bug 时定位现象、回溯根因、只理解受影响区域并检查相关测试;加功能时寻找相似既有功能、沿用其模式、确定需改动的模块与集成点;全面理解时执行完整五阶段并记录架构决策。大型代码库可按模块并行分析,再汇总为统一架构视图。文档还提供快速架构摘要与上手清单模板,并提醒避免分析瘫痪、忽视测试、跳过配置、停留在目录结构和仅凭命名臆测模式。具体安装或调用方式暂未提供。