代码结构分析

技能文档

---
name: code-structure-analyzer
title: 代码结构分析
category: 开发工具
description: 检查代码组织、模块层级与结构模式，输出模块树、关键组件清单与依赖关系，用于理解陌生代码库、编写架构文档或规划重构。当用户提到分析代码结构、模块层级、代码组织、项目结构梳理、重构规划时触发。
---

# 代码结构分析

检查代码组织、模块层级与结构模式，理解组件是如何被组织起来的。

## 适用场景

- 初次接触代码库时的整体审查与定位
- 理解既有模块的组织方式
- 为编写文档提取代码结构
- 规划重构或目录重组

## 快速上手

```bash
# 快速分析代码结构
find . -name "*.py" -o -name "*.mojo" | head -20
tree -L 2 --dirsfirst
grep -r "^class\|^def\|^fn\|^struct" --include="*.py" --include="*.mojo" | head -30
```

## 技能工作流

### 步骤1：概览代码库

识别顶层模块与包，统计各语言的文件分布，找出入口文件与配置文件。

### 步骤2：绘制模块层级

用树状图呈现模块组织，标注每层的职责边界。

### 步骤3：列出主要组件

按模块列出类、结构体与重要函数，说明各自承担的职责。

### 步骤4：追踪导入依赖

梳理模块间的 import 关系，识别循环依赖与分层违规。

### 步骤5：输出结构报告

为团队汇总结构发现，形成可复查的分析结论。

## 输出格式

结构分析报告包含：

- 模块/包层级（树状图）
- 每个模块的关键组件
- 导入依赖关系
- 分层组织（如适用）
- 值得注意的模式（MVC、单例、工厂等）

使用说明

# 代码结构分析

检查代码组织、模块层级与结构模式，快速理解一个陌生代码库的组件组织方式，输出模块树、关键组件与依赖关系报告。

## 使用

在项目根目录下直接描述需求，例如：

```text
分析一下这个项目的代码结构
帮我梳理模块层级和依赖关系，我准备做重构
```

技能会扫描源码文件、生成模块树、追踪 import 依赖并汇总成结构报告。

## 工作原理

以只读方式遍历源码目录（find/tree/grep），按「概览 → 层级 → 组件 → 依赖 → 报告」五步输出结构分析，不修改任何代码。

如何安装此技能？

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