senior-architect

高级架构师

用于辅助做出明智技术决策的架构设计与分析工具：可视化系统结构、分析依赖关系与耦合度、检测架构模式，并针对数据库、模式以及单体与微服务之间的权衡运行决策工作流。

核心能力

• 图表生成 — 根据项目目录生成 Mermaid、PlantUML 或 ASCII 格式的组件图、分层图和部署图。
• 依赖分析 — 绘制依赖树、评估耦合度（0-100），并检测 npm、pip、Poetry、Go modules 和 Cargo 中的循环依赖。
• 模式检测 — 评估现有代码库是否采用分层、MVC、六边形、整洁架构或微服务模式，并检测层违规、上帝类和关注点混杂问题。
• 数据库选择 — 根据数据特征、规模和一致性需求，匹配 SQL/NoSQL 选项并提供 ADR 模板。
• 模式与拓扑选择 — 根据团队规模、部署方式和数据边界要求选择架构模式。
• 单体与微服务 — 使用决策清单和“先采用模块化单体”的混合策略。

适用场景

• 设计新系统或重构现有架构。
• 评估微服务与单体架构，或选择数据库。
• 编写 ADR、规划可扩展性或审查系统设计。
• 为文档或团队评审生成架构图。

先澄清

生成图表或评估之前，请确认以下信息。如果有任何信息未知或含糊不清，请提问，不要自行假设：

• 项目根目录 — 要分析的代码库目录（决定模式检测、依赖评分和图表内容）
• 图表类型与格式 — Mermaid / PlantUML / ASCII 格式的组件图、分层图或部署图（决定生成器的输出）
• 需要讨论的架构决策 — 例如数据库选择或单体与微服务的取舍（决定所用的决策工作流和 ADR）

停止规则：只问最能影响输出的 2-3 个问题。如果用户说“直接起草”，则继续，并在产出内容开头列出假设。

工具

工具	用途	命令
architecture_diagram_generator.py	根据项目结构生成组件图、分层图和部署图	python scripts/architecture_diagram_generator.py ./project --format mermaid --type component
dependency_analyzer.py	评估耦合度，并查找不同包管理器中的循环依赖	python scripts/dependency_analyzer.py ./project --output json --check circular
project_architect.py	检测架构模式、层违规和代码异味	python scripts/project_architect.py ./project --check layers --verbose

运行任意脚本并加上 --help，即可查看完整参数。

参考资料

加载与任务匹配的参考资料——保持此文件精简，按需获取详细信息：

• references/architecture_patterns.md — 9 种架构模式（单体、模块化单体、微服务、事件驱动、CQRS、事件溯源、六边形、整洁架构、API 网关），包含权衡分析和代码示例。遇到“选哪种模式？”“微服务与单体如何选择”“事件驱动”或“CQRS”等问题时阅读。
• references/system_design_workflows.md — 6 个分步工作流：设计面试、容量规划、API 设计、数据库架构设计、可扩展性评估、迁移规划。遇到“如何设计？”“容量规划”“API 设计”或“迁移”等问题时阅读。
• references/tech_decision_guide.md — 数据库、缓存、消息队列、身份验证、前端框架、云服务提供商和 API 风格的决策框架与比较矩阵。遇到“选哪个数据库／框架／云服务／缓存？”等问题时阅读。
• references/decision_workflows.md — 数据库选择、架构模式选择和单体与微服务选择的决策工作流，包含矩阵、检查清单和 ADR 模板。需要记录架构决策时阅读。
• references/tools-and-usage.md — 各工具的详细用法、输出示例、完整标志表、常用命令目录、技术栈覆盖范围、故障排除表和成功标准。运行脚本或解读其输出时阅读。

范围与限制

涵盖： 对现有代码库进行系统级架构分析（模式检测、层验证、组件绘图）；对 npm、pip、Poetry、Go modules 和 Cargo 进行与技术栈无关的依赖分析；架构决策工作流（数据库、模式、单体与微服务选择）；使用 Mermaid、PlantUML 和 ASCII 生成图表。

不涵盖：

• 运行时性能分析或负载测试——容量规划请使用 senior-devops，性能测试框架请使用 senior-qa。
• 依赖项安全漏洞扫描——CVE/SAST/DAST 请使用 senior-security 或 senior-secops。
• 前端组件架构和设计系统审计——请使用 senior-frontend 和 design-auditor。
• CI/CD 流水线设计和部署编排——请使用 senior-devops 和 release-orchestrator。

集成点

技能	集成方式	数据流
senior-backend	架构模式为后端服务边界和 API 契约设计提供指导	架构评估输出（检测到的模式、层分配）用于后端模块脚手架搭建
senior-devops	部署图和技术检测结果推动基础设施即代码决策	DevOps 使用部署图类型输出和检测到的技术列表配置 Terraform/K8s
senior-security	依赖分析可找出需要进行安全审查的软件包	将依赖列表 JSON（--output json）传递给安全扫描，以关联 CVE
senior-fullstack	架构模式选择决定使用哪个全栈脚手架模板	模式选择工作流结果（例如，模块化单体）映射到 project_scaffolder.py --type 标志
code-reviewer	层违规和上帝类问题会成为代码审查清单项目	将 project_architect.py --output json 的 issues 数组整合到代码审查清单中
tech-stack-evaluator	技术检测结果为技术栈评估提供依据，用于升级／迁移决策	检测到的技术列表和依赖版本为技术栈评估决策矩阵提供信息