Android Reverse Engineering Skill

Android Reverse Engineering Skill 是一款专为 Claude Code 设计的强大插件，旨在自动化 Android APK/XAPK/JAR/AAR 文件的反编译与 HTTP API 提取流程。它让开发者、安全研究人员和逆向工程师能够在没有源代码的情况下，快速记录、分析并复现应用的内部逻辑和网络通信细节。

通过集成 jadx、Fernflower/Vineflower 等主流反编译引擎，该技能不仅能还原代码结构，还能智能追踪从 UI 层（Activity/Fragment）到数据层（Repository/HTTP Client）的完整调用链，精准提取 Retrofit 端点、OkHttp 调用、硬编码 URL 及认证模式。

核心功能

1. 多引擎反编译

• 广泛支持：支持 APK, XAPK, JAR, AAR 等多种格式。
• 双引擎对比：可同时使用 jadx 和 Fernflower/Vineflower 进行反编译，并排对比输出结果，以应对复杂混淆或特定语法结构的还原难题。
• XAPK 处理：自动解压 XAPK 包并批量反编译其中的所有 APK 文件。

2. 智能 API 提取

• Retrofit/OkHttp 识别：自动扫描并提取基于 Retrofit 注解的端点定义及 OkHttp 客户端配置。
• 硬编码 URL 捕获：正则匹配代码中的硬编码 HTTP/HTTPS 地址。
• 认证模式分析：识别 Header 中的 Token、API Key 及 OAuth 流程实现。

3. 调用流追踪

• 全链路分析：跟踪从 Activity/Fragment 经过 ViewModel 到 Repository 最终发起 HTTP 请求的完整路径。
• 架构洞察：自动分析应用的整体架构模式（如 MVVM, MVP），帮助理解业务逻辑分层。

4. 混淆代码导航

• ProGuard/R8 应对：提供针对混淆代码的分析策略，帮助在模糊的类名和方法名中定位关键逻辑。
• Manifest 解析：提取权限声明、组件注册及入口点信息。

安装方法

方式一：GitHub 市场安装（推荐）

在 Claude Code 会话中直接运行以下命令：

/plugin marketplace add SimoneAvogadro/android-reverse-engineering-skill
/plugin install android-reverse-engineering@android-reverse-engineering-skill

方式二：本地克隆安装

git clone https://github.com/SimoneAvogadro/android-reverse-engineering-skill.git

然后在 Claude Code 中指向本地路径：

/plugin marketplace add /path/to/android-reverse-engineering-skill
/plugin install android-reverse-engineering@android-reverse-engineering-skill

前置要求

• 必需：
  • Java JDK 17+
  • jadx (CLI 版本)
• 可选（推荐）：
  • Vineflower 或 Fernflower：提供更清晰的 Java 代码还原，尤其适合复杂逻辑。
  • dex2jar：若使用 Fernflower 处理 APK/DEX 文件时需要。

💡 提示：运行 /decompile 时，脚本会自动检查依赖。也可手动运行 bash scripts/install-dep.sh jadx 进行安装。

使用指南

1. 斜杠命令（最快上手）

在 Claude Code 中输入：

/decompile path/to/app.apk

系统将自动执行：依赖检查 → 反编译 → 初始结构分析 → API 提取。

2. 自然语言交互

你可以直接用自然语言描述需求，Skill 会自动激活：

• “Decompile this APK and find all login endpoints.”
• “Reverse engineer this Android app and show me the network layer structure.”
• “Follow the call flow from LoginActivity to the API service.”
• “Extract all hardcoded URLs from this AAR library.”

3. 独立脚本使用

如果不使用 Claude Code，也可直接运行仓库中的脚本：

# 检查依赖
bash scripts/check-deps.sh

# 反编译 APK (默认 jadx)
bash scripts/decompile.sh app.apk

# 指定引擎反编译
bash scripts/decompile.sh --engine fernflower library.jar

# 双引擎对比
bash scripts/decompile.sh --engine both app.apk

# 查找 API 调用
bash scripts/find-api-calls.sh output/sources/ --retrofit
bash scripts/find-api-calls.sh output/sources/ --urls

应用场景

• 第三方集成开发：当官方 API 文档缺失或不完整时，通过分析竞品或合作伙伴的 App 获取接口定义。
• 安全审计：检测应用中是否存在硬编码密钥、不安全的 HTTP 传输或敏感数据泄露。
• 遗留系统维护：在没有源码的情况下，理解旧版 Android 应用的架构与逻辑。
• 竞品分析：研究竞争对手的技术栈、网络库选型及业务实现思路。