역컴파일과 바이너리 분석에 reverse-engineer-anything
機械翻訳 / Machine-translated

機械翻訳 / Machine-translated
원문 기사: 逆コンパイルとバイナリ解析にreverse-engineer-anything(cccskills)
스킬 페이지: reverse-engineer-anything
이 글의 결론
reverse-engineer-anything을 도입하면, 에이전트가 REA를 사용해 배포된 앱이나 바이너리의 내용을 조사합니다.
역컴파일이나 실행 시 관측을 수행하고, 기능이나 버전별 차이를 근거와 함께 설명해 줍니다.
배포물의 내용을 조사하고 싶은 개발자를 위한 스킬입니다.
이 글에서는 분석 가능한 대상, 설치와 REA 본체 준비, 요청문 예시, 사용 전에 확인해야 할 사항을 순서대로 소개합니다.
배포된 앱의 기능에 대해, 근거와 불명확한 부분을 구분한 보고서를 받을 수 있습니다.
예를 들어 Electron 앱의 ASAR 파일이 있다면, 요청은 다음과 같이 작성합니다.
이 ASAR을 분석해서, 설정을 저장할 때의 처리 과정을 설명해줘
에이전트는 먼저 대상의 종류를 파악하고, ASAR이면 JavaScript 앱용 분석 방법을 선택합니다.
반환되는 결과에는 Evidence라고 불리는 근거 기록과 코드의 연결 관계를 나타내는 그래프가 포함됩니다.
분석의 한계와 불명확한 부분도 함께 제시됩니다.
설명의 결론은 각각 Evidence에 연결되어 있습니다.
관측된 사실, 거기서 도출된 추론, 아직 알 수 없는 부분이 구분되기 때문에, 어디까지 신뢰할 수 있는지 독자가 직접 판단할 수 있습니다.
분석 결과가 클 때는 개요부터 확인하고, 남은 의문에 대해 필요한 부분만 깊이 파고드는 방식으로 진행합니다.
이 스킬은 분석 도구 모음 REA의 사용법을 에이전트에게 가르치는 것입니다.
직접 보유한 소스만으로는 배포물의 동작을 설명할 수 없을 때, 에이전트는 역컴파일이나 동봉 파일 조사, 실행 시 관측으로 답을 찾습니다.
주요 용도는 기능 동작 방식 설명, 버전 간 비교, 재구축을 위한 조사입니다.
처음에 사용하는 분석 방법은 대상에 따라 달라집니다.
대표적인 대상과 필요한 조건을 표로 정리했습니다.
| 대상 | 예시 | 필요한 조건 |
|---|---|---|
| Electron/JavaScript | ASAR, 압축 해제된 JavaScript 트리 | CLI로 분석하는 경우 MCP 등록이나 네이티브 분석 엔진 불필요 |
| 아카이브·패키지 | ZIP, APK, IPA, MSIX, AppX, DMG, PyInstaller 실행 파일 | 수록 파일 목록과 해시 취득 |
| Android | APK의 코드, 클래스, 메서드 | Android용 분석 도구 |
| 매니지드 어셈블리 | .NET 등의 PE/CLI 어셈블리 | 전용 분석 도구 |
| 펌웨어 | 펌웨어 이미지 | Linux 상에서 사용자가 준비한 Binwalk 또는 Unblob |
| 네이티브 코드 | .NET NativeAOT의 PE/ELF 등 | Ghidra를 통한 분석으로 의사 코드 획득 |
| 기록된 통신 | HAR, SAZ, 패킷 캡처 | 패킷 캡처는 Linux와 TShark 4.x |
표 외에도, Bun이나 Deno로 단일 실행 파일로 만든 앱이나 Apple 앱의 리소스에도 대응합니다.
Go·Rust 바이너리의 내장 정보나 SQLite 데이터베이스도 대상입니다.
배포물에 자격 증명 흔적이나 공개해서는 안 되는 정보가 남아 있지 않은지 확인하는 감사 기능도 있습니다.
웹 앱이나 Linux 데스크톱 앱에서 에이전트용 환경(AgentEnv 번들)을 만드는 기능도 있습니다.
한편, 완전한 소스 리포지터리의 일반적인 구조 조사에는 REA를 사용하지 않습니다.
그 경우 에이전트는 평소의 리포지터리용 도구로 조사합니다.
설치 방법은 명령어로 설치하는 방법과 에이전트에게 요청하는 방법, 두 가지입니다.
명령어는 다음과 같으며, 실행 시 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의 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 폴더의 각 가이드) 내용도 읽고 나서 설치하면 안심할 수 있습니다.
시작할 수 없습니다.
스킬은 절차를 가르쳐 줄 뿐이므로, REA의 MCP 서버 등록과 분석 엔진 도입이 별도로 필요합니다.
ASAR이나 JavaScript 트리라면, MCP를 등록하지 않아도 CLI로 분석할 수 있습니다.
완전한 소스 리포지터리의 일반적인 구조 조사에는 REA를 사용하지 않습니다.
소스만으로는 배포물의 동작을 설명할 수 없는 경우나, 배포물과 비교하고 싶은 경우에 적합합니다.
가능합니다.
Linux 상에서 사용자가 준비한 Binwalk 또는 Unblob을 사용해 영역을 조사하는 방식입니다.
내용을 추출할 때는 새 출력 디렉터리를 절대 경로로 지정하세요.
reverse-engineer-anything은 배포된 앱이나 바이너리의 내용을 REA로 근거와 함께 조사하기 위한 스킬입니다.
ASAR, APK, 패키지, 펌웨어 등 대상에 맞는 방법으로 분석을 진행합니다.
결론은 관측 사실·추론·불명확한 부분으로 나뉘어 반환되므로, 버전 비교나 재구축을 위한 자료 수집에 활용할 수 있습니다.
스킬 도입과 함께 REA 본체와 필요한 외부 도구를 준비하고, 대상의 권리 관계를 확인한 후 시도해 보세요.
cccskills 페이지
이 글은 cccskills의 읽을거리 「逆コンパイルとバイナリ解析にreverse-engineer-anything」의 전재입니다.
스킬의 상세 내용과 설치 방법은 cccskills의 reverse-engineer-anything 페이지에 있습니다.