| 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 获取完整使用说明
