multi-platform-apps-multi-platform

多平台功能开发工作流

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

[扩展思考：此工作流协调多个专用 Agent，确保各平台间的功能对等，同时保留平台特有的优化。协调策略强调共享契约与并行开发，并设置定期同步点。通过预先建立 API 契约和数据模型，各团队可以独立工作，同时确保一致性。此工作流的优势包括更快的上市时间、更少的集成问题以及可维护的跨平台代码库。]

何时使用此技能

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

何时不要使用此技能

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

说明

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

阶段 1：架构与 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 AA 级）
  • 深色/浅色主题规范
  • 动画和过渡指南"
• 来自先前步骤的上下文：API 端点、数据结构、身份验证流程
• 预期输出：设计系统文档、组件库规范、平台指南

3. 共享业务逻辑架构

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

阶段 2：并行平台实现

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 和设计系统：[设计规范]
  • 渐进式 Web 应用功能
  • 在适当情况下优化 SSR/SSG
  • 优化 Web Vitals（LCP < 2.5s，INP ≤ 200ms） 遵循共享业务逻辑：[架构文档]"
• 前序上下文：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、触觉反馈、实时活动）
  • 可测试的 MVVM 架构 遵循共享模式：[架构文档]"
• 前序上下文：API 契约、iOS 设计指南、共享模型
• 预期输出：包含单元测试和 UI 测试的原生 iOS 实现

4c. Android 实现（Kotlin/Compose）

• 使用 Task 工具，并设置 subagent_type="mobile-developer"
• 提示词："使用以下技术实现 Android 版本：
  • Jetpack Compose 和 Material 3
  • Kotlin 协程和 Flow
  • 使用 Retrofit/Ktor 调用 API：[API 规范]
  • 使用 Room 数据库进行本地存储
  • 使用 Hilt 实现依赖注入
  • 使用 Material You 动态主题：[设计规范]
  • 平台功能（生物识别身份验证、小组件）
  • 采用 MVI 模式的整洁架构 遵循共享逻辑：[架构文档]"
• 前序上下文：API 契约、Material Design 规范、共享模式
• 预期输出：包含测试的原生 Android 实现

4d. 桌面端实现（可选 — Electron/Tauri）

• 使用 Task 工具，并设置 subagent_type="frontend-mobile-development::frontend-developer"
• 提示词："使用 Tauri 2.0 或 Electron 实现桌面版本，并包含：
  • 尽可能复用 Web 代码库
  • 原生操作系统集成（系统托盘、通知）
  • 按需访问文件系统
  • 自动更新功能
  • 代码签名和公证设置
  • 键盘快捷键和菜单栏
  • 视情况支持多窗口 复用 Web 组件：[Web 实现]"
• 前序上下文：Web 实现、桌面端专属要求
• 预期输出：包含平台安装包的桌面应用程序

第 3 阶段：集成与验证

5. API 文档与测试

• 使用 Task 工具，并设置 subagent_type="documentation-generation::api-documenter"
• 提示词："创建全面的 API 文档，包括：
  • 交互式 OpenAPI/Swagger 文档
  • 平台专属集成指南
  • 各平台的 SDK 示例
  • 身份验证流程图
  • 速率限制和配额信息
  • Postman/Insomnia 集合
  • WebSocket 连接示例
  • 错误处理最佳实践
  • API 版本策略 使用各平台实现测试所有端点。"
• 前序上下文：已实现的平台、API 使用模式
• 预期输出：完整的 API 文档门户、测试结果

6. 跨平台测试与功能一致性

• 使用 Task 工具，并将 subagent_type="unit-testing::test-automator"
• 提示词："验证所有平台的功能一致性：
  • 功能测试矩阵（功能表现一致）
  • UI 一致性验证（遵循设计系统）
  • 各平台性能基准测试
  • 无障碍测试（使用平台专属工具）
  • 网络韧性测试（离线、网络缓慢）
  • 数据同步验证
  • 平台特定边缘情况
  • 端到端用户旅程测试 创建测试报告，列出平台间的任何差异。"
• 上下文：前序步骤中的所有平台实现和 API 文档
• 预期输出：测试报告、一致性矩阵、性能指标

7. 平台特定优化

• 使用 Task 工具，并将 subagent_type="application-performance::performance-engineer"
• 提示词："优化各平台的实现：
  • Web：包体积、延迟加载、CDN 设置、SEO
  • iOS：应用体积、启动时间、内存使用量、电池续航
  • Android：APK 体积、启动时间、帧率、电池续航
  • 桌面端：二进制文件体积、资源使用量、启动时间
  • API：响应时间、缓存、压缩 在保持功能一致的同时，充分利用各平台的优势。 记录优化技术和权衡。"
• 上下文：前序步骤中的测试结果和性能指标
• 预期输出：优化后的实现、性能提升

配置选项

• --platforms：指定目标平台（web,ios,android,desktop）
• --api-first：在 UI 实现之前生成 API（默认：true）
• --shared-code：使用 Kotlin Multiplatform 或类似方案（默认：evaluate）
• --design-system：使用现有设计系统或创建新的（默认：create）
• --testing-strategy：单元测试、集成测试、端到端测试（默认：all）

成功标准

• 在实现前定义并验证 API 契约
• 所有平台均通过约定的可观察行为矩阵；记录有意为之的差异
• 性能指标达到各平台的标准
• 符合无障碍标准（至少达到 WCAG 2.2 AA）
• 跨平台测试表明行为一致
• 完成所有平台的文档
• 仅在有益时衡量代码复用；不要为了达到任意百分比而牺牲原生行为
• 根据各平台的惯例优化用户体验

平台特定注意事项

Web：PWA 功能、SEO 优化、浏览器兼容性 iOS：App Store 指南、TestFlight 分发、iOS 特有功能 Android：Play Store 要求、Android App Bundles、设备碎片化 桌面端：代码签名、自动更新、特定操作系统的安装程序

初始功能规格：$ARGUMENTS

示例

用户请求：

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

限制

• 仅当任务明确符合上述范围时，才使用此技能。
• 不要将输出视为可替代环境特定验证、测试或专家审查的方案。
• 如果缺少必需的输入、权限、安全边界或成功标准，请停止并要求澄清。