SuperAPI AI 工具集

project-reader

通用与其它

查看项目

更新于 10-16 10:22

技能介绍

用途:project-reader 是一个项目结构分析技能,用于快速理解陌生前端/全栈项目的技术栈、目录结构和模块依赖关系,适合接手新项目、技术调研、代码审查、重构准备或学习开源项目。

主要能力:采用分层阅读工作流。第 1 层框架检测,可识别 React、Vue、Angular、Next.js、Nuxt、Svelte、SvelteKit、Gatsby、Remix 等框架,以及 UI 库、构建工具、包管理器、入口文件和项目元信息;第 2 层分析目录树(最大深度 5 层)、文件类型分布、关键目录与配置文件;第 3 层提取 import/require 关系,统计核心模块、检测循环依赖并列出模块;第 4 层根据报告从入口文件开始阅读核心模块。

使用方式:先进入技能目录,再运行报告脚本: cd /home/luckxp/.agents/skills/project-reader python scripts/generate_report.py /path/to/project 也可指定输出文件: python scripts/generate_report.py /path/to/project -o report.md 如需逐层分析,可分别运行: python scripts/detect_framework.py /path/to/project python scripts/analyze_structure.py /path/to/project python scripts/analyze_dependencies.py /path/to/project

支持文件类型:JavaScript、TypeScript、Vue、Python。依赖分析输出包括每个文件的依赖列表、按频率排序的核心模块、循环依赖和完整模块列表。

限制:资料未提供安装步骤、运行环境版本要求、授权许可与收费信息;未说明对非前端/全栈项目的支持情况。建议从快速开始入手,再按需深入各层。