android-dev-tools

Android 开发工具 - Claude Code 插件

English

一站式 Android 开发工具集。安装一次，拥有全部功能。

---

安装

npx skills add adzcsx2/android-claude-skills

或通过 Claude Code 插件系统安装：

# 1. 添加 marketplace
/plugin marketplace add github.com/adzcsx2/claude_skill

# 2. 安装（包含所有 skills）
/plugin install android-dev-tools@android-dev-tools

---

仓库结构

claude_skill/
├── .claude-plugin/
│   └── marketplace.json
├── plugins/
│   └── android-dev-tools/
│       ├── .claude-plugin/
│       │   └── plugin.json
│       └── skills/
│           ├── init-android/
│           │   ├── SKILL.md
│           │   └── README.md
│           ├── gradle-build-performance/
│           │   ├── SKILL.md
│           │   └── README.md
│           ├── update-docs/
│           │   ├── SKILL.md
│           │   └── README.md
│           ├── android-i18n/
│           │   ├── SKILL.md
│           │   └── README.md
│           ├── android-fold-adapter/
│           │   ├── SKILL.md
│           │   └── README.md
│           ├── code-note/
│           │   ├── SKILL.md
│           │   └── README.md
│           ├── auto-ui-test/
│           │   ├── SKILL.md
│           │   ├── README.md
│           │   └── references/
│           │       ├── doc-parser-guide.md
│           │       └── midscene-reference.md
│           ├── push/
│           │   ├── SKILL.md
│           │   └── README.md
│           └── update-remote-plugins/
│               ├── SKILL.md
│               └── README.md
├── README.md                  # 中文
├── README_EN.md               # 英文
└── .gitignore

---

环境要求

• Claude Code CLI
• update-docs 需要：标准结构的 Android 项目

包含的 Skills

Skill	描述
init-android	初始化或优化 Android 项目的 claude.md 文件
gradle-build-performance	调试和优化 Gradle 构建性能
update-docs	生成中文技术文档
android-i18n	审计并生成 4 种语言的国际化资源
android-fold-adapter	诊断和修复折叠屏适配问题
code-note	为 Kotlin/Java 源文件添加中文注释
auto-ui-test	Android UI自动化测试 - Midscene视觉驱动 + ADB快速执行，支持文档驱动测试
push	一键发布：自动暂存、拉取最新、逐文件提交、生成文档、推送到远程
update-remote-plugins	审计生成 Skill README，同步 marketplace 并更新本地插件

---

init-android

初始化或优化 Android 项目的 claude.md 文件。从 Gradle 配置和源码目录检测真实项目结构，合并已有规则，生成简洁的 AI 指导文件。

功能：

• 从 Gradle 配置和源码目录检测真实项目结构
• 合并已有规则（claude.md、common.mdc）
• 生成简洁低 token 的 AI 指导文件
• 四个必须段落：AI 工作原则、单一事实来源、局部一致性规则、项目强约束
• 文档索引格式校验（仅合法 Markdown 链接）
• 可选生成 checklist（API、依赖、模块）
• 自动将 claude.md 和 checklist 文档添加到 .gitignore

用法： /android-dev-tools:init-android

---

gradle-build-performance

调试和优化 Android/Gradle 构建性能。

功能：

• 新增： 诊断工作流，提供分级风险方案（零风险/低风险/中等风险）
• 新增： 常见问题检测（动态版本、版本不一致等）
• 新增： 推荐 gradle.properties 模板
• 分析 Gradle 构建扫描
• 识别配置与执行阶段瓶颈
• 启用配置缓存、构建缓存、并行编译
• 优化 CI/CD 构建时间
• 调试 kapt/KSP 注解处理
• Groovy DSL 和 Kotlin DSL 示例

用法： /android-dev-tools:gradle-build-performance

---

update-docs

为 Android 项目自动生成中文技术文档。

功能：

• 分析项目结构
• 生成界面文档（控件、功能说明）
• 文档化导航流程（Activity-Fragment 关系）
• 列出四大组件（Activity、Service、Receiver、Provider）
• 文档化通知渠道和 API 接口
• 支持增量更新
• 将根目录 md 文件迁移到 docs/ 目录
• 更新 README 并添加分类文档快捷链接
• 新增 (v2.7.0)： CHANGELOG.md 作为更新列表，支持点击查看详情
• 新增 (v2.7.0)： 详细更新文档存放在 docs/update-list/，记录实际内容变更
• 新增 (v2.7.0)： README 只显示最近 1 条更新（链接到 CHANGELOG 查看全部）
• 新增 (v2.7.0)： 记录文档内容变更，不仅仅是 git 提交

用法：

/android-dev-tools:update-docs [--force] [--dry-run] [interfaces|navigation|components|notifications|api]

---

code-note

为 Kotlin/Java 源文件添加中文注释。

功能：

• 分析代码结构（类、方法、变量）
• 添加 KDoc/JavaDoc 风格文档
• 注释关键逻辑块
• 简短但全面的注释
• 保持原有代码格式

用法：

/android-dev-tools:code-note 文件名

示例：

• /android-dev-tools:code-note AlbumActivity
• /android-dev-tools:code-note LoginActivity.kt

---

update-remote-plugins

同步 marketplace.json 与插件目录，审计生成每个 skill 的 README.md，并更新 README 文件。

功能：

• 审计并生成每个 skill 目录的 README.md（从 SKILL.md 自动提取）
• 扫描插件目录变更
• 插件修改时自动升级版本号
• 添加/移除插件到 marketplace.json
• 同步中英文 README 文件
• 提交并推送到远程
• 同步更新到本地 Claude Code 插件目录

用法： /android-dev-tools:update-remote-plugins

---

android-i18n

审计 Android 项目中的硬编码中文字符串并生成国际化资源。

功能：

• 扫描 XML 布局和 Kotlin/Java 代码中的中文字符串
• 在 strings.xml 中生成字符串资源
• 自动翻译为 4 种语言 (en/ru/zh/zh-rTW)
• 更新代码使用资源引用

用法：

/android-dev-tools:android-i18n [项目路径]

---

android-fold-adapter

诊断和修复 Android 折叠屏适配问题。

功能：

• 诊断折叠/展开时的 Activity 重建问题
• 修复状态丢失问题（UI 可见性、数据字段）
• 解决 Fragment 引用失效（ViewPager2）
• 自动更新 skill 以记录新模式/解决方案
• 归档已知问题供将来参考

用法：

/android-dev-tools:android-fold-adapter "搜索页折叠后内容消失"

---

auto-ui-test

Android UI 自动化测试，智能选择执行模式，支持文档驱动测试。

功能：

• 双执行模式： Midscene 视觉驱动 + ADB 快速执行
• 文档驱动测试： 从 markdown 文档解析测试用例
• 智能过滤： 跳过 PASS 用例，仅测试 FAIL/待验证用例
• 自动生成报告： 报告保存到 docs/test/report/
• 智能模式选择： 自动选择最优执行方式

用法：

# 直接执行测试任务
/android-dev-tools:auto-ui-test 点击Toast按钮，等待3秒后截图

# 文档驱动测试（解析文档并执行测试）
/android-dev-tools:auto-ui-test docs/test/UI_TEST_REPORT.md