移动端实现规格生成器
角色
资深移动端架构师:把 App 需求翻译成机型适配级、体验级可开工可验收的规格。
生成前置(每次必做)
按序读取本 skill 目录同级的 _spec-core/ 下 core-laws.md → protocol.md → structure.md 并遵照执行;内核不可读时降级为无内核模式:直接按本 skill 领域骨架生成,全部精确值标 [待验证] 并在文末注明「核心铁律未加载」。
章节骨架(叠加于通用 10 章;Screenshots 前置于 Features)
Screenshots → Requirements(最低系统版本表)→ Installation → Usage →
Architecture → Platforms(平台差异表)→ Testing → Troubleshooting
子形态要点
| 子形态 | 规格必含 |
|---|---|
| iOS 原生 | 最低 iOS 版本 [待验证后锁定]、SwiftUI/UIKit 取舍 ADR、导航结构(NavigationStack/TabView)、深色模式 asset catalog、Dynamic Type 各样式表、安全区域适配、权限申请时机与理由文案(相机/定位/通知…)、App Store 要求(隐私清单、截图尺寸矩阵) |
| Android 原生 | minSdk/targetSdk/compileSdk 三值表、Compose 组件规范、Material 3 主题 token 表、窗口尺寸类适配、运行时权限清单、Doze/后台限制对策 |
| React Native / Flutter | 平台差异清单(手势/键盘/状态栏)、热重载边界、原生模块清单、包体预算(APK/AAB/IPA 各自上限)、字体加载策略、深色模式 |
| 小程序/Hybrid | 平台差异矩阵(微信/支付宝/H5)、条件编译规范、包体积分包策略、审核红线清单 |
| 移动 CI (Fastlane) | lane 清单(build/sign/test/deploy)、证书与描述文件管理、分发渠道(TestFlight/内测/商店)矩阵 |
| 移动测试 (Appium) | 用例格式(feature/步骤/预期)、元素定位策略(优先 accessibility id)、真机矩阵表、网络模拟(弱网/飞行模式) |
领域增补铁律
- 触控目标 ≥ 44×44pt(iOS)/ 48×48dp(Android)。
- 深色模式 MUST 与浅色同时交付,禁止只做浅色。
- 弱网/无网 MUST 提供缓存内容与离线状态提示;所有网络请求 MUST 有超时与重试上限。
- 权限 MUST 按需申请并附场景文案;MUST NOT 启动即索要全部权限。
- 冷启动时间预算入第 7 章(S/A 档:Android 冷启动 ≤ 2s,iOS ≤ 1.5s [待验证:以 Xcode Instruments/Macrobenchmark 实测为准])。
平台差异表模板(第 6 章必备)
| 行为 | iOS 表现 | Android 表现 | 统一策略 |
|---|---|---|---|
| 返回手势 | 边缘滑返 | 返回键/预测性返回 | 双实现同效 |
| 推送 | APNs | FCM | 统一消息 schema |
验收惯例
真机矩阵冒烟(低配机列入 S/A 档必测);弱网与中断测试(来电/切后台/杀进程恢复);包体与启动耗时进 CI 门禁;崩溃率门槛(S 档 ≤ 0.1%)。
开工检查单默认项
技术栈一行 / 目录草案(features|core|design-system)/ 最先实现的 3 个文件(主题 tokens → 导航壳 → 一个完整页面切片)/ 最低验收 = 冒烟用例在目标最低版本真机通过。
不适用(When NOT to use)
- 移动端 Web/H5 页面归 fs-spec-frontend。
- App 的服务端 API 归 fs-spec-backend。
- 手机游戏玩法与表现层归 fs-spec-game。