📌 analyze-project 是什么？
接手一个陌生项目，最怕的是"看不懂"——目录为什么这么分、依赖之间什么关系、核心逻辑在哪、哪里是坑。硬啃代码又慢又容易漏。analyze-project 是 RigorPilot 系列的技能，让 AI 帮你把项目结构、依赖、技术栈系统梳理一遍，快速建立全局认知。
它的价值在"快"和"全"：不用你一个个文件去翻，AI 会从入口、配置、模块划分、依赖关系几个维度切入，给你一张项目地图。有了这张图，再去看细节、改代码、加功能，就不容易迷路。
这个技能尤其适合那些没有文档、或者文档已经过时的老项目——现实里这种项目才是大多数。
🧩 核心功能
结构梳理：理清目录结构、模块划分、各模块职责。
依赖分析：梳理依赖关系，识别核心依赖和潜在冲突。
技术栈识别：识别语言、框架、构建工具、中间件等。
入口定位：找到项目入口、启动方式、关键配置。
风险提示：指出结构混乱、循环依赖、过度耦合等隐患。
交接文档：把分析结果整理成一份可读的项目说明。
👍 优点
上手快：陌生项目几轮对话就能摸清大概。
系统：不只罗列文件，还讲清模块之间的关系。
可沉淀：分析结果能直接当交接文档用。
⚠️ 不足与局限
运行时行为、隐藏的坑仍需实际运行和调试才能发现。
对超大型 monorepo，一次分析可能不够细，需分模块深入。
分析依赖配置推导，个别动态加载的依赖可能漏判。
🙋 适合谁用
新入职工程师：快速熟悉代码库。
接手老项目的开发者：没有文档也能快速上手。
技术负责人：评估项目健康度、做重构决策。
外包/接手方：项目交接时快速了解全貌。
🛠️ 第一次安装
前提：电脑装了 Node.js（18+），有支持 Skill 的 AI 工具（如 Claude Code）。打开终端执行：
CLI 会自动检测你装的 AI 助手，确认安装位置后即可使用，装完可以用 npx skills list 确认它在列表里。
✍️ 上手：几个真实例子
场景一：接手陌生项目
场景二：评估重构
场景三：写交接文档
🎯 典型应用场景
新人入职：快速建立对代码库的认知。
项目接手：无文档项目快速上手。
重构前评估：摸清现状再动手。
技术选型审查：了解现有技术栈和依赖。
⚖️ 和类似方案对比
相比 grep 搜关键字、或逐个文件看，analyze-project 的优势是"结构化"——它把零散的信息拼成一张完整的地图，还顺带指出耦合、循环依赖这些靠肉眼不容易发现的问题。它不是替代你读代码，而是让你读代码的效率高一个量级。
💡 常见问题 FAQ
问：分析结果准吗？
结构和静态依赖分析通常较准，但运行时行为、配置生效等动态信息需要实际验证。
问：大项目怎么分析？
可以让 AI 先给全局视图，再按模块逐个深入。
问：会改我的代码吗？
不会，它只读和分析，不做修改。
问：能分析什么语言？
主流语言和框架都能分析，冷门的可能覆盖不全。
🤖 适合哪些 AI 工具
Claude Code、Cursor、Codex、GitHub Copilot 等支持 Skill 的工具都能装。
◯ 评论 0