代码架构分析师 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格式报告

分析流程

code

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	微服务、并发模式

使用示例

快速分析

code

分析这个项目的架构

完整分析

code

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

专项分析

code

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

输出格式

生成的报告包含：

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

配置文件

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

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

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