项目入职与架构探索

解决什么问题

接手陌生代码库时，常见问题不是读不懂单行代码，而是一开始找不到入口：项目类型、技术栈、启动方式、配置位置、测试命令、部署线索都散落在 package.json、pom.xml、Dockerfile、README.md 和目录结构里。新成员容易凭感觉翻文件，遗漏环境变量、构建脚本或团队 Git 约定，导致第一次运行失败或误改关键配置。

技能如何工作

这个项目入职指南把“上手一个新项目”拆成可执行检查清单，而不是泛泛建议。核心流程包括：

• 识别项目类型与入口：判断是 Web、后端、移动端还是库，找到启动脚本和主入口。
• 分析技术栈：从 package.json、build.gradle、go.mod、requirements.txt 等文件提取语言、框架、依赖和构建工具。
• 梳理目录结构：确认源码、测试、静态资源、配置文件的位置，避免把工具目录误当成业务代码。
• 定位关键配置：查找 .env.example、config.sample.yml、CI 配置、Dockerfile、部署脚本，理解运行时依赖。
• 验证可运行状态：优先运行测试套件，再尝试本地启动，用测试结果判断项目健康度。

它还会提供 analyze_project.py 和 tech_stack_detector.sh 这类脚本，用于自动收集项目信息、识别技术栈并生成报告。适合在本地先做一次结构化梳理，再带着具体问题去读核心代码。

适用边界

这个技能更适合新项目的第一轮探索，不能替代与团队沟通，也不能覆盖高度自定义的内部平台、私有构建系统或安全敏感配置。涉及生产环境密钥、权限和基础设施时，应遵循团队规范，不要直接猜测或复制示例配置。对于大型单体项目，它可以帮助建立全局地图，但仍需要结合代码审查历史、架构文档和实际业务上下文来判断模块边界。