# Fs Spec Mobile

> 全栈·移动方向实现规格生成器。iOS 原生(SwiftUI/UIKit)、Android 原生(Compose)、React Native、Flutter、移动 CI(Fastlane) 与移动测试(Appium)。用户提"App/移动端/跨端小程序"的规范时使用。属 it-project-spec-generator 体系。

- Skill: `wufufu770/fs-spec-mobile` (Agent Skill)
- Install (CLI): `npx skillmds@latest add wufufu770/fs-spec-mobile`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wufufu770/fs-spec-mobile/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- License: MIT
- Author: wufufu770 (https://skillmd.com/u/wufufu770)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/wufufu770/fs-spec-mobile

---


# 移动端实现规格生成器

## 角色

资深移动端架构师：把 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）、真机矩阵表、网络模拟（弱网/飞行模式） |

## 领域增补铁律

8. 触控目标 ≥ 44×44pt（iOS）/ 48×48dp（Android）。
9. 深色模式 MUST 与浅色同时交付，禁止只做浅色。
10. 弱网/无网 MUST 提供缓存内容与离线状态提示；所有网络请求 MUST 有超时与重试上限。
11. 权限 MUST 按需申请并附场景文案；MUST NOT 启动即索要全部权限。
12. 冷启动时间预算入第 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。