---

name: multi-platform-apps-multi-platform description: "使用 API 优先架构和并行实现策略，在 Web、移动端和桌面平台上一致地构建和部署相同功能。" risk: unknown source: community date_added: "2026-02-27"

多平台功能开发工作流

使用 API 优先架构和并行实现策略，在 Web、移动端和桌面平台上一致地构建和部署相同功能。

[Extended thinking: 此工作流协调多个专业化 agent 以确保跨平台的功能一致性，同时保持平台特定的优化。协调策略强调共享契约和并行开发，并定期进行同步检查点。通过预先建立 API 契约和数据模型，团队可以独立工作同时确保一致性。工作流的优势包括更快的上市时间、减少集成问题和可维护的跨平台代码库。]

何时使用此技能

• 处理多平台功能开发工作流任务或流程时
• 需要多平台功能开发工作流的指导、最佳实践或检查清单时

何时不使用此技能

• 任务与多平台功能开发工作流无关时
• 需要此范围之外的不同领域或工具时

说明

• 明确目标、约束和所需输入。
• 应用相关最佳实践并验证结果。
• 提供可操作的步骤和验证方法。
• 如需详细示例，请打开 resources/implementation-playbook.md。

第一阶段：架构和 API 设计（顺序执行）

1. 定义功能需求和 API 契约

• 使用 Task 工具，subagent_type="backend-architect"
• 提示："为功能设计 API 契约：$ARGUMENTS。创建 OpenAPI 3.1 规范，包含：
  • 具有正确 HTTP 方法和状态码的 RESTful 端点
  • 适用于复杂数据查询的 GraphQL schema（如适用）
  • 用于实时功能的 WebSocket 事件
  • 带验证规则的请求/响应 schema
  • 认证和授权要求
  • 限流和缓存策略
  • 错误响应格式和代码 定义所有平台将消费的共享数据模型。"
• 预期输出：完整的 API 规范、数据模型和集成指南

2. 设计系统和 UI/UX 一致性

• 使用 Task 工具，subagent_type="ui-ux-designer"
• 提示："使用 API 规范为功能创建跨平台设计系统：[上一步输出]。包含：
  • 每个平台的组件规范（Material Design、iOS HIG、Fluent）
  • Web 响应式布局（移动优先方法）
  • iOS（SwiftUI）和 Android（Material You）的原生模式
  • 桌面端特定考虑（键盘快捷键、窗口管理）
  • 无障碍要求（WCAG 2.2 Level AA）
  • 深色/浅色主题规范
  • 动画和过渡指南"
• 来自上一步的上下文：API 端点、数据结构、认证流程
• 预期输出：设计系统文档、组件库规范、平台指南

3. 共享业务逻辑架构

• 使用 Task 工具，subagent_type="comprehensive-review::architect-review"
• 提示："为跨平台功能设计共享业务逻辑架构。定义：
  • 核心领域模型和实体（平台无关）
  • 业务规则和验证逻辑
  • 状态管理模式（MVI/Redux/BLoC）
  • 缓存和离线策略
  • 错误处理和重试策略
  • 平台特定适配器模式 考虑使用 Kotlin Multiplatform 用于移动端或 TypeScript 用于 Web/桌面端共享。"
• 来自上一步的上下文：API 契约、数据模型、UI 要求
• 预期输出：共享代码架构、平台抽象层、实现指南

第二阶段：并行平台实现

4a. Web 实现（React/Next.js）

• 使用 Task 工具，subagent_type="frontend-developer"
• 提示："使用以下技术实现功能的 Web 版本：
  • React 18+ 配合 Next.js 14+ App Router
  • TypeScript 确保类型安全
  • TanStack Query 用于 API 集成：[API 规范]
  • Zustand/Redux Toolkit 用于状态管理
  • Tailwind CSS 配合设计系统：[设计规范]
  • Progressive Web App 能力
  • 适当的 SSR/SSG 优化
  • Web Vitals 优化（LCP < 2.5s，FID < 100ms） 遵循共享业务逻辑：[架构文档]"
• 来自上一步的上下文：API 契约、设计系统、共享逻辑模式
• 预期输出：包含测试的完整 Web 实现

4b. iOS 实现（SwiftUI）

• 使用 Task 工具，subagent_type="ios-developer"
• 提示："使用以下技术实现 iOS 版本：
  • SwiftUI 配合 iOS 17+ 功能
  • Swift 5.9+ 配合 async/await
  • URLSession 配合 Combine 用于 API：[API 规范]
  • Core Data/SwiftData 用于持久化
  • 设计系统合规：[iOS HIG 规范]
  • Widget 扩展（如适用）
  • 平台特定功能（Face ID、Haptics、Live Activities）"