文件结构分析

技能文档

---
name: athola-file-analysis
description: 文件结构分析。为下游的架构评审与重构工作流提供结构性上下文：识别项目根与工程类型、绘制目录布局、统计文件分布、定位复杂度热点。当用户在架构评审前需要了解文件组织、探索陌生代码库需先摸清结构、或为重构/迁移估算范围时触发。
title: 文件结构分析
category: 开发工具
---

# 文件结构分析

## 适用场景

- 架构评审前，了解模块边界与文件组织
- 探索陌生代码库时，先摸清整体结构再动手修改
- 为重构或迁移工作提供范围估算依据

## 不适用场景

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

## 技能工作流

### 步骤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` 按扩展名统计文件数
- 识别主导语言及其文件占比
- 记录配置文件、生成文件与第三方 vendored 依赖
- 用 `wc -l $(find . -name "*.py" -o -name "*.rs" | head -20)` 抽样统计文件大小

### 步骤4：标记复杂度热点

- 识别大文件（潜在「上帝对象」）：`find . -type f -exec wc -l {} + | sort -rn | head -10`
- 标记层级过深的目录（可能意味着复杂度过高）
- 记录命名规范或存放位置异常的文件

## 完成标准

- 每一步都有具体的观察结论
- 下游工作流（架构评审、重构）已获得结构性上下文
- 文件统计、目录布局与热点清单已归档备查

## 常见问题

**命令不存在**：确认依赖已安装且在 PATH 中。

**权限错误**：检查文件权限，必要时用适当权限运行。

**结果异常**：为脚本开启详细输出（如 `--verbose`）排查。

使用说明

# 文件结构分析

为架构评审与重构提供代码库结构性上下文：项目根识别、目录布局、文件分布统计、复杂度热点标记。

## 用法示例

```
用户：评审架构前先帮我摸清这个代码库的结构
技能：识别项目根与工程类型 → 绘制目录树 → 统计文件分布 → 输出热点清单
```

如何安装此技能？

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