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

14 KiB
Raw Permalink Blame History

移动端Claude代码配置集

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

Everything Claude Code Mobile

Stars License Kotlin Compose Android Swift SwiftUI KMP


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

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

本插件是 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
依赖注入 KoinAndroid、Environment ObjectsiOS、Koin MultiplatformKMP
网络 Ktor ClientAndroid/KMP、URLSession + async/awaitiOS
数据库 RoomAndroid、CoreData/SwiftDataiOS、SQLDelightKMP
异步 Kotlin 协程 + Flow、Swift Concurrencyasync/await
测试 JUnit5、Mockk、Turbine、Kotest、EspressoAndroidXCTestiOS
构建 GradleKTS、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 GlassiOS 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.propertiesiOS 使用 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 installPackage.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 交付高质量移动应用的开发者而生。