catalog/repos/ahmed3elshaer--everything-claude-code-mobile.md

# 移动端Claude代码配置集

`Claude Code` `移动开发` `Android` `iOS` `Kotlin Multiplatform` `AI编程助手`

# Everything Claude Code Mobile

[![Stars](https://img.shields.io/github/stars/ahmed3elshaer/everything-claude-code-mobile?style=flat)](https://github.com/ahmed3elshaer/everything-claude-code-mobile/stargazers)
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
![Kotlin](https://img.shields.io/badge/-Kotlin-7F52FF?logo=kotlin&logoColor=white)
![Compose](https://img.shields.io/badge/-Jetpack%20Compose-4285F4?logo=jetpackcompose&logoColor=white)
![Android](https://img.shields.io/badge/-Android-3DDC84?logo=android&logoColor=white)
![Swift](https://img.shields.io/badge/-Swift-FA7343?logo=swift&logoColor=white)
![SwiftUI](https://img.shields.io/badge/-SwiftUI-0D96F6?logo=swift&logoColor=white)
![KMP](https://img.shields.io/badge/-Kotlin%20Multiplatform-7F52FF?logo=kotlin&logoColor=white)

---

**面向移动开发的完整 Claude Code 配置合集。**

涵盖 27 个智能体、48 个技能、35 个命令和 3 个 MCP 服务器，支持 **Android**、**iOS** 和 **Kotlin 多平台**开发。内含端到端功能构建器，可自动完成整个功能的规划、实现、测试与审查。

> 本插件是 [everything-claude-code](https://github.com/ahmed3elshaer/everything-claude-code) 的移动端配套版本。

---

## 快速开始

### 第一步：安装插件

```bash
# 添加插件市场
/plugin marketplace add ahmed3elshaer/everything-claude-code-mobile

# 安装插件
/plugin install everything-claude-code-mobile@ahmed3elshaer
```

### 第二步：安装规则（必须）

```bash
# 先克隆仓库
git clone https://github.com/ahmed3elshaer/everything-claude-code-mobile.git

# 复制规则（适用于所有项目）
cp -r everything-claude-code-mobile/rules/* ~/.claude/rules/
```

### 第三步：开始使用

```bash
# 端到端构建完整功能
/feature-build Add user authentication with biometrics

# 构建 Android 项目
/android-build

# 修复 Gradle 问题
/gradle-fix

# TDD 工作流
/mobile-tdd

# 查看所有命令
/plugin list everything-claude-code-mobile@ahmed3elshaer
```

---

## 功能构建流水线

这是本插件的核心能力。`/feature-build` 通过 7 个阶段协调专属智能体，仅凭一句描述即可构建完整功能：

```bash
/feature-build Add push notification support
/feature-build --platform=android Implement offline caching
/feature-build --platform=kmp Add offline sync for user data
```

### 阶段说明

| # | 阶段 | 执行内容 |
|---|------|----------|
| 1 | **规划** | `feature-planner` + `mobile-architect` 分析项目并生成结构化实现方案 |
| 2 | **实现** | 5 个分层智能体按依赖顺序运行（架构 -> 网络 + UI -> 数据 -> 集成） |
| 3 | **测试** | `unit-test-writer` + `ui-test-writer` 创建测试，目标覆盖率 80% |
| 4 | **构建修复** | 编译并迭代修复错误 |
| 5 | **质量门控** | 并行执行代码审查 + 安全审计 + 性能评审 |
| 6 | **验证** | `mobile-verifier` 运行 pass@k 指标与覆盖率确认 |
| 7 | **学习** | 提取模式并更新开发直觉 |

### 实现智能体 DAG

```
阶段 1:  architecture-impl    （领域模型、接口、DI 骨架）
               |
          +----+----+
阶段 2:  network   ui-impl    （API 客户端、DTO / Compose 界面、组件）
          -impl      |
            |        |
阶段 3:  data-impl  |         （仓库层、本地数据库、缓存）
               |     |
          +----+----+
阶段 4:  wiring-impl          （DI 绑定、导航、功能开关）
```

### 功能命令

| 命令 | 说明 |
|------|------|
| `/feature-build` | 端到端功能构建（全部 7 个阶段） |
| `/feature-plan` | 规划架构、文件、依赖和测试策略 |
| `/feature-implement` | 使用并行分层智能体执行方案 |
| `/feature-test` | 创建单元测试、UI 测试和 E2E 测试 |
| `/feature-build-fix` | 编译并修复构建错误 |
| `/feature-quality-gate` | 代码审查 + 安全 + 性能审计 |
| `/feature-status` | 显示当前功能构建进度 |
| `/feature-learn` | 从已完成功能中提取模式 |

---

## 内容结构

```
everything-claude-code-mobile/
├── agents/           # 27 个专属智能体
│   ├── 代码审查:    android-reviewer, ios-reviewer
│   ├── 构建:        android-build-resolver, xcode-build-resolver, gradle-expert
│   ├── 架构:        mobile-architect, kmp-architect, feature-planner, shared-model-designer
│   ├── UI/设计:     compose-guide, swiftui-guide, m3-expressive-guide, liquid-glass-guide
│   ├── 实现层:      architecture-impl, network-impl, data-impl, ui-impl, wiring-impl
│   ├── 测试:        mobile-tdd-guide, mobile-e2e-runner, unit-test-writer, ui-test-writer, mobile-verifier
│   └── 学习:        mobile-pattern-extractor, mobile-compactor
│
├── skills/           # 48 个平台技能
│   ├── Android:     android-patterns, jetpack-compose, navigation-compose, coroutines-patterns,
│   │                koin-patterns, room-patterns, gradle-patterns, m3-expressive
│   ├── iOS:         swift-patterns, swiftui-patterns, combine-framework, core-data,
│   │                ios-testing, liquid-glass
│   ├── KMP:         kmp-di, kmp-navigation, kmp-networking, kmp-repositories,
│   │                expect-actual, shared-coroutines, shared-models, sqldelight-patterns
│   ├── 架构:        mvi-architecture, feature-builder, mobile-testing, mobile-security
│   ├── 功能:        deep-linking, feature-flags, offline-first, pagination-patterns,
│   │                push-notifications, image-loading, localization-patterns,
│   │                analytics-patterns, app-lifecycle, accessibility-patterns, ktor-patterns
│   └── 学习:        continuous-learning, continuous-learning-v2, mobile-instinct-v1,
│                    mobile-instinct-v2, mobile-checkpoint, mobile-compaction, mobile-memory
│
├── commands/         # 35 个斜杠命令
├── rules/            # 5 条强制规则
├── contexts/         # 7 个动态上下文文件
├── hooks/            # 自动触发的检查与模式提取
└── mcp-servers/      # 3 个持久化内存服务器
```

---

## 技术栈

| 分类 | 技术 |
|------|------|
| **语言** | Kotlin、Swift |
| **UI** | Jetpack Compose、SwiftUI、UIKit（旧版） |
| **设计系统** | Material 3 Expressive、Apple Liquid Glass |
| **架构** | MVI、Clean Architecture、MVVM |
| **依赖注入** | Koin（Android）、Environment Objects（iOS）、Koin Multiplatform（KMP） |
| **网络** | Ktor Client（Android/KMP）、URLSession + async/await（iOS） |
| **数据库** | Room（Android）、CoreData/SwiftData（iOS）、SQLDelight（KMP） |
| **异步** | Kotlin 协程 + Flow、Swift Concurrency（async/await） |
| **测试** | JUnit5、Mockk、Turbine、Kotest、Espresso（Android）；XCTest（iOS） |
| **构建** | Gradle（KTS）、Xcode、SPM、CocoaPods |

---

## 命令

### 构建与修复

| 命令 | 说明 |
|------|------|
| `/android-build` | 构建 Android 项目，修复错误，生成 APK/AAB |
| `/ios-build` | 使用 Xcode 构建 iOS 项目 |
| `/kmp-build` | 构建 Kotlin 多平台项目 |
| `/gradle-fix` | 解决 Gradle 同步/依赖问题 |
| `/kmp-dependency-fix` | 修复 KMP 依赖冲突 |
| `/compose-preview` | 验证 Compose 预览是否可编译 |
| `/lint-android` | 运行 Detekt、ktlint、Android Lint |
| `/swiftlint` | 运行 SwiftLint 检查 iOS 代码风格 |
| `/release-build` | 构建发布/生产版本 |
| `/mobile-build` | 通用移动端构建命令 |

### 测试

| 命令 | 说明 |
|------|------|
| `/mobile-tdd` | TDD 工作流（红 -> 绿 -> 重构） |
| `/android-test` | 运行 Android 单元测试和插桩测试 |
| `/ios-test` | 运行 iOS 单元测试和 UI 测试 |
| `/kmp-test` | 运行 KMP 共享模块测试 |
| `/compose-test` | 使用 Espresso 运行 Compose UI 测试 |
| `/mobile-test` | 运行移动端测试（单元 + UI） |
| `/mobile-verify` | 对照规格验证实现 |

### 规划与审查

| 命令 | 说明 |
|------|------|
| `/mobile-plan` | 规划移动端功能实现 |
| `/android-review` | Android 专项代码审查 |
| `/platform-info` | 显示检测到的平台（Android/iOS/KMP） |

### 学习

| 命令 | 说明 |
|------|------|
| `/learn` | 从当前会话中提取模式 |
| `/instinct-status` | 查看已学习的移动端模式 |
| `/instinct-export` | 导出模式以供分享 |
| `/instinct-import` | 从外部来源导入模式 |
| `/evolve` | 将直觉聚合为可复用技能 |

---

## 智能体（27 个）

### 代码审查

| 智能体 | 适用场景 |
|--------|----------|
| `android-reviewer` | Kotlin/Compose 代码审查，遵循 Google 最佳实践 |
| `ios-reviewer` | Swift/SwiftUI 代码审查，遵循 Apple 最佳实践 |
| `mobile-security-reviewer` | 安全审计：密钥、加密、网络、存储 |
| `mobile-performance-reviewer` | 启动耗时、内存、渲染、电量 |

### 构建与编译

| 智能体 | 适用场景 |
|--------|----------|
| `android-build-resolver` | Gradle 同步、AGP、R8/ProGuard、依赖冲突 |
| `xcode-build-resolver` | Xcode、SPM、代码签名、CocoaPods、模拟器错误 |
| `gradle-expert` | Gradle 优化、版本目录、约定插件 |

### 架构与规划

| 智能体 | 适用场景 |
|--------|----------|
| `mobile-architect` | MVI、Clean Architecture、模块化 |
| `kmp-architect` | KMP 共享模块、expect/actual、跨平台 DI |
| `feature-planner` | 带架构评审的功能规划 |
| `shared-model-designer` | 带 @ObjCName 的跨平台数据模型 |

### UI 与设计

| 智能体 | 适用场景 |
|--------|----------|
| `compose-guide` | Compose 状态、重组、主题、动画 |
| `swiftui-guide` | SwiftUI 状态、视图优化、主题 |
| `m3-expressive-guide` | Material 3 Expressive：弹簧动画、形状变形、28 个组件 |
| `liquid-glass-guide` | 适用于 SwiftUI 的 Apple Liquid Glass（iOS 26+） |

### 实现层智能体

这些智能体由 `/feature-implement` 编排，按依赖顺序运行：

| 智能体 | 层次 | 创建内容 |
|--------|------|----------|
| `architecture-impl` | 领域层 | 用例、领域模型、仓库接口、DI 模块 |
| `network-impl` | 网络层 | API 客户端、DTO、请求/响应模型（Ktor / URLSession） |
| `data-impl` | 数据层 | 仓库实现、本地存储、缓存（Room / CoreData / SQLDelight） |
| `ui-impl` | 表示层 | 界面、ViewModel、状态管理（Compose / SwiftUI） |
| `wiring-impl` | 集成层 | 导航、DI 注册、Manifest 配置、功能开关 |

### 测试

| 智能体 | 适用场景 |
|--------|----------|
| `mobile-tdd-guide` | TDD 强制执行（新功能必须遵循） |
| `mobile-e2e-runner` | Espresso E2E 测试、UI 自动化 |
| `unit-test-writer` | ViewModel、UseCase、Repository 测试（JUnit5 + Mockk + Turbine） |
| `ui-test-writer` | Compose UI 测试、SwiftUI 测试、无障碍测试 |
| `mobile-verifier` | 带 pass@k 指标的自动化验证循环 |

### 学习与质量

| 智能体 | 适用场景 |
|--------|----------|
| `mobile-pattern-extractor` | 分析代码库中的可复用模式 |
| `mobile-compactor` | 针对 token 优化的上下文压缩策略 |

---

## 强制规则

以下规则始终生效，适用于所有项目：

- **测试覆盖率最低 80%**
- **强制 TDD 工作流**（红 -> 绿 -> 重构）
- **禁止硬编码密钥**（Android 使用 BuildConfig/local.properties，iOS 使用 Keychain）
- **不可变优先**（`val`/`let`、不可变集合、带 `copy()` 的数据类）
- **空安全**（安全调用、Elvis 运算符，最小化 `!!`/强制解包）
- **Compose/SwiftUI 最佳实践**（状态提升，组合/body 中不含副作用）
- **仅使用 HTTPS**，生产环境启用证书固定
- **结构化并发**（协程/async-await，禁用 GlobalScope/DispatchQueue.main.async）
- **文件不超过 400 行，函数不超过 50 行，嵌套不超过 4 层**

---

## MCP 服务器

三个持久化内存服务器在会话之间维护上下文：

| 服务器 | 用途 |
|--------|------|
| `mobile-memory` | 项目结构、依赖、架构、测试状态 |
| `ios-memory` | iOS 项目状态、SwiftUI 组件、XCTest 模式 |
| `kmp-context` | KMP 模块结构、expect/actual 模式、共享模型 |

---

## 上下文

动态上下文文件根据项目类型自动注入：

| 上下文 | 激活条件 |
|--------|----------|
| `android-dev` | 检测到 Android 项目（Kotlin、Gradle、Compose） |
| `ios-dev` | 检测到 iOS 项目（Swift、Xcode、SwiftUI） |
| `kmp-dev` | 检测到 KMP 项目（共享模块、多平台） |
| `compose-dev` | 正在编辑 Jetpack Compose 代码 |
| `swiftui-dev` | 正在编辑 SwiftUI 代码 |
| `uikit-dev` | 正在编辑 UIKit（旧版）代码 |
| `mobile-memory-context` | 持久化内存系统已激活 |

---

## Hooks

自动化检查在特定事件触发：

### Android Hooks
- **反模式检测**：标记 Kotlin 文件中的 `GlobalScope`、`!!`、`runBlocking`
- **TDD 提醒**：创建 ViewModel 时提示补充测试文件
- **模式提取**：退出时从会话中学习模式

### iOS Hooks
- **反模式检测**：标记 Swift 文件中的强制解包 `!`、`DispatchQueue.main.async`
- **预览提醒**：编辑 `ContentView.swift` 时提示添加 `#Preview`
- **依赖提醒**：Podfile 变更后提示运行 `pod install`，`Package.swift` 变更后提示解析包依赖

---

## 持续学习

插件从你的开发模式中学习并持续改进：

```bash
/learn                  # 从当前会话提取模式
/instinct-status        # 查看已学习的移动端模式
/instinct-export        # 导出模式以供分享
/instinct-import        # 从外部来源导入模式
/evolve                 # 将直觉聚合为可复用技能
```

可学习的模式包括：
- Compose 重组优化
- ViewModel/Repository 模式
- Koin 模块组织
- Ktor 客户端配置
- SwiftUI 状态管理惯用法
- KMP expect/actual 模式
- 各框架的测试模式

---

## 贡献

欢迎贡献！以下方向尤为需要：

- 更多平台专属模式
- CI/CD 配置（Fastlane、GitHub Actions）
- App Store/Play Store 指南
- 无障碍测试命令
- 设备农场集成

---

## 许可证

MIT — 可自由使用、按需修改，如有改进欢迎回馈社区。

---

**为使用 Claude Code 交付高质量移动应用的开发者而生。**