SuperAPI AI 工具集

architecture

编程与开发

查看项目

更新于 10-15 08:33

技能介绍

用途

该技能是一个架构决策框架,用于辅助完成架构设计相关的思考与文档工作。其核心主张是:需求驱动架构,权衡支撑决策,ADR 记录决策理由(Requirements drive architecture. Trade-offs inform decisions. ADRs capture rationale.)。

主要能力

技能采用「选择性阅读」规则,要求只读取与当前请求相关的文件,先查看内容地图再定位所需内容。其内容组织为以下文件:

  • context-discovery.md:涉及应提出的问题、项目分类,适用于开始架构设计时读取。
  • trade-off-analysis.md:包含 ADR 模板与权衡框架,适用于记录决策时读取。
  • pattern-selection.md:包含决策树与反模式,适用于选择模式时读取。
  • examples.md:包含 MVP、SaaS、企业级示例,作为参考实现。
  • patterns-reference.md:模式的快速查阅,用于模式对比。

技能还关联以下相关技能:@[skills/database-design] 用于数据库模式设计,@[skills/api-patterns] 用于 API 设计模式,@[skills/deployment-procedures] 用于部署架构。

使用方式

遵循「选择性阅读」规则,根据当前任务类型定位对应文件:开始架构设计时读取 context-discovery.md,记录决策时读取 trade-off-analysis.md,选择模式时读取 pattern-selection.md,需要参考实现时读取 examples.md,需要对比模式时读取 patterns-reference.md。

核心原则

技能强调「简洁是终极的精致」(Simplicity is the ultimate sophistication.):从简单开始;只有在证明有必要时才增加复杂度;模式可以之后再添加;而移除复杂度比添加复杂度困难得多。

适用场景与验证清单

该技能适用于做出架构决策或分析架构方案的场景。在最终确定架构之前,需对照以下验证清单:需求是否被清晰理解;约束是否已识别;每个决策是否都有权衡分析;是否考虑过更简单的替代方案;重大决策是否已写入 ADR;团队专业能力是否与所选模式相匹配。

限制

各项内容文件的具体细节、安装方式、平台与收费等信息,在所提供资料中暂未提供。