用途 该技能面向 Rust、WebAssembly 与分布式系统项目的系统架构设计,定位为“Design First, Code Never”,即只产出架构工件,不编写任何实现代码。它用于在实现之前明确技术决策、模块边界、公共 API、数据流、状态管理、并发与异步模式,以及外部集成的整体方案,适合开源项目在需求到编码之间建立可追溯的架构依据。
主要能力 第一,架构决策记录(ADR)。为重要技术决策创建 ADR,采用标准格式:Context(背景)、Decision(决策)、Consequences(后果),并链接相关 ADR 以便追溯,同时记录被拒绝的备选方案及理由。 第二,系统设计。定义模块边界与职责,规划数据流与状态管理,记录并发与异步模式。 第三,API 设计。包括遵循最佳实践的 RESTful API 设计、在适当时进行 GraphQL schema 设计、用于内部通信的 gRPC 服务定义,以及面向实时功能的 WebSocket 协议。 第四,集成架构。设计插件系统与扩展点,规划外部服务集成,定义配置与功能开关策略,记录部署拓扑。 第五,输出模板。提供 ADR 模板与模块设计模板,模块模板包含用途、公共 API、依赖、错误处理、测试策略等栏目。
使用方式 资料未提供该技能的安装命令或具体调用方式,因此暂未提供可执行的安装与运行步骤。从描述可知,其工作方式是:根据项目需求产出架构文档,不产生实现代码。ADR 采用固定模板,含 Status、Context、Decision、Consequences(Positive、Negative、Risks)、Alternatives Considered;模块设计采用固定模板,含 Purpose、Public API、Dependencies、Error Handling、Testing Strategy。约束要求:始终为决策提供理由、考虑向后兼容、显式记录破坏性变更、为可测试性而设计、优先组合而非继承、保持公共 API 最小化。
适用场景 适用于 Rust/WebAssembly 开源项目的早期架构规划、技术选型决策记录、模块拆分与接口设计、插件与扩展点设计、外部服务集成与部署拓扑梳理,以及为新贡献者提供可入职的架构说明。其技术偏好包括:Rust 作为主语言(安全性、性能、WASM 目标)、TypeScript 用于前端与工具链、WebAssembly 用于可移植的沙箱执行;基础设施偏好 Cloudflare Workers 边缘计算、Fluvio 事件流、Redis 缓存与功能存储、SQLite/ReDB 嵌入式存储;架构模式偏好事件驱动、CQRS、Actor 模型与 local-first。
限制 该技能明确不编写实现代码,只产出架构文档与决策说明。资料未提供其收费方式、价格、具体平台支持范围、与其他工具的集成细节或实际效果数据,相关内容暂未提供。