file-analysis
映射代码库文件结构与模块组织
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:file-analysis。 它的用途是:映射代码库文件结构与模块组织 完整的 Skill 内容见:https://321skill.com/skills/file-analysis-x-4/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'分析当前项目的文件结构和模块依赖关系,生成架构概览图。' 它会扫描所有源文件,识别目录层级和模块之间的导入关系,输出类似文件树并标注依赖链,帮助快速理解项目整体架构。
介绍
在架构审查、重构规划或迁移范围评估前,快速理解代码库的整体结构至关重要。该Skill自动扫描项目目录,识别文件层级、模块划分以及它们之间的依赖关系,生成清晰的架构概览,帮助开发者从宏观视角把握代码组织方式。
使用时,只需指定项目根路径,它会递归遍历所有源文件,识别模块导入/导出语句,构建模块依赖图,并以文本或可视化形式输出。支持常见编程语言(如JavaScript、Python、Java、Go等),并自动忽略非代码文件。
适合后端开发、全栈开发者、技术负责人和项目经理,尤其在进行大型代码库重构、技术债务清理、新成员快速上手项目时作用显著。也可用于评估迁移成本,确定影响范围。
注意:该Skill为静态分析,不执行代码或运行时分析,因此无法检测动态导入或反射调用。对于超大项目(如超过10万文件),建议先排除无关目录。
核心特点
与普通的文件树列举工具不同,该Skill同时解析模块间的引用关系并生成依赖图,而不仅仅是目录结构,适合架构评审和影响范围分析。
注意事项
不适用于动态语言运行时加载的模块或需要执行代码才能确定的依赖关系。
常见问题
支持哪些编程语言?
支持JavaScript/TypeScript、Python、Java、Go、C#等主流语言,通过解析导入语句自动识别模块关系。
能生成可视化架构图吗?
可以输出文本树形结构,也可导出为Graphviz DOT格式,方便生成图片。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/file-analysis-x-4/raw/index.md 读取 file-analysis 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/file-analysis-x-4/raw/index.md(查看排版版本)