用途:构建、修改并验证跨平台移动应用功能,覆盖移动端界面、组件、平台能力集成、离线优先架构和端到端测试。适用于需要原生或跨平台移动行为的场景,而非 Web 前端或后端 API 工作。
主要能力:按 Clean Architecture(domain→data→presentation)组织代码;使用 Riverpod/Bloc 做状态管理,避免复杂逻辑直接用 setState;界面遵循 Material Design 3(Android)与 iOS HIG;支持相机、GPS、推送通知等平台能力与离线优先架构;网络层在 Flutter 用 Dio、React Native 在 TanStack Query 下用 axios、Swift 用生成的 Client 中间件;E2E 关键流程使用 Maestro;Swift 原生使用 SwiftUI + @MainActor @Observable 视图模型,按 App/Core/Features/Shared 布局,单元测试用 XCTest 或 Swift Testing,关键流程用 XCUITest。
使用方式:先识别目标平台、屏幕或功能、架构层与状态边界,检查既有移动端模式与依赖,确定测试级别与验证环境;随后读取现有组件、状态提供者、API 客户端与测试,实施 UI、状态、平台集成、离线处理和测试,运行相关单元/组件/集成/E2E 检查并汇报结果。代码检索可使用 Serena 的 find_file、search_for_pattern、get_symbols_overview、find_symbol 等工具。
限制:需具备对应 Flutter/Dart 或 React Native 工具链及相关 SDK;若平台 SDK 或模拟器不可用,需说明验证限制;缺少权限或原生能力时应补充平台配置或记录阻塞;业务逻辑应放在 domain/data 层;未建立既有技术选型时才套用默认方案,局部编辑不授权技术栈迁移;仅在项目已采用 OpenAPI 生成时才使用其生成的 Client。详细步骤、模板与检查清单见 resources/execution-protocol.md、variants/*/snippets.md、resources/checklist.md 等参考文件。