architecture

Architecture - 架构决策框架

技能概述

Architecture 是一个专注于系统架构决策的 AI 框架，帮助开发者进行需求分析、权衡评估和 ADR 文档编写，在架构设计和系统设计分析场景中做出明智的技术决策。

适用场景

1. 新项目架构设计

当启动新项目时，本技能帮助团队进行需求分析、项目分类（MVP、SaaS 或企业级），并基于核心原则"从简单开始"推荐合适的架构模式，避免过度设计。

2. 架构决策文档化

需要记录重要架构决策时，提供标准化的 ADR（Architecture Decision Record）模板和权衡评估框架，确保决策背后的理由被清晰记录，便于团队后续回顾和审查。

3. 系统架构评估与改进

对现有系统进行架构分析时，帮助识别架构中的反模式，评估是否需要引入新的架构模式，以及如何进行渐进式架构演进而非大爆炸重构。

核心功能

1. 上下文发现与项目分类

通过结构化问题快速理解项目需求，将项目分类为 MVP、SaaS 或企业级，并据此推荐适合的架构复杂度和模式选择。

2. 权衡分析与 ADR 文档

提供架构决策记录模板，指导如何评估每个决策的优缺点（trade-off），确保团队 expertise 与选择的模式相匹配，并将决策理由永久记录。

3. 模式选择与参考

包含常见架构模式的决策树和反模式识别，以及不同项目类型（MVP、SaaS、Enterprise）的参考实现示例，帮助避免常见陷阱。

常见问题

什么是架构决策记录（ADR）？为什么要使用它？

ADR（Architecture Decision Record）是一种轻量级文档格式，用于记录重要的架构决策及其理由。它帮助团队在项目演进中理解"为什么当初这么选"，避免重复讨论已解决的问题，也便于新成员快速理解架构决策的历史背景。

如何判断项目应该使用什么架构模式？

Architecture 技能建议从"简单至上"原则出发：先满足当前需求，不要为了"将来可能"提前引入复杂模式。通过项目分类（MVP 从最简开始、SaaS 考虑扩展性、Enterprise 重视规范）和权衡分析框架，逐步增加复杂度，而非一开始就上全套。

"简单至上"的架构原则具体怎么应用？

核心原则是：你可以随时增加复杂度，但移除复杂度要难得多。具体做法包括：MVP 项目从单体开始；只在证明必要时才引入分布式架构；优先选择团队熟悉的模式而非时髦技术；每个架构决策都要有明确的 trade-off 分析记录。

技能限制