SuperAPI AI 工具集

multi-platform-apps-multi-platform

通用与其它

查看项目

更新于 10-15 23:34

技能介绍

用途:在多平台(Web、iOS、Android、桌面)上一致地构建并部署同一功能,依靠 API 优先架构与并行实现策略保证功能对等,同时保留平台专属优化。适用场景为多平台功能开发工作流,或需要相关最佳实践与清单时;任务与多平台功能开发无关,或需要本范围外的其他领域与工具时不应使用。

主要能力分三阶段。第一阶段为顺序式架构与 API 设计:由后端架构子代理定义 API 契约(OpenAPI 3.1、RESTful 端点、GraphQL schema、WebSocket 事件、请求响应校验、认证与鉴权、限流与缓存、错误格式)及共享数据模型;由 UI/UX 设计子代理产出跨平台设计系统(各平台组件规范、响应式布局、原生模式、桌面考量、无障碍 WCAG 2.2 AA、主题与动效);由架构评审子代理设计共享业务逻辑(领域模型、业务规则、状态管理模式、缓存与离线、错误重试、平台适配器),可考虑 Kotlin Multiplatform 或 TypeScript 共享。

第二阶段为并行平台实现:Web 使用 React 18+ 与 Next.js 14+ App Router、TypeScript、TanStack Query、Zustand/Redux Toolkit、Tailwind CSS、PWA、SSR/SSG 与 Web Vitals 优化;iOS 使用 SwiftUI、Swift 5.9+ async/await、URLSession+Combine、Core Data/SwiftData、Widget 扩展、MVVM;Android 使用 Jetpack Compose 与 Material 3、协程与 Flow、Retrofit/Ktor、Room、Hilt、Material You、MVI;桌面(可选)使用 Tauri 2.0 或 Electron,含系统托盘、通知、文件系统访问、自动更新、代码签名与多窗口。

第三阶段为集成与验证:生成 API 文档与测试;进行跨平台功能对等测试(功能矩阵、UI 一致性、性能基准、无障碍、网络韧性、数据同步、端到端旅程);做平台专属优化。配置项包括 --platforms、--api-first、--shared-code、--design-system、--testing-strategy。成功标准含 API 契约先定义、功能对等差异小于 5%、性能达标、无障碍达标、测试一致、文档完整、代码复用超 40%、体验契合各平台惯例。

限制:仅在任务明确匹配上述范围时使用;输出不能替代具体环境的验证、测试或专家评审;缺少必要输入、权限、安全边界或成功标准时应停下并请求澄清。具体命令示例与实现细节请参见资源文件 resources/implementation-playbook.md。