代码架构分析师 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️⃣ 报告生成
   ├─ 架构概览
   ├─ 模块说明
   ├─ 依赖关系图
   └─ 改进建议

支持的项目类型

使用示例

快速分析

分析这个项目的架构

完整分析

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

专项分析

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

输出格式

生成的报告包含：

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

配置文件

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

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

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