代码库文件结构分析

技能文档

---
name: file-analysis
title: 代码库文件结构分析
category: 开发工具
description: 快速摸清代码库的文件组织与结构热点，为架构评审、重构或迁移的范围评估提供结构上下文。识别项目类型、目录布局、语言分布、大文件与深层嵌套等复杂度热点。当用户要求分析项目结构、梳理代码库目录、评估重构范围、架构评审前摸底时触发。触发词：项目结构、代码库分析、目录梳理、架构摸底、重构评估。
---

# 代码库文件结构分析

## 适用场景

- 架构评审前了解模块边界与文件组织
- 接手陌生代码库时先梳理整体结构再动手
- 为重构或迁移工作估算范围

## 不适用场景

- 一般性的代码探索（直接浏览代码即可）
- 检索特定代码模式（直接使用文本搜索）

## 技能工作流

按以下四个步骤执行，每完成一步记录对应结论，全部完成后输出结构报告。

### 步骤1：确认分析根目录

- 用 `pwd` 确认分析根目录
- 记录 monorepo 边界、工作区根或子项目路径
- 从清单文件（`package.json`、`Cargo.toml`、`pyproject.toml` 等）识别项目类型（语言、框架）

### 步骤2：梳理目录结构

- 运行 `tree -L 2 -d` 或 `find . -type d -maxdepth 2` 捕获顶层目录布局
- 识别标准目录：`src/`、`lib/`、`tests/`、`docs/`、`scripts/`、`configs/`
- 记录可能影响后续分析的非标准组织方式

### 步骤3：识别语言与文件分布

- 用 `find . -name "*.ext" | wc -l` 按扩展名统计文件数
- 识别主导语言及其文件分布
- 标注配置文件、生成文件与第三方依赖目录
- 用 `wc -l $(find . -name "*.py" -o -name "*.rs" | head -20)` 抽样统计文件规模

### 步骤4：标记热点

- 识别超大文件（潜在「上帝对象」）：`find . -type f -exec wc -l {} + | sort -rn | head -10`
- 标记嵌套过深的目录（复杂度信号）
- 记录命名或放置位置异常的文件

## 输出要求

- 每一步都给出具体的观察结论，不写空话
- 为后续工作流（架构评审、重构）提供结构上下文
- 文件统计、目录布局与热点清单以清单形式留存备查

## 常见问题

| 问题 | 处理方式 |
|------|----------|
| 命令不存在 | 确认依赖工具已安装并在 PATH 中（如 `tree`，缺失时改用 `find` 等价命令） |
| 权限错误 | 检查文件权限，必要时用有权限的账号运行 |
| 目录过大导致命令超时 | 限制 `find` 的 `-maxdepth`，或排除 `node_modules`、`vendor` 等目录 |

使用说明

# 代码库文件结构分析

快速摸清代码库的文件组织、语言分布与复杂度热点，为架构评审和重构提供结构上下文。

## 使用

```text
分析一下这个项目的目录结构和大文件热点
```

```text
架构评审前先做一遍文件结构摸底
```

## 工作原理

四步流程：确认分析根目录 → 梳理目录结构 → 识别语言与文件分布 → 标记大文件与深层嵌套热点，全程只用 `find`、`wc`、`tree` 等标准命令，输出结构化观察结论。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。