senior-architect

Senior Architect

高级架构师全套工具包，涵盖现代主流工具与架构最佳实践。

快速上手

核心能力

本 Skill 通过自动化脚本提供三大核心能力：

# 脚本 1：架构图生成器
python scripts/architecture_diagram_generator.py [options]

# 脚本 2：项目架构师
python scripts/project_architect.py [options]

# 脚本 3：依赖分析器
python scripts/dependency_analyzer.py [options]

核心功能

1. 架构图生成器 (Architecture Diagram Generator)

用于自动化生成架构图相关任务的工具。

特性：

• 自动化脚手架生成
• 内置最佳实践
• 支持可配置模板
• 质量检查

用法：

python scripts/architecture_diagram_generator.py <project-path> [options]

2. 项目架构师 (Project Architect)

全方位的项目分析与优化工具。

特性：

• 深度分析
• 性能指标测量
• 优化建议
• 自动化修复

用法：

python scripts/project_architect.py <target-path> [--verbose]

3. 依赖分析器 (Dependency Analyzer)

面向专项任务的高级分析工具。

特性：

• 专家级自动化能力
• 自定义配置
• 即插即用集成
• 生产级输出

用法：

python scripts/dependency_analyzer.py [arguments] [options]

参考文档

架构模式 (Architecture Patterns)

详见 references/architecture_patterns.md 中的完整指南：

• 详细架构模式与实践
• 代码示例
• 最佳实践
• 应避免的反模式 (Anti-patterns)
• 真实场景案例

系统设计工作流 (System Design Workflows)

详见 references/system_design_workflows.md 中的完整工作流文档：

• 分步实施流程
• 优化策略
• 工具集成
• 性能调优
• 故障排查指南

技术决策指南 (Tech Decision Guide)

详见 references/tech_decision_guide.md 中的技术参考指南：

• 技术栈详解
• 配置示例
• 集成模式
• 安全注意事项
• 扩容与可扩展性指导

技术栈

语言： TypeScript, JavaScript, Python, Go, Swift, Kotlin
前端： React, Next.js, React Native, Flutter
后端： Node.js, Express, GraphQL, REST APIs
数据库： PostgreSQL, Prisma, NeonDB, Supabase
DevOps： Docker, Kubernetes, Terraform, GitHub Actions, CircleCI
云服务： AWS, GCP, Azure

开发工作流

1. 初始化与配置

# 安装依赖
npm install
# 或
pip install -r requirements.txt

# 配置环境变量
cp .env.example .env

2. 运行质量检查

# 使用架构分析脚本
python scripts/project_architect.py .

# 查看优化建议
# 应用修复

3. 落实最佳实践

遵循以下文档中记录的模式与实践：

• references/architecture_patterns.md
• references/system_design_workflows.md
• references/tech_decision_guide.md

最佳实践速查

代码质量

• 遵循既定模式
• 编写完善的测试
• 记录架构决策
• 定期开展 Code Review

性能优化

• 先测量，后优化
• 合理使用缓存
• 优化关键路径
• 做好生产环境监控

安全规范

• 校验所有输入数据
• 使用参数化查询
• 落实完善的身份认证
• 保持依赖库及时更新

可维护性

• 编写清晰易读的代码
• 保持统一的命名规范
• 添加有价值的代码注释
• 保持简单 (KISS 原则)

常用命令

# 开发环境
npm run dev
npm run build
npm run test
npm run lint

# 项目分析
python scripts/project_architect.py .
python scripts/dependency_analyzer.py --analyze

# 部署
docker build -t app:latest .
docker-compose up -d
kubectl apply -f k8s/

故障排查

常见问题

请参考 references/tech_decision_guide.md 中的详细故障排查章节。

获取帮助

• 查阅参考文档
• 查看脚本输出日志
• 查阅相关技术栈官方文档
• 排查错误日志

相关资源

• 架构模式参考：references/architecture_patterns.md
• 工作流指南：references/system_design_workflows.md
• 技术指南：references/tech_decision_guide.md
• 工具脚本：scripts/ 目录

适用场景

本 Skill 适用于执行概述中所述的工作流或具体操作。

使用限制

• 仅当任务明确符合上述范围时使用本 Skill。
• 请勿将输出直接替代特定环境下的验证、测试或专家评审。
• 若缺少必要的输入、权限、安全边界或成功标准，请暂停并寻求进一步确认。