AI 코딩 에이전트로 리버스 엔지니어링 자동화하는 라우팅 팩

APK, ELF, 자바스크립트 난독화 코드, CTF 문제, 모의해킹 타깃을 마주했을 때 어떤 도구(jadx, apktool, Frida, IDA, BurpSuite 등)를 어떤 순서로 써야 할지 몰라 매번 구글링부터 하던 경험, 한 번쯤 있으실 겁니다. 이 저장소는 AI 코딩 에이전트에게 '상황 인식 → 올바른 방법론 선택 → 도구 체인 자동 구성 → 실행 → 경험 축적'까지 한 번에 맡길 수 있게 만든 라우팅 팩입니다.

이게 뭔가요

zhaoxuya520/reverse-skill은 AI 코딩 에이전트가 리버스 엔지니어링·인가된 침투 테스트·보안 리서치 작업을 만날 때, 어떤 도구와 플레이북을 쓸지 자동으로 골라주는 라우팅 팩입니다. APK·ELF·자바스크립트 난독화·PCAP·CTF 문제 등 서로 다른 과제마다 전용 워크플로가 필요한데, 이 팩은 44개 라우팅 규칙(R0–R45)과 45개 핵심 스킬 모듈, 175개 회귀 벤치마크로 표준화된 경로를 제시합니다. 윈도우와 우분투 양쪽에서 동작하며, 특정 AI 클라이언트에 종속되지 않는 클라이언트 중립 구조라 Claude Code, Kiro, Cursor, Cline, Codex, OpenCode 등 주요 코드 에이전트에서 그대로 쓸 수 있습니다.

지원 클라이언트 범위

• Claude Code
• Kiro
• Cursor
• Cline
• Codex
• OpenCode
• 그 외 호환 클라이언트

사전 준비물

• Java / JDK — jadx, apktool 구동용
• Node.js 22.12+ — JS 툴체인 및 MCP 서버용
• Python 3.x — Frida 및 보조 스크립트용
• 위 클라이언트 중 하나

플랫폼별 툴 인덱스 갱신 명령

저장소는 4개월 전(2026년 5월)에 만들어졌고, 마지막 업데이트는 이번 달(2026년 9월)입니다. 스타 37,809개·포크 5,257개로 커뮤니티 관심이 높으며, 주 언어는 PowerShell이고 라이선스는 MIT입니다. 설치 후 skills/tool-index.md를 열면 감지된 도구 목록을 바로 확인할 수 있습니다.

왜 쓰나요

AI 코딩 에이전트가 APK·ELF·자바스크립트 난독화·PCAP·CTF 같은 역공학·침투 테스트 과제를 만나면, 어떤 도구를 어떤 순서로 쓸지 매번 고민하게 됩니다. jadx·apktool·Frida·IDA·BurpSuite 중 뭘 먼저 켤지, 스크립트는 어느 머신에 있는지, 지난번 같은 실수를 또 반복하지 않으려면 어떻게 해야 할지 — 이런 도구 선택 고민·환경 분산·반복 실수가 기존 워크플로의 가장 큰 고통점이었습니다.

reverse-skill은 이 세 가지를 한 번에 풀어줍니다. 44개 라우팅 규칙(R0–R45) 이 과제 유형을 자동 판별해 올바른 방법론으로 연결하고, 플랫폼별 툴 인덱스 갱신 스크립트 로 로컬 환경에 깔린 도구만 골라 즉시 실행 환경을 구성합니다. 실행 결과는 자기 진화 경험 베이스 에 쌓여 다음 작업부터는 검증된 워크플로를 재사용합니다.

1. 자동 라우팅즉시

   APK·ELF·JS·PCAP·CTF 등 입력 유형을 감지해 44개 규칙 중 최적 플레이북 선택

2. 도구 부트스트랩초 단위

   Windows·Ubuntu·Kali·macOS 전용 스크립트로 로컬 설치 도구만 인덱싱·활성화

3. 경험 축적작업 종료 시

   성공·실패 패턴을 구조화해 다음 동일 유형 작업에 자동 적용

그 결과, 에이전트는 "어떤 도구를 쓸까?" 를 고민하는 대신 "이 과제의 핵심이 뭘까?" 에 집중할 수 있게 됩니다. 175개 회귀 벤치마크와 45개 핵심 스킬 모듈이 검증한 이 라우팅 팩은, 클라이언트 중립 구조로 Claude Code·Cursor·Cline·Kiro·Codex 등 어떤 AI 코딩 클라이언트에서도 동일하게 작동합니다.

설치·준비·시작하기

AI 코딩 에이전트와 리버스 엔지니어링 스킬을 연결하려면 먼저 실행 환경이 갖춰져 있어야 해요. JDK, Node.js 22.12 이상, Python 3.x가 기본 전제 조건이고, 여기에 Claude Code, Codex, Cursor, OpenCode 같은 호환 클라이언트 중 하나를 준비하면 돼요.

필수 사전 설치

• JDK — jadx·apktool 구동용
• Node.js 22.12+ — JS 툴체인·MCP 서버용
• Python 3.x — Frida·보조 스크립트용
• 코드 AI 클라이언트 — Claude Code / Codex / Cursor / OpenCode 등

설치 및 툴 인덱스 갱신

