cUDGk/apk-mod-skill
GitHub: cUDGk/apk-mod-skill
为 Claude Code 提供一套 APK 解析到 UI 注入与维护的自动化技能，解决手动改造流程复杂、一致性差的问题。
Stars: 0 | Forks: 0
# apk-mod-skill
### Android APK 解析から UI 追加・配布までを Claude Code に渡すスキル
[](SKILL.md)
[](https://developer.android.com/)
[](https://github.com/JesusFreke/smali)
[](https://frida.re/)
[](https://github.com/LSPosed/LSPosed)
[](LICENSE)
**APK を解析して UI・機能を足し、再配布可能な mod として仕上げるまでの工程を Claude Code に読み込ませるためのスキル集**
## 概要
Claude Code に読み込ませて使う「APK 改造実装スキル」。初回解析からターゲット特定、UI 設計、smali 注入、ビルド、署名、アプデ追従、拡張テーマ（SSL pinning 回避・Frida ハイブリッド・LSPosed・Compose・ProGuard mapping）までを 1 つのスキルとして束ねている。
AI に「この APK をこう改造したい」と投げた時、本スキルが読み込まれていれば、フェーズ分解・決定木・smali テンプレ・Frida スクリプト雛形を持った状態で伴走してくれる。
## 特徴
| 項目 | 内容 |
|---|---|
| 形式 | Claude Code 互換 Skill（`SKILL.md` + `references/` による progressive disclosure） |
| カバー範囲 | 解析 → ターゲット特定 → UI 設計 → smali 注入 → ビルド → 保守 |
| 拡張トピック | SSL pinning 回避 / ProGuard mapping / Compose / Frida / LSPosed |
| テンプレート | Makefile, smali 断片, Frida スクリプト雛形 |
| 対応ルート | リパック方式 / LSPosed 方式 / ハイブリッド |
| 言語 | 全編日本語 |
## インストール
### ユーザー全体（どのプロジェクトでも使える）
```
mkdir -p ~/.claude/skills
git clone https://github.com/cUDGk/apk-mod-skill.git ~/.claude/skills/apk-mod
```
### プロジェクト単位
```
mkdir -p .claude/skills
git clone https://github.com/cUDGk/apk-mod-skill.git .claude/skills/apk-mod
```
インストール後、Claude Code を起動すると `apk-mod` スキルが自動認識される。APK 改造の依頼が来ると `SKILL.md` が読まれ、必要に応じて `references/` 配下が遅延ロードされる。
## 使い方
```
ユーザー: このアプリの再生画面にダウンロードボタンを追加したい。APKは手元にある。
↓
Claude Code: SKILL.md 読み込み → 決定木で「リパック + View系UI注入」と判断
→ references/01-analysis.md で解析 → references/02-ui-design.md で UI 設計
→ references/03-smali-injection.md で注入 → templates/Makefile で回す
```
## 構成
```
apk-mod-skill/
├── SKILL.md # スキル本体・起動条件・決定木・原則
├── references/
│ ├── 01-analysis.md # Phase 0-2: 準備・初回解析・ターゲット特定
│ ├── 02-ui-design.md # Phase 3: UI 設計と Android Studio → smali 移植
│ ├── 03-smali-injection.md # Phase 4: smali 注入パターン集
│ ├── 04-build-debug.md # Phase 5-7: ビルド・署名・デバッグ・仕上げ
│ ├── 05-maintenance.md # Phase 8: アプデ追従・保守
│ ├── ext-ssl-pinning.md # SSL pinning 回避・通信差し替え
│ ├── ext-proguard.md # ProGuard mapping.txt の活用
│ ├── ext-compose.md # Jetpack Compose アプリへのオーバーレイ戦略
│ ├── ext-frida.md # Frida gadget 埋め込みハイブリッド
│ └── ext-lsposed.md # LSPosed モジュール版の書き方
└── templates/
├── Makefile # make decode / build / install / log
├── targets.md # 注入ターゲット一覧テンプレ
├── smali/ # 再利用 smali 断片
└── frida/ # 汎用 Frida スクリプト
```
## 対応ルート
| ルート | 向き | 特徴 |
|---|---|---|
| リパック | 一般配布・root 不要アプリ | APK を展開→注入→再署名。署名が変わるため Google 系ログインは死ぬ |
| LSPosed | root 前提・頻繁更新アプリ | 元 APK 無改造。アプデ追従楽。Play Integrity 対策は別途 |
| ハイブリッド | R8 激烈難読化・SSL pinning 厄介 | リパック本体 + frida-gadget 同梱で動的 hook |
## ライセンス
MIT License。詳細は [LICENSE](LICENSE) を参照。标签：AI辅助开发, Android, APK解析, APK重打包, Claude Code技能, Compose, Docker支持, DSL, Frida, JS文件枚举, LSPosed, Makefile模板, ProGuard映射, SEO, smali注入, SSL Pinning绕过, UI注入, Xposed, 云资产清单, 功能改造, 技能模版, 渐进式披露, 签名重签, 自定义脚本, 逆向工程