file-analysis
映射代码文件结构与模块组织，辅助架构评审
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：file-analysis。 它的用途是：映射代码文件结构与模块组织，辅助架构评审 完整的 Skill 内容见：https://321skill.com/skills/file-analysis-x-8/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'使用 file-analysis 分析当前项目，输出模块依赖关系图'，它会扫描项目目录，生成 JSON 格式的依赖树并高亮显示循环依赖。你也可以指定只分析 src 目录下的 Python 文件，排除测试文件：'file-analysis --dir src --lang python --exclude test'。
介绍
在代码库日益庞大时，开发者往往难以快速理解文件之间的依赖关系和模块边界。该 Skill 能自动扫描整个项目，生成清晰的目录树与模块层级图，帮助你在数秒内掌握代码库的全貌，避免因“只见树木不见森林”而做出错误的架构决策。
使用方式极其简单：只需在项目根目录下运行一条命令，Skill 便会递归遍历所有文件，识别模块间 import/require 关系，并输出结构化的 JSON 或可视化的树形图。你还可以通过参数过滤特定目录、排除测试文件，或指定关注的语言（如只分析 Python 或 TypeScript）。
最适合的人群是后端开发、全栈开发以及项目经理——尤其是在进行架构评审、重构规划、迁移范围评估或接手遗留代码时。即使是刚加入项目的新人，也能用它快速定位核心模块，缩短上手时间。
建议在每次大规模重构前先运行一次，保存当前结构快照，方便对比变更后的差异。注意：该 Skill 仅分析静态文件结构和模块引用，不涉及运行时行为或性能数据，因此不能替代动态分析工具。
核心特点
与 tree 或 cloc 等仅列出文件路径的工具不同，该 Skill 能解析模块间的引用关系（如 Node.js 的 require、Python 的 import），并输出有向图，让你一眼看出哪些模块是高耦合的“上帝类”。
注意事项
不适用于运行时性能分析、动态代码执行路径追踪或非文本二进制文件的结构分析。
常见问题
如何安装 file-analysis？
通过 npm 全局安装：npm install -g file-analysis，然后在项目目录下运行 file-analysis 命令即可。
支持哪些编程语言？
默认支持 JavaScript、TypeScript、Python、Java、Go 等常见语言，可通过插件扩展。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/file-analysis-x-8/raw/index.md 读取 file-analysis 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/file-analysis-x-8/raw/index.md（查看排版版本）