Architecture Designer

🏗️ 系统化架构设计与决策记录

由资深架构师主导的系统性设计方法论,涵盖架构模式选型、ADR决策记录与可扩展性规划,强调务实权衡与长期可维护性。

收藏
28.4k
安装
6.2k
版本
0.1.0
CLS 安全性认证2026-05-12
点击查看完整报告 >

使用说明

核心定位

Architecture Designer 是一款面向软件架构决策的专业方法论工具,由具备15年以上经验的资深架构师角色驱动,专注于分布式系统、云原生架构及技术选型的务实权衡。

核心能力与用法

该技能采用结构化五步法:需求理解 → 模式识别 → 架构设计 → 决策文档化 → 利益相关方评审。其独特价值在于强制要求为所有重大决策编写架构决策记录(ADR),并将非功能性需求(性能、可用性、安全性)作为一等公民纳入设计考量。参考指南系统覆盖了单体 vs 微服务选型、数据库技术评估、NFR 检查清单等关键场景。

显著优点

1. 决策可追溯性:ADR 模板确保技术债务与选型理由可被后人理解
2. 风险前置:明确规划故障模式与缓解策略,而非仅关注理想路径

3. 约束驱动设计:MUST DO/MUST NOT DO 清单有效防止过度工程与忽略运维成本

4. 全栈协同:与 Fullstack Guardian、DevOps Engineer、Secure Code Guardian 形成设计-实施-运维-安全的闭环

局限性与注意事项

  • 依赖人工判断:技能提供框架而非自动化决策,最终质量高度依赖使用者的领域经验
  • 上下文加载成本:参考指南按需加载机制可能增加初次使用时的认知负担
  • 输出重量级:ADR 与多维度风险评估适合中大型企业场景,轻量级项目可能觉得流程过重

适用人群

  • 技术负责人/首席架构师制定平台级技术战略
  • 高级工程师晋升架构师角色的方法论训练
  • 技术委员会进行架构评审与治理标准化

潜在风险

需警惕 "为文档而文档" 的形式主义倾向。技能明确禁止 "为假设规模过度工程",但实际执行中仍可能因保守倾向导致技术栈复杂化。建议结合具体业务增长数据动态调整架构深度。

安全解读

核心用法

Architecture Designer 是一位拥有15年以上经验的资深软件架构师角色,专为系统设计、架构评审和技术决策而生。用户可通过触发关键词(如 architecture、system design、ADR、microservices)激活该 Skill,它将引导用户完成从需求理解到最终文档化的完整架构设计流程。

核心工作流包含五个阶段:理解需求(功能与非功能需求)、识别模式(匹配架构模式)、详细设计(记录权衡)、文档化(生成 ADR)、以及利益相关方评审。Skill 内置丰富的参考指南,包括架构模式对比、ADR 模板、系统设计模板、数据库选型指南和非功能需求检查清单。

显著优点

1. 结构化决策流程:强制要求文档化重大决策(ADR),避免"拍脑袋"选型
2. 全面的参考资源:覆盖从单体到微服务、从数据库选型到 NFR 清单的完整知识体系

3. 务实的约束意识:明确禁止过度工程化、忽视运维成本等常见架构反模式

4. 标准化输出:提供包含需求摘要、架构图、决策记录、技术建议和风险的完整交付模板

潜在缺点与局限性

  • 纯文档型 Skill:无实际代码生成能力,需配合 Fullstack Guardian 等实现技能使用
  • 依赖用户输入质量:架构设计高度依赖用户提供的需求清晰度,缺乏主动追问机制
  • 通用性 vs 场景化:虽然覆盖广泛,但对特定领域(如金融级高可用、IoT 边缘架构)的深度可能不足

适合人群

  • 需要进行技术选型的 Tech Lead 和架构师
  • 准备从单体迁移到微服务的团队
  • 需要建立架构评审流程的技术管理者
  • 系统设计和面试准备的候选人

常规风险

该 Skill 本身为纯 Markdown 文档(T-MD 分类),无可执行代码,无网络请求,安全等级极高。主要风险在于:架构建议的落地效果取决于执行团队的能力,以及 ADR 文档若维护不当可能沦为形式主义的合规负担。

来源为个人开发者(T3),但内容质量经过结构化整理,符合行业主流实践。建议后续添加明确的 LICENSE 声明。

Architecture Designer 内容

references文件夹
手动下载zip · 8.5 kB
adr-template.mdtext/markdown
请选择文件