用途:对新项目或既有代码库做系统化分析,理解项目结构、技术栈、依赖、架构模式、代码复杂度与质量指标,并识别关键组件及关系。适用于新项目启动、架构决策前、重构规划、代码审计或新人上手等场景。
主要能力:分阶段推进。发现阶段读取 package.json、tsconfig.json、框架配置,用 LS/Glob 映射目录(源码、测试、配置、文档、构建产物)并扫描重要文件;技术栈阶段提取 dependencies/devDependencies、脚本与 Node 版本,识别 Next.js、React、Vue、Svelte、Angular 及状态管理、路由、UI、样式、测试、构建工具;架构阶段用 Glob/Grep 分析组件命名与文件结构、API 路由、数据库查询、鉴权与状态管理模式,并区分 monorepo、按功能或按分层组织;质量阶段检查 lint/format 配置、测试文件与覆盖率、TypeScript 严格度、TODO/FIXME、console 日志、超大文件等;依赖阶段检查锁文件,运行 npm audit --json、pnpm audit --json、npm outdated。最后按固定结构输出报告:项目概览、技术栈、架构与目录树、质量指标、建议、风险区与下一步。
使用方式:随技能调用执行;关键命令如 npm run lint、npm run test:coverage、npm audit --json、pnpm audit --json、npm outdated 保持原样。建议渐进式细化,大代码库分块分析,优先用 Glob 查找文件、Grep 搜索模式、Read 只读关键文件,典型项目尽量在 60 秒内完成,并给出可执行建议。可与质量门禁、项目初始化、安全重构及相关框架技能配合。
限制:资料未提供具体平台支持、收费与价格信息;部分步骤依赖已安装的 npm/pnpm 等环境,缺失依赖时需先安装,文件损坏或权限不足时只能部分分析或切换定向分析模式。