---

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格式报告

分析流程

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

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

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

支持的项目类型

使用示例

快速分析

Copy分析这个项目的架构

完整分析

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

专项分析

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

输出格式

生成的报告包含：

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

配置文件

技能包含完整的架构模式配置：

• config/patterns.yaml - 23种设计模式定义
• 支持SOLID原则检测
• 识别反模式（God Object、Spaghetti Code等）
• 质量指标基准

---

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