저장소를 복제한 뒤 플랫폼에 맞는 스크립트를 한 번 실행하면 로컬에 설치된 역공학 도구를 자동으로 스캔해 skills/tool-index.md에 기록해요. 이후 AI 에이전트가 이 인덱스를 읽고 적절한 도구를 골라 쓰게 됩니다.

powershell -File skills/scripts/refresh-tool-index.ps1

bash skills/scripts/refresh-tool-index.sh

bash kali/scripts/refresh-tool-index.sh

플랫폼별 추가 가이드

각 문서에는 패키지 매니저로 설치해야 할 시스템 의존성, 권한 설정, 쉘 프로파일 등록 등 플랫폼 특화 팁이 담겨 있어요. 자신의 OS에 맞는 문서를 한 번 읽고 넘어가면 나중에 도구 누락으로 인한 라우팅 실패를 줄일 수 있어요.

핵심 기능 한눈에 보기

이 스킬 팩은 44개 라우팅 규칙(R0~R45)과 175개 회귀 벤치마크, 45개 핵심 스킬 모듈을 갖춰 AI 에이전트가 APK·ELF·자바스크립트·PCAP·CTF 등 다양한 역공학 과제를 만났을 때 어떤 도구를 어떤 순서로 쓸지 자동으로 결정해 줍니다. Windows·Ubuntu·Kali·macOS 등 주요 플랫폼에서 동일하게 동작하며, Claude Code·Cursor·Cline·Codex 등 클라이언트 종류에 구애받지 않는 클라이언트 중립 구조로 설계됐습니다.

각 플랫폼별 도구 인덱스 갱신 명령은 설치 섹션에서 이미 다뤘으므로 여기서는 생략합니다. 표에 나온 숫자는 README의 Current status 테이블과 동일하며, 라우팅 핵심은 단일 구조화 설정 파일로 검증·관리됩니다.

주의할 점·한계

reverse-skill은 MIT 라이선스로 공개되어 있어 자유롭게 검토하고 활용할 수 있어요. 하지만 이 도구의 본질은 인가된 침투 테스트(Authorized Penetration Testing)와 보안 리서치를 위한 라우팅 팩이라는 점을 반드시 기억해야 해요. 사전에 명확하게 허가를 받은 자산이나 자체 테스트 대상에 대해서만 운용해야 법적·윤리적 문제를 예방할 수 있어요.

AI 에이전트 전용 안내 파일 확인과 플랫폼별 유의사항

AI 에이전트와 연동할 때는 일반 사용자용 설명서와 분리된 README_AI.md를 주의 깊게 살펴봐야 해요. 저장소 안내에 명시되어 있듯, AI 코딩 에이전트(Claude Code, Codex, Cursor, OpenCode 등)는 README_AI.md의 지침을 엄격히 따르도록 설계되어 있어요.

또한 운영체제 환경에 따라 도구 색인을 갱신하는 스크립트와 참고해야 할 문서 경로가 달라지므로 실전 운용 전 각 플랫폼별 차이를 체크해야 해요.

• 스킬 팩 갱신 후에는 skills/tool-index.md 파일을 확인해 환경 내 도구가 정상 감지되었는지 점검해요.
• jadx·apktool 실행을 위한 Java/JDK, 자바스크립트 툴체인 및 MCP 서버 구동을 위한 Node.js 22.12+, Frida 및 헬퍼 스크립트를 위한 Python 3.x 환경이 준비되어 있지 않으면 도구 자동 호출이 실패할 수 있어요.

정리·다음 단계

이제 실무에 바로 적용하려면 공식 학습 자료와 커뮤니티 경로를 따라가면 됩니다. 저장소 README 상단의 About → Getting Started → Tutorial → Online tutorial 순서로 읽어가며, README_AI.md를 먼저 열어 AI 에이전트 전용 지침을 확인하세요. 라우팅 규칙(R0~R45)과 175개 회귀 벤치마크, 45개 핵심 스킬 모듈이 어떻게 엮이는지 전체 흐름을 익힌 뒤, 자신의 플랫폼(Windows·Ubuntu·Kali·macOS)별 문서에서 도구 인덱스 갱신 명령어를 실행하면 환경이 바로 맞춰집니다.

1. 공식 튜토리얼 따라가기

   README의 Tutorial 섹션과 프로젝트 웹사이트의 Online tutorial을 순서대로 실습합니다. APK·ELF·JS·PCAP·CTF 각 시나리오별 플레이북이 예제와 함께 나와 있어 처음 접해도 막힘없이 진행됩니다.

2. 플랫폼별 가이드 적용

   Windows는 kali/README-kali.md, Ubuntu/Debian은 docs/platforms/linux.md, macOS는 docs/platforms/macos.md를 열어 필수 패키지(JDK, Node.js 22.12+, Python 3.x)와 권한 설정을 마칩니다.

3. 도구 인덱스 갱신·검증

   자신의 OS에 맞는 명령어(powershell -File skills/scripts/refresh-tool-index.ps1 또는 bash skills/scripts/refresh-tool-index.sh 등)를 실행한 뒤 skills/tool-index.md에서 탐지된 도구 목록을 확인합니다.

4. 커뮤니티 기여 시작

   Issues·Discussions·PR 템플릿을 읽고, 신규 라우팅 규칙 제안이나 벤치마크 케이스 추가, 문서 번역 등 기여할 수 있는 항목을 골라 첫 PR을 보냅니다.

• 원문 보기