---
name: code-architecture-analyzer
description: 智能代码架构解读和分析工具。当用户请求分析项目架构、生成架构文档、识别设计模式、分析依赖关系、评估代码质量、或理解复杂项目结构时使用此skill。适用于接手新项目、代码审查、重构规划、技术选型评估等场景。
allowed-tools:
  - Read
  - Glob
  - Grep
  - Bash
  - Task
metadata:
  version: "2.0.0"
  author: "Claude Code"
  category: "development"
  tags: ["architecture", "analysis", "code-review", "documentation", "patterns", "tech-stack"]
examples:
  - "分析这个项目的整体架构"
  - "生成详细的架构文档，包括设计模式和依赖关系"
  - "识别Unity项目中的性能瓶颈和优化机会"
  - "评估Python项目的代码质量和可维护性"
languages:
  - Python
  - JavaScript/TypeScript
  - C#/.NET
  - Java
  - Go
frameworks:
  - Django/Flask/FastAPI
  - React/Vue/Angular
  - Unity
  - ASP.NET
  - Spring Boot
---

# 代码架构分析师 v2.0

## 概述
专业的代码架构分析skill，能够深入解读各种编程语言和框架的项目架构，生成详细的架构文档，识别设计模式，分析依赖关系，并提供改进建议。

## 何时调用

### 触发关键词
当用户请求中包含以下内容时，应主动调用此skill：

| 关键词/意图 | 说明 |
|------------|------|
| "分析架构"、"架构分析"、"项目架构" | 需要了解项目的整体结构设计 |
| "生成架构文档"、"架构文档" | 需要输出结构化的架构说明文档 |
| "设计模式"、"使用了什么模式" | 需要识别代码中的设计模式 |
| "依赖关系"、"模块依赖" | 需要梳理模块间的调用关系 |
| "代码质量评估"、"代码质量" | 需要评估代码的可维护性 |
| "技术栈"、"使用了什么技术" | 需要识别项目使用的技术和框架 |
| "项目结构"、"目录结构" | 需要理解项目的组织方式 |
| "这个项目是怎么组织的" | 用户对项目结构不熟悉 |

### 适用场景

**1. 新项目接手**
- 初次接触代码库，需要快速理解项目结构
- 团队新成员入职培训

**2. 代码审查/重构**
- 重构前的架构现状评估
- 代码审查中的架构合理性检查
- 技术债务识别和优先级排序

**3. 文档生成**
- 生成或补充架构设计文档
- 创建技术方案说明文档
- 输出依赖关系图

**4. 技术选型**
- 评估现有架构是否满足新需求
- 对比不同架构方案的优劣

**5. 质量审计**
- 定期代码健康度检查
- 第三方库安全性审查
- 性能瓶颈分析

### 不适用的场景

- **简单的代码问题**：如单一文件的bug修复、小功能修改 → 直接处理即可
- **运行时调试**：如排查具体错误、性能分析 → 使用调试工具
- **代码搜索**：如查找某个函数、类或文件 → 使用 Glob/Grep 工具
- **单元测试**：编写或运行测试 → 直接操作测试文件

### 🏗️ 架构识别
- 自动识别项目类型（Unity/Python/JS/TS/C#/Java/Go）
- 技术栈分析（语言、框架、数据库、中间件）
- 架构模式检测（MVC/MVVM/微服务/分层架构等）
- 设计模式识别（单例/工厂/观察者/策略等23种模式）

### 📊 代码质量
- 代码结构评估（职责分离、复杂度、耦合度）
- 命名规范检查
- 最佳实践建议
- 技术债务识别

### 🔗 依赖分析
- 模块依赖关系图
- 外部依赖版本/兼容性分析
- 循环依赖检测
- 架构层次分析

### 📝 文档生成
- 执行摘要
- 详细架构分析
- 改进建议（P0/P1/P2优先级）
- Markdown格式报告

## 分析流程

```
1️⃣ 项目扫描
   ├─ 识别项目类型
   ├─ 检测技术栈
   └─ 确定架构风格

2️⃣ 深度分析
   ├─ 核心模块分析
   ├─ 设计模式检测
   └─ 代码质量评估

3️⃣ 报告生成
   ├─ 架构概览
   ├─ 模块说明
   ├─ 依赖关系图
   └─ 改进建议
```

## 支持的项目类型

| 类型 | 识别特征 | 专项分析 |
|------|----------|----------|
| **Unity** | Assets/, .unity | 组件架构、性能优化、资源管理 |
| **Python** | requirements.txt, setup.py | AI/ML、Web框架、数据处理流 |
| **JavaScript/TypeScript** | package.json, .ts/.js | 前端框架、状态管理、路由架构 |
| **C#/.NET** | .csproj, .sln | ASP.NET、WPF、架构模式 |
| **Java** | pom.xml, build.gradle | Spring Boot、Android |
| **Go** | go.mod, go.sum | 微服务、并发模式 |

## 使用示例

### 快速分析
```
分析这个项目的架构
```

### 完整分析
```
生成详细的架构分析报告，包括：
1. 技术栈和架构模式
2. 设计模式识别
3. 模块依赖关系
4. 代码质量评估
5. 改进建议
```

### 专项分析
```
分析Unity项目的性能优化机会：
- 内存分配和GC压力
- 渲染优化
- 组件通信效率
```

## 输出格式

生成的报告包含：
- 执行摘要（项目类型、技术栈、关键发现）
- 项目结构分析
- 技术栈详解
- 架构模式识别
- 代码质量评估
- 依赖关系分析
- 改进建议（按优先级）

## 配置文件

技能包含完整的架构模式配置：
- `config/patterns.yaml` - 23种设计模式定义
- 支持SOLID原则检测
- 识别反模式（God Object、Spaghetti Code等）
- 质量指标基准

---

*详见 prompt.md 获取完整使用说明*