CkSKILLS: Skill for Claude Code

asc-fast-hunt — APK 零预处理快速定位（Droid ASC）

定位：本技能是秒级定位引擎，解决"先全量反编译再搜索"的等待问题——把 APK 当只读数据库直接查询，不建全局索引、不落全量产物，命中即按需反编译单个类。它只负责快速定位与读实现，不负责脱壳、不负责漏洞定级与成稿。

三段式分工：asc-fast-hunt（秒级快筛定位）→ apk-reversing（加固壳脱壳 + 全量还原，仅当快筛命中值得深挖时）→ android-security-audit（组件安全/密钥追踪深挖 + 动态验证）→ report（DOCX 成稿）。

出处声明（必须保留）

• 工具仓库：**https://github.com/MG1937/ASC**（Droid ASC，Black Hat Europe Arsenal 议题）
• 本 SKILL 只是对该工具的封装与工作流编排，工具算法与实现版权归原作者所有，未做任何代码修改
• 原仓库无 LICENSE 文件（默认保留所有权利）：仅限本机自用与授权测试，不得对外分发、不得打包发布、不得声称自有
• 本机已装位置：/Users/apple/Desktop/武器库/5.逆向/ASC/（与 jadx、ida-mcp-server 并列）；如需重建见本文「环境安装与自检」

何时调用（触发条件）

• 拿到 APK 想知道"有没有硬编码密钥/隐藏接口/调试后门"，不想等 JADX 全量反编译（大包动辄几十分钟 + 数 GB 内存）
• APK > 100MB（系统应用、游戏、大厂 App），全量反编译成本过高
• 已有脱壳产物（裸 dex / dex 分片），需要快速检索而不是重新全量反编译
• 只想先看 Manifest 的 exported 组件、权限、scheme 清单，再决定挖不挖
• android-security-audit 一、密钥追踪专项需要快速找到签名类/密钥常量位置时（本技能负责定位，它负责还原算法与验证接口）
• 不确定某个 APK 值不值得投入全量还原成本，需要先 triage

不适用：加固壳脱壳（→ apk-reversing）、漏洞定级与验证（→ android-security-audit）、需要跨类数据流/完整工程视图的静态审计（→ 全量反编译产物 + source-code-audit）

---

一、环境安装与自检

硬门槛：Python ≥ 3.11（工具用了原子分组正则 (?>(?:...))，3.9/3.10 会直接报 unknown extension ?>）。唯一第三方依赖 androguard（本机实测 4.1.4）。

# 已装好（本机）：直接自检
ASC=/Users/apple/Desktop/武器库/5.逆向/ASC
$ASC/asc 2>&1 | head -5                    # 打印用法 = 环境正常
$ASC/asc_manifest <任意.apk> | head -3     # Manifest 解析 = androguard 正常

# 从零重建（换机/环境损坏时）
git clone --depth 1 https://github.com/MG1937/ASC $ASC
cd $ASC && python3.11 -m venv .venv && ./.venv/bin/pip install androguard==4.1.4 loguru

自检三连（开工前 10 秒确认）：

$ASC/asc findrefs <target.apk> string token | head -3      # 有无命中都要无报错
$ASC/asc_manifest <target.apk> | grep -c "uses-permission" # 权限条数 > 0 即解析成功

---

二、工具速查

2.1 四个核心命令

ASC=/Users/apple/Desktop/武器库/5.逆向/ASC

# ① Manifest 秒读（组件面/权限/scheme 清单，零反编译）
$ASC/asc_manifest <apk>                                  # 约 0.3s
$ASC/asc_manifest <apk> | grep -B2 -A6 'exported="true"' # 导出组件
$ASC/asc_manifest <apk> | grep 'android:scheme'          # Deep Link scheme

# ② 全局交叉引用搜索（findrefs，四个维度）
$ASC/asc findrefs <apk> string <关键词>                   # 模糊搜字符串使用点
$ASC/asc findrefs <apk> type com.x.Y                     # 模糊搜类型引用点
$ASC/asc findrefs <apk> method <方法名> [--class <类>] [--fuzzy-class]
$ASC/asc findrefs <apk> field <字段名> [--class <类>] [--fuzzy-class]
$ASC/asc findrefs <apk> string appkey -o refs.txt        # 输出存盘（便于通读）
$ASC/asc findrefs --debug <apk> string token             # 耗时统计（--debug 必须在子命令前）

# ③ 按需反编译单个类（getclass）
$ASC/asc getclass <apk> Lcom/x/Y; -o Y.java              # Dalvik 格式
$ASC/asc getclass <apk> com.x.Y -o Y.java                # 点分格式（自动转换）