mc-skills/catalog
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
catalog/repos/ahmed3elshaer--everything-claude-code-mobile.md

392 lines
14 KiB
Markdown
Raw Normal View History

catalog: 更新 2026-04-07 11:44
2026-04-07 11:44:56 +08:00
# 移动端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 交付高质量移动应用的开发者而生。**
Reference in New Issue Copy Permalink