项目结构分析

问题

接手陌生项目时，目录树、配置文件、构建脚本和核心入口混在一起，尤其存在 node_modules、dist、.git 等噪音目录。人工阅读源码成本高，难以快速判断项目类型、技术栈、分层职责和启动方式。

工作方式

该技能将项目信息压缩为结构化分析，而不是直接转述源码。输入可以是目录列表、源码片段或目录截图。它会执行以下工作：

• 识别项目类型：判断前端、后端、全栈、小程序、桌面端等，并推断 Vue/React、Java/Spring、Node.js、Python 等技术栈。
• 生成精简目录树：过滤 node_modules、dist、build、.git 等缓存、构建和版本控制目录，保留对理解架构有用的核心目录。
• 解析分层与关键文件：说明各层职责，定位入口、路由、配置、业务模块等文件。
• 给出启动建议：整理最简运行步骤和结构优缺点，并给出针对性优化方向。

适用边界

它适合用于初步熟悉项目骨架，适合 code review 前、接手旧项目、评估技术栈或编写项目说明。分析质量取决于输入信息完整度：目录列表和核心源码片段越多，判断越稳；仅有模糊截图时，关键文件和启动步骤可能偏推断。它不会替代阅读源码，也不能保证覆盖所有私有构建约定。