本文へ移動
cccskills
reverse-engineer-anything開発

逆コンパイルとバイナリ解析にreverse-engineer-anything

cccskills 編集部読了 約 9 分

この記事の結論

こんな人に
配布済みのアプリやバイナリ、パッケージの中身や版ごとの違いを、根拠付きで調べたい開発者や調査担当者
入れると
  • ASARや配布物を渡して頼むと、機能の処理を根拠記録付きで説明してもらえる
  • 二つの版の違いが、観測事実・推論・不明点に分かれた形で手元に届く
  • 再構築の材料を、確かな点と未確認の点に分けて整理しながら集められる
向かない人
ソースリポジトリが手元に揃っていて、通常の構造調査をしたいだけの人

reverse-engineer-anythingを入れると、エージェントがREAを使って配布済みアプリやバイナリの中身を調べます。逆コンパイルや実行時の観測を行い、機能や版ごとの違いを根拠付きで説明してくれます。配布物の中身を調べたい開発者向けのスキルです。この記事では、解析できる対象、インストールとREA本体の準備、依頼文の例、使う前に確かめておく点を順に紹介します。

目次

使うとこうなる

配布済みアプリの機能について、根拠と不明点を分けた報告を受け取れます。たとえばElectronアプリのASARファイルが手元にあるなら、依頼は次のように書きます。

このASARを解析して、設定を保存するときの処理を説明して

エージェントはまず対象の種類を見分け、ASARならJavaScriptアプリ向けの解析を選びます。返ってくる結果には、Evidenceと呼ばれる根拠記録と、コードのつながりを示すグラフが入っています。解析の限界と不明点も一緒に並ぶ形です。

説明の結論は、それぞれEvidenceに結び付けられています。観測した事実、そこからの推論、まだ分からない点が区別されるので、どこまで信用してよいかを読み手が判断できます。 解析結果が大きいときは概要から確認し、残った疑問について必要な箇所だけを掘り下げていく流れです。

reverse-engineer-anythingでできること

このスキルは、解析ツール群REAの使い方をエージェントに教えるものです。手元のソースだけでは配布物の動作を説明できないとき、エージェントは逆コンパイルや同梱物の調査、実行時の観測で答えを探します。主な用途は、機能の仕組みの説明、バージョン間の比較、再構築に向けた調査です。

最初に使う解析方法は対象によって変わります。代表的な対象と、そのとき必要になる条件を表にまとめました。

対象例必要な条件
Electron/JavaScriptASAR、展開済みのJavaScriptツリーCLIで解析する場合はMCP登録もネイティブの解析エンジンも不要
アーカイブ・パッケージZIP、APK、IPA、MSIX、AppX、DMG、PyInstallerの実行ファイル収録物の一覧とハッシュを取得
AndroidAPKのコード、クラス、メソッドAndroid向けの解析ツール
マネージドアセンブリ.NETなどのPE/CLIアセンブリ専用の解析ツール
ファームウェアファームウェアイメージLinux上で利用者が用意したBinwalkかUnblob
ネイティブコード.NET NativeAOTのPE/ELFなどGhidraによる解析で疑似コードを得る
記録済みの通信HAR、SAZ、パケットキャプチャパケットキャプチャはLinuxとTShark 4.x

表のほかにも、BunやDenoで単一の実行ファイルにしたアプリや、Appleアプリのリソースに対応しています。Go・Rustバイナリの埋め込み情報や、SQLiteデータベースも対象です。

配布物に資格情報の痕跡や公開すべきでない情報が残っていないかを確かめる監査も用意されています。WebアプリやLinuxデスクトップアプリから、エージェント用の環境(AgentEnvバンドル)を作る機能もあります。

一方で、完全なソースリポジトリの通常の構造調査にはREAを使いません。その場合、エージェントは普段のリポジトリ用ツールで調べます。

インストール方法

入れ方は、コマンドで入れる方法とエージェントに頼む方法の2通りです。コマンドは次のとおりで、実行時にClaude CodeやCodexなど入れる先を選べます。

npx skills add https://github.com/morluto/rea --skill reverse-engineer-anything

エージェントに頼む場合は、次の文面をそのまま送ってください。

次の Agent Skill をインストールしてください。
https://github.com/morluto/rea/tree/main/.agents/skills/reverse-engineer-anything

まず SKILL.md と付属ファイルの中身を確認し、不審な処理(外部への送信、認証情報の読み取りなど)がないことを確かめてから、Claude Code なら ~/.claude/skills/reverse-engineer-anything/、Codex なら ~/.agents/skills/reverse-engineer-anything/ に配置してください。

置き場所は、すべてのプロジェクトで使うか、特定のプロジェクトだけで使うかによって決まります。

エージェントすべてのプロジェクトで使う特定のプロジェクトだけで使う
Claude Code~/.claude/skills/プロジェクトの .claude/skills/
Codex~/.agents/skills/プロジェクトの .agents/skills/

REA本体の準備

スキルを入れただけでは、REAのMCPサーバーは登録されず、解析エンジンも入りません。例外は、Claude Code・Codex・CursorのMarketplaceからプラグインとして入れる場合です。このときはプラグインにスキルが同梱されていて、REAのサーバーもプラグインが登録します。

それ以外の場合はrea setupで登録し、うまく動かないときはrea doctorで状態を確かめます。設定を変える前には変更先のパスやバックアップが示され、利用者に承認を求める仕組みです。

ASARや展開済みのJavaScriptツリーだけを調べたいなら、MCPを登録しなくても次のCLIで解析できます。実行するときは、対象のプロジェクトの外にある信頼できるディレクトリから、絶対パスを指定してください。

npx -y rea-agents@latest analyze-javascript-application /absolute/path/to/app --json

使い方の例

依頼文には、調べたい対象と知りたいことを一緒に書くと意図が伝わります。ここでは三つの例を紹介します。

配布済みアプリの二つの版を比較し、根拠と不明点を整理して

二つの版の違いは、根拠記録に結び付いた説明として返ってきます。観測できた違い、推論した違い、確かめられなかった点が分けて書かれるので、変更点の一覧として使えます。

このAPKを解析して、ログイン処理に関わるクラスとメソッドを説明して

エージェントはAPKのコードを調べ、関係するクラスやメソッドと、それらを呼び出している箇所を根拠付きで示します。なお、収録ファイルの一覧を知りたいときは、アーカイブとしての解析が選ばれます。

このアプリを作り直したいので、パッケージ内のコード・設定・リソースを洗い出して根拠付きでまとめて

この依頼では、パッケージの収録物の一覧とハッシュを取り、再構築に必要な材料を整理します。一覧が大きいときは先に概要が返ってくるので、必要な部分を指定して掘り下げてください。

注意点

別途用意する外部ツールとOSの条件は、解析対象によって変わります。rea setupはNode.js、npm、Homebrew、Java、Ghidra、IDA、JADX、Binwalk、Unblobなどのインストールも更新も行いません。ファームウェアやパケットキャプチャの解析はLinuxが前提なので、対象ごとの条件を先に確かめてください。

静的な解析と実行時の観測は、別のものとして扱われます。ファイルを開いて読む解析だけでは、実際の動作までは確かめられません。実行時の観測はアプリの起動や接続、変更や後片付けを伴うことがあるため、何が起きるかを理解してから頼みましょう。

報告に並ぶ不明点や推論を、事実として扱わないことも大切です。配布物の監査結果も、アプリが安全だと保証するものではありません。解析した内容を判断に使うときは、Evidenceで観測事実とされた部分を軸にします。

スキル自体のライセンスはMITです。解析する前に、対象アプリの利用規約や権利関係を自分で確認してください。SKILL.mdと付属ファイル(referencesフォルダの各ガイド)の中身も、読んでから入れると安心でしょう。

まとめ

reverse-engineer-anythingは、配布済みアプリやバイナリの中身をREAで根拠付きで調べるためのスキルです。ASAR、APK、パッケージ、ファームウェアなど、対象に合った方法で解析を進めます。

結論は観測事実・推論・不明点に分けて返ってくるため、版の比較や再構築の材料集めに使えます。スキルの導入とあわせてREA本体と必要な外部ツールを準備し、対象の権利を確かめてから試してください。cccskills のページ

よくある質問

スキルを入れるだけで解析を始められますか
始められません。スキルは手順を教えるだけなので、REAのMCPサーバーの登録と解析エンジンの導入が別に必要です。ASARやJavaScriptツリーなら、MCPを登録しなくてもCLIで解析できます。
ソースコードが手元にある場合も使えますか
完全なソースリポジトリの通常の構造調査には、REAを使いません。ソースだけでは配布物の動作を説明できない場合や、配布物と比べたい場合に向いています。
ファームウェアも解析できますか
できます。Linux上で、利用者が用意したBinwalkかUnblobを使って領域を調べる形です。中身を取り出すときは、新しい出力先ディレクトリを絶対パスで指定してください。

このスキルを試す

reverse-engineer-anything の入れ方とインストールコマンドは、cccskills のスキルページにまとめてあります。

この記事は、公開されている SKILL.md と cccskills の紹介文をもとに AI(Claude)が下書きし、cccskills 編集部の方針に沿って推敲・公開しています。正確な仕様はスキルのページで原文を確認してください。

他の記事