project-analyzer

name	project-analyzer
description	深度分析现有项目代码和文档，总结功能与交互，生成结构化文档目录（产品介绍、技术文档、架构、数据模型等），并深入分析代码结构以支持新项目创建和重构。

项目分析器

概述

本项目分析器技能旨在深入理解现有软件项目，通过自动化分析项目代码和相关文档，提取核心功能、用户交互模式、技术栈、系统架构、数据模型等关键信息。最终生成一套结构化、详尽且易于理解的中文文档，旨在赋能团队快速理解项目、指导新项目开发、或为现有项目重构提供坚实基础。

此技能特别注重对代码结构的深度分析，识别项目分层、模块职责，为理解复杂内部系统提供清晰视角，对重构和维护至关重要。

何时使用此技能

• 在接手一个新项目时，需要快速了解其功能、技术和结构。
• 需要为现有项目创建全面的产品文档和技术文档。
• 计划重构现有项目，需要深入理解其代码架构和分层。
• 需要向新团队成员或非技术人员介绍项目全貌。
• 需要从现有项目中提取可复用的设计模式或架构思想。
• 作为新项目启动的参考蓝图。

核心功能与能力

1. 项目全景分析: 扫描整个项目目录，识别代码文件、文档、配置文件等。
2. 功能与交互总结: 从代码注释、文档和文件结构中推断并总结项目的主要功能模块及其用户交互流程。
3. 结构化文档生成:
   • 产品介绍: 详尽的产品概述、目标用户、核心价值、功能列表等。
   • 技术文档:
     • 系统架构: 宏观架构图、关键组件及其交互。
     • 技术栈: 使用的编程语言、框架、库、数据库、中间件等。
     • 前后端技术: 分别介绍前端技术选型、模块划分，后端服务、API 接口定义。
     • 数据模型: 核心实体关系图（ERD）、关键数据表结构及字段说明。
   • 代码结构分析: 详细描述项目的分层、模块组织、代码规范、重要设计模式等。
4. 代码结构深度理解:
   • 识别项目内的代码分层（如：控制器、服务、持久层、领域模型）。
   • 分析各层级之间的依赖关系和职责边界。
   • 提取重复的代码模式或架构决策。
   • 生成关键代码模块的概览，包含文件路径、简要功能。

如何使用此技能

此技能通过执行核心分析脚本来运作，并辅以多种参考资料和输出模板。

第 1 步：分析项目并生成初始文档结构

执行 analyze_project.py 脚本，指定目标项目路径。此脚本将遍历项目，进行初步分析，并生成一个包含主要文档目录和占位符文件的 docs 目录。

python scripts/analyze_project.py --project-path /path/to/your/project --output-dir ./generated_docs

参数说明: