file-analysis
映射代码库文件结构与模块组织
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：file-analysis。 它的用途是：映射代码库文件结构与模块组织 完整的 Skill 内容见：https://321skill.com/skills/file-analysis-x-7/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'分析当前项目的文件结构和模块依赖关系，生成一个树形图并标记出被引用最多的核心模块。' 它会扫描项目目录，解析所有源文件中的导入语句，输出一个带有依赖统计的文件树，并高亮显示被其他模块引用超过5次的核心模块及其依赖链路。
介绍
在架构审查、重构规划或迁移范围评估前，开发者需要快速理解代码库的整体文件结构和模块间的组织关系。传统的手动浏览文件树方式效率低，且容易遗漏关键依赖。本工具通过自动扫描代码库，解析源文件中的导入语句和模块引用，生成结构化的映射，帮助开发者快速掌握全局脉络，避免遗漏依赖链路。
使用方式简单：在项目根目录下运行命令，即可输出文件树和模块依赖关系图（文本或可视化）。工具自动识别常见编程语言（如JavaScript/TypeScript、Python、Java、Go等）的模块系统，支持包管理器配置、入口文件检测，以及模块间引用关系的统计与层级展示。
适合全栈开发、后端开发以及智能体开发等需要频繁进行代码评审、重构或迁移的开发者。尤其适合大型项目或微服务架构中，在动手修改代码前先获得一份结构化的“代码地图”，降低引入Bug的风险。
建议在首次接触新项目或进行架构评审时优先使用。注意：对于动态语言（如Python）中运行时动态导入的模块，静态分析可能无法完全覆盖，需结合运行时日志或手动验证。同时，该工具不适合用于实时监控文件变更或分析动态加载的远程模块。
核心特点
与其他文件树工具不同，本工具不仅列出文件列表，还能解析模块间的导入依赖关系，生成层级化的模块组织图，便于理解架构边界和核心模块的耦合度。
注意事项
不适合分析动态语言中运行时反射加载的模块，也不适合实时监控文件变更。
常见问题
支持哪些编程语言？
支持常见的静态分析友好的语言，如JavaScript/TypeScript、Python、Java、Go、Rust等，对于动态导入较多的语言准确率可能下降。
能输出可视化的模块关系图吗？
默认输出文本树和依赖列表，也支持导出为JSON或Mermaid格式，可用其他工具转为可视化图形。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/file-analysis-x-7/raw/index.md 读取 file-analysis 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/file-analysis-x-7/raw/index.md（查看排版版本）