14 KiB
14 KiB
移动端Claude代码配置集
Claude Code 移动开发 Android iOS Kotlin Multiplatform AI编程助手
Everything Claude Code Mobile
面向移动开发的完整 Claude Code 配置合集。
涵盖 27 个智能体、48 个技能、35 个命令和 3 个 MCP 服务器,支持 Android、iOS 和 Kotlin 多平台开发。内含端到端功能构建器,可自动完成整个功能的规划、实现、测试与审查。
本插件是 everything-claude-code 的移动端配套版本。
快速开始
第一步:安装插件
# 添加插件市场
/plugin marketplace add ahmed3elshaer/everything-claude-code-mobile
# 安装插件
/plugin install everything-claude-code-mobile@ahmed3elshaer
第二步:安装规则(必须)
# 先克隆仓库
git clone https://github.com/ahmed3elshaer/everything-claude-code-mobile.git
# 复制规则(适用于所有项目)
cp -r everything-claude-code-mobile/rules/* ~/.claude/rules/
第三步:开始使用
# 端到端构建完整功能
/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 个阶段协调专属智能体,仅凭一句描述即可构建完整功能:
/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变更后提示解析包依赖
持续学习
插件从你的开发模式中学习并持续改进:
/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 交付高质量移动应用的开发者而生。