用途
claude-android-ninja 是一个用于构建和迁移 Android 应用的技能包,技术栈围绕 Kotlin、Jetpack Compose、MVVM、Hilt、Room 3(KSP、SQLiteDriver、Flow/suspend DAO)、Navigation3 以及多模块 Gradle 展开。它通过分层加载的参考文档来组织知识,优先加载较小的内容,避免一次性读取数千行的完整参考文件。
主要能力
技能以 SKILL.md 作为路由入口,配合 references/-quick.md 速查文件(约 40 行,列出必需/禁止项与章节链接),以及完整 references/.md 中的单个目标章节(代码示例与检查清单)。INDEX-sections.md 仅在速查路由不足时作为锚点索引使用。
覆盖的主题包括:版本目录与依赖固定、多模块依赖、项目结构与模块划分、MVVM 分层与仓库/DI、Retrofit/OkHttp 与 NetworkModule、DataStore、Compose 模式与动画、Paging 3 + Room + 网络(RemoteMediator)、无障碍、通知与前台服务、媒体(Media3、FileProvider、sharesheet)、数据同步与离线优先、Material 3 主题、Navigation3 与深链、Kotlin 模式、协程模式、Gradle 与产品风味、代码质量(Detekt)、测试、国际化、运行时权限、Kotlin 委托、崩溃上报、设计模式、性能、调试、迁移等。
使用方式
任务通过 Quick Reference 表进行路由;当没有匹配行或需要全新项目引导时,转向 workflows.md。完整文件列表见 INDEX.md。
对既有项目:在从 assets/ 复制内容前,需先阅读 settings.gradle.kts、gradle/libs.versions.toml 以及 app 模块的构建文件,参考 dependencies.md 与 modularization.md;技术栈迁移参考 migration.md。
全新项目:按 workflows.md 中“Creating a new project?”的指引操作。
在模块、DI、导航、Room schema 或 AGP/Kotlin/KSP 变更后,需运行 ./gradlew help 然后 :app:assembleDebug(使用真实 app 模块名),参考 gradle-setup.md。
仓库外停止规则(不要用仓库编辑替代):Play 上传、轨道、发布、versionCode 参考 android-ci-cd.md;Play Integrity 前置条件(Console/Cloud 设置)参考 android-security-quick.md;生产环境 adb install / pm clear 参考 testing.md。
适用场景
技能给出了若干示例场景:全新 Android 应用(含约定插件)、新功能页面(Compose + ViewModel)、离线优先列表(Room 3 + 远程 API)、目标 SDK/编译 SDK 升级(如 API 37)。每个场景列出了应阅读的参考文件与预期结果。
限制
技能明确禁止在单个章节或速查文件已覆盖任务时加载 INDEX-sections.md 或整个数千行的参考文件。仓库外操作(Play 上传、Play Integrity 设置、生产 adb 操作)有单独的停止规则,不应通过修改仓库来替代。故障排查表列出了常见症状、可能原因与修复方向,例如 Gradle 同步失败、KSP/Room 3 错误、@TypeConverter 重命名、R8 规则、Compose 不稳定重组、ANR 或卡顿等。
关于该技能的收费、价格、平台支持范围、实际效果等事实,资料中暂未提供。