用途：对项目代码库进行系统化分析，理解项目结构与组织、技术栈与依赖、架构模式与约定、代码复杂度与质量指标，以及关键组件及其关系。
何时使用：接手新项目时；用户要求“分析”“审查”“审计”或“理解”代码库时；做架构决策前；规划重构或重大变更时；新人熟悉代码时。
主要能力（分阶段）：
- 发现：读取 package.json、tsconfig.json 等配置判断项目类型，映射目录结构（源码、测试、配置、文档、构建产物），扫描构建配置、TypeScript 配置、包管理、环境文件与 Git 配置。
- 技术栈分析：从 package.json 提取运行依赖、开发依赖与脚本，识别框架（Next.js、React、Vue、Svelte、Angular）及状态管理、路由、UI 库、样式、测试与构建工具。
- 架构模式分析：查找组件文件分析命名与文件结构，检索 API 路由、数据库查询与鉴权代码，识别状态管理方式与文件组织（monorepo、按功能、按层）。
- 代码质量评估：检查 ESLint、Prettier、Biome 配置，测试文件与覆盖率，TypeScript 严格性，标记大文件、深嵌套、TODO/FIXME、console 日志。
- 依赖与安全分析：检查锁文件，运行 npm audit --json 或 pnpm audit --json，以及 npm outdated。
输出：结构化分析报告，含项目概览、技术栈、架构与目录结构、代码质量指标、建议、风险领域与后续步骤。
使用要点：从高层概览逐步深入；大型代码库按目录或功能分块分析；用 Glob 与 Grep 提升效率，仅读取关键文件。
限制与错误处理：资料未提供收费标准；若依赖缺失，建议运行 npm install；文件损坏时报告具体文件并部分分析；代码库过大时切换为定向分析；权限不足时请求文件访问权限。