- name
- project-deep-analyzer
- description
- 深度分析项目的系统边界、核心概念、模块架构、关键算法、技术选型以及错误排查。当用户需要深入理解代码库或定位疑难问题时调用。
Project Deep Analyzer
本技能提供了一套结构化的方法论，用于深度剖析和理解任何规模的软件项目。它通过六个核心维度引导用户或 AI 进行全方位的项目审计。
核心分析流程
1. 系统边界分析 (System Boundary)
明确项目的外部交互和运行环境。
- 项目目标：核心解决什么问题？
- 运行环境：支持哪些平台（macOS/Linux/Windows）？
- 对外接口：提供哪些 CLI、API 或 SDK？
- 技术栈：核心语言、框架、数据库及外部服务。
- 安装与使用：前置条件、依赖项及启动步骤。
2. 核心概念体系 (Core Concept System)
提取项目中的关键领域模型和术语。
- 术语清单：列出项目中的所有关键术语。
- 定义与动机：每个概念的定义及其存在的原因。
- 关系图谱：层级、依赖或组合关系。
- 核心 vs 辅助：区分核心业务逻辑和周边支持工具。
- 代码映射：概念在代码结构中的具体位置。
3. 模块架构分析 (Module Architecture)
拆解项目的物理和逻辑组织。
- 目录结构：模块的物理划分。
- 职责划分：每个模块的核心职责和边界。
- 依赖关系：模块间的耦合度和调用链。
- 代码度量：行数、文件数及其揭示的开发重心。
- 解耦建议：识别可独立拆分的模块和强耦合点。
4. 核心算法分析 (Core Algorithm)
深入理解项目的逻辑心脏。
- 算法清单：项目使用的关键算法及其作用。
- 性能评估：时间/空间复杂度及限制。
- 数据结构：算法的输入输出及核心数据流动。
- 源码定位：算法的具体实现文件和函数。
5. 技术选型评估 (Technical Selection)
反思设计决策的合理性。
- 自研 vs 第三方：哪些部分是自研的？是否有更好的替代方案？
- 必要性审查：自研部分是否存在过度设计？
- 重构建议：如果重新设计，哪些组件应该保留或替换？
- 知识沉淀：项目中值得吸收的技术亮点或算法。
6. 错误排查与分析 (Error Handling)
结构化定位和修复问题。
- 日志定位：通过错误日志定位具体的文件和函数。
- 链路追溯：分析完整的调用栈（Stack Trace）。
- 根本原因：解释错误发生的深层原因。
- 修复方案：提供具体的修复代码或配置建议。
使用场景
- 新项目接手：快速建立对陌生代码库的全局视野。
- 架构审计：识别现有项目中的设计缺陷或优化空间。
- 技术调研：分析开源项目的实现原理，评估其是否适合集成。
- 复杂 Bug 定位：通过结构化的调用链路分析解决疑难杂症。