senior-architect

核心用法

Senior Architect 是一套面向软件架构设计的静态分析工具集，包含三大核心组件：

1. 架构图生成器：自动扫描项目结构，生成 Mermaid、PlantUML 或 ASCII 格式的架构图，支持组件图、分层图和部署图三种类型，解决团队文档化与沟通需求。

2. 依赖分析器：深度解析 npm、Python、Go、Rust 等主流包管理文件，识别循环依赖、计算耦合度分数、标记过期包，输出 JSON 或可读报告供 CI/CD 集成。

3. 项目架构师：智能识别 MVC、分层、六边形等架构模式，检测上帝类、混合关注点、层违规等代码异味，提供可操作的改进建议。

工具通过命令行调用，支持 --verbose 详细模式、、--output json 结构化输出，以及 -o 指定报告保存路径。

显著优点

• 零依赖安全：仅使用 Python 标准库，彻底消除供应链攻击风险
• 多格式输出：Mermaid/PlantUML 可直接嵌入文档，ASCII 适合终端快速查看
• 决策工作流内置：提供数据库选型、架构模式选择、单体 vs 微服务的完整决策框架
• 广泛技术栈覆盖：支持 TypeScript、Python、Go、Rust 等语言及主流前后端框架
• 离线可用：纯本地执行，无需网络连接，适合内网环境

潜在缺点与局限性

• 静态分析局限：无法识别运行时架构特征，如实际服务调用关系、性能瓶颈
• 语言支持边界：对 C++、Java 等语言的包管理文件支持有限
• 模式识别精度：基于启发式规则，复杂架构可能误判或置信度不足
• 无自动修复：仅提供诊断报告，不直接修改代码
• 大型项目性能：扫描超大规模代码库时可能耗时较长

适合的目标群体

• 技术负责人/架构师：进行技术选型、架构评审、制定演进路线
• 全栈开发团队：快速理解遗留项目结构，制定重构计划
• DevOps 工程师：集成依赖检查到 CI 流水线，预防供应链风险
• 技术写作者：自动生成架构文档配图，保持文档与代码同步
• 初创公司技术团队：在 MVP 阶段建立合理的架构基线

使用风险

• 输出文件管理：使用 -o 参数时注意指定安全路径，避免覆盖重要文件
• 分析结果解读：静态分析可能产生误报，建议结合人工判断
• 大型项目超时：极端规模项目可能出现分析时间过长，建议分模块扫描
• 模式识别依赖：架构模式检测基于文件命名和结构启发式，非 100% 准确

Senior Architect 综合评估

核心用法

Senior Architect 是一套面向系统架构设计的纯本地分析工具，包含三大核心脚本：

1. Architecture Diagram Generator —— 从项目结构自动生成架构图，支持 Mermaid、PlantUML、ASCII 三种输出格式，可生成组件图、分层图、部署拓扑图等。

2. Dependency Analyzer —— 深度分析项目依赖关系，检测循环依赖、计算耦合度、识别过时包，支持 npm/yarn、Python、Go、Rust 等主流包管理器。

3. Project Architect —— 智能识别项目架构模式（MVC、分层、六边形、微服务特征等），检测代码异味（God Class、混合职责、分层违规），并提供改进建议。

显著优点

极致安全性：纯 Python 标准库实现，零第三方依赖，无网络通信，仅执行只读文件分析，通过 CLS-Certify 六维安全检测获得 S 级评分（92 分）。

广泛兼容性：支持 TypeScript/JavaScript、Python、Go、Rust、Swift、Kotlin 等主流语言，覆盖 React、Next.js、FastAPI、GraphQL 等常用技术栈。

决策辅助能力：内置数据库选型工作流、架构模式选择流程、单体 vs 微服务决策树，帮助团队做出结构化技术决策并生成架构决策记录（ADR）。

输出友好：支持 JSON 格式便于 CI/CD 集成，同时提供人类可读报告，Mermaid/PlantUML 输出可直接嵌入文档或代码仓库。

潜在缺点与局限性

无实时协作功能：作为纯离线工具，不支持团队实时协作、版本对比或云端同步。

静态分析边界：仅能分析代码结构，无法运行时性能分析、内存剖析或动态调用链追踪。

架构模式识别依赖启发式：对复杂架构或高度定制模式的识别准确率可能受限，需人工复核。

多语言深度不均：对 JavaScript/TypeScript 和 Python 的支持最为完善，其他语言的某些特性可能识别不够精细。

适合人群

• 技术负责人和架构师进行系统评审
• 开发团队进行技术债务梳理和重构规划
• 需要快速生成架构文档的中大型项目
• 学习系统设计的开发者（通过分析示例项目理解架构模式）

常规风险

极低风险。该 Skill 无网络行为、无敏感数据收集、无系统修改权限，主要风险在于用户误读分析结果做出不当决策——建议结合团队上下文和实际运行数据综合判断。