核心用法
Senior Architect 是一套面向系统设计决策的专业工具集，包含三大核心组件：
1. 架构图生成器：自动从项目结构生成 Mermaid/PlantUML/ASCII 格式架构图，支持组件图、分层图、部署图三种类型，用于文档编写与团队沟通。
2. 依赖分析器：扫描 npm、Python、Go、Rust 等项目的依赖树，识别循环依赖、耦合度评分与过期包，输出 JSON 或可读报告供 CI/CD 集成。
3. 项目架构师：自动识别 MVC、分层、六边形等架构模式，检测神类、层越界、关注点混合等代码异味，输出结构健康度评估。
显著优点
- 决策框架标准化：内置数据库选型、架构模式选择、单体/微服务决策三大工作流，用检查清单降低主观判断风险。
- 多格式输出：架构图支持 Markdown 原生 Mermaid 与专业 PlantUML，兼顾文档友好与设计严谨。
- 语言无关性：覆盖主流技术栈，不绑定特定框架或云厂商。
- 渐进式建议：从模块化单体起步、条件触发拆分的"杂交方案"符合业界最佳实践。
潜在局限
- 静态分析为主：依赖分析与架构检测基于文件结构与导入关系，无法捕获运行时动态依赖与真实流量特征。
- 模式识别置信度：架构模式检测输出百分比置信度（如"分层架构 85%"），需人工复核边界模糊场景。
- ADR 模板缺失：文档提及需撰写架构决策记录，但未提供具体模板字段与示例，用户需自行补充。
- 安全扫描声明缺失：参考报告仅含占位文本，未实际执行漏洞扫描，生产环境需额外引入 SCA 工具。
适合人群
- 技术负责人进行技术评审与方案选型
- 全栈工程师梳理遗留系统结构
- 架构师团队建立统一的决策语言与文档规范
常规风险
| 风险类型 | 说明 |
|---------|------|
| 过度拆分 | 团队规模<10 人时盲目采用微服务，导致运维复杂度陡增 |
| 工具误读 | 将"耦合度评分"作为唯一重构依据，忽视业务上下文 |
| 输出漂移 | 自动生成图表与实际部署拓扑不一致，需定期手工校准 |