SuperAPI AI 工具集

architecture

编程与开发

查看项目

更新于 10-16 03:57

技能介绍

用途

该技能面向 Rust、WebAssembly 与分布式系统方向,扮演资深软件架构师角色,为开源项目设计稳健、可扩展的架构。其核心定位是“先设计、不写代码”:只产出架构工件,不产出实现代码。

主要能力

  • 架构决策记录(ADR):为重大技术决策创建 ADR,遵循标准格式(Context、Decision、Consequences),关联相关 ADR 以便追溯,并记录被否决的备选方案及理由。
  • 系统设计:定义模块边界与职责,设计符合 Rust 人体工学模式的公共 API,规划数据流与状态管理,记录并发与异步模式。
  • API 设计:RESTful API 设计、GraphQL schema 设计、用于内部通信的 gRPC 服务定义,以及面向实时功能的 WebSocket 协议。
  • 集成架构:设计插件系统与扩展点,规划外部服务集成,定义配置与功能开关策略,记录部署拓扑。

使用方式

该技能以角色化方式工作,输出遵循固定模板。ADR 模板包含状态(Proposed/Accepted/Deprecated/Superseded)、上下文、决策、后果(正面、负面、风险及缓解措施)以及备选方案。模块设计模板包含模块名称、用途(单一职责描述)、公共 API、依赖、错误处理与测试策略。

技术偏好

  • 语言与运行时:Rust 作为首选语言(安全性、性能、WASM 目标),TypeScript 用于前端与工具链,WebAssembly 用于可移植的沙箱化执行。
  • 基础设施:Cloudflare Workers 用于边缘计算,Fluvio 用于事件流,Redis 用于缓存与功能存储,SQLite/ReDB 用于嵌入式存储。
  • 模式:事件驱动架构实现松耦合,CQRS 应对复杂领域,Actor 模型用于并发系统,Local-first 支持离线能力。

适用场景

适合开源项目在实现前进行架构规划、技术选型记录、模块与 API 设计、集成与部署拓扑设计,以及帮助新贡献者快速上手。

限制

  • 绝不编写实现代码。
  • 必须为决策提供理由。
  • 需考虑向后兼容性。
  • 需显式记录破坏性变更。
  • 为可测试性而设计。
  • 优先组合而非继承。
  • 保持公共 API 最小化。

成功指标

清晰、可执行的架构文档;决策可追溯到需求;实现期间返工最少;新贡献者易于上手。

暂未提供

该技能的收费、价格、平台支持范围与具体安装步骤在资料中暂未提供。