reverse-skill 딥다이브
— AI 코딩 에이전트를 위한 "보안 스킬 라우터" 설계 해부

Claude Code·Cursor·Cline 같은 코딩 AI가 보안·역공학 작업을 만났을 때, "무슨 도구를 어떤 순서로 써야 하는지"를 스스로 판단하게 만드는 스킬 라우팅 팩이다. 핵심은 세 가지 — ① 작업을 분류해 알맞은 스킬로 보내는 라우터, ② 필요한 도구를 그때그때 깔아주는 자가부팅(bootstrap) 매니페스트, ③ 작업이 끝나면 경험을 글로 남겨 스스로 진화하는 경험 라이브러리(field-journal). 코드가 아니라 마크다운 규약(.md 매니페스트)으로 짜인, "에이전트 운영체제"에 가까운 구조다. (저장소: zhaoxuya520/reverse-skill · 22개 스킬 + 41개 CTF 서브스킬 · 다국어 README(중/영) · MIT 라이선스 · TrendShift #13)

1프로젝트 한줄 요약

"코딩 AI에게 보안 작업용 두뇌(라우터) + 손발(도구) + 기억(경험)을 한 번에 달아준다."

가장 먼저 짚을 점 — 이건 실행 가능한 프로그램이 아니라 "지시문 묶음"이다. 거의 모든 핵심 파일이 마크다운(.md)으로, AI가 읽고 그대로 행동하도록 설계됐다. SKILL.md(총괄 입구), routing.md(분류 표), RULES.md(행동 규칙) 같은 파일이 코드가 아니라 "프롬프트/규약"으로 에이전트의 행동을 프로그래밍한다. 여기에 PowerShell·Bash 스크립트(도구 설치·검사용)와 JSON 매니페스트가 곁들여진다.

만든 사람은 zhaoxuya520이고, 저장소에는 중국어(README_zh.md)·영어(README.md) 안내가 함께 있다. 흥미로운 건 README 자체가 사람용이 아니라 "AI가 읽고 자기 자신을 설정하는 부팅 문서"로 쓰였다는 점이다 — 문서 첫머리에 "사람은 OVERVIEW.md부터 보고, AI 에이전트는 곧장 0번 섹션의 부팅 절차를 실행하라"고 명시한다.

2왜 주목받는가

"단일 도구 설치기가 아니라, 에이전트의 작업 흐름 자체를 설계한 '운영체제'다."

2025~2026년은 "코딩 에이전트에 스킬을 입히는" 시대다. Claude Code의 플러그인·스킬, Cursor Rules, Cline 커스텀 인스트럭션 등으로 AI의 행동을 도메인에 맞게 조형하는 게 유행이다. 그런데 대부분은 "하나의 도구를 잘 쓰게 하는" 수준에 그친다. reverse-skill이 눈에 띄는 이유는 한 도메인(보안·역공학) 전체를 분류 → 도구 준비 → 실행 → 회고·진화라는 닫힌 루프로 묶었기 때문이다.

특히 "멀티 클라이언트 이식성"이 차별점이다. RULES.md 단 한 파일이 "내가 어떤 AI 클라이언트인지 감지해서, 그 클라이언트의 전역 설정 위치에 라우팅 규칙을 써넣어라"는 지시를 담는다. 덕분에 한 파일만 유지하면 Claude Code·Cursor·Cline·Windsurf·Kiro·Codex가 모두 같은 라우팅을 쓴다. Kiro는 한술 더 떠 .kiro/steering/reverse-routing.md가 자동 로드되어, 특정 키워드(역공학·APK·CTF·渗透 등 수백 개)가 보이면 라우팅을 강제 발동한다.

비슷한 것들과 무엇이 다른가

물론 한계도 분명하다. 이 팩이 약속하는 건 "코드를 실행하는 엔진"이 아니라 "에이전트가 따라야 할 규약과 도구 지도"다. 실제 분석을 해내는 건 결국 외부 도구(jadx·IDA·radare2 등)와 MCP 서버이고, reverse-skill은 그 위를 흐르는 방법론 + 라우팅 + 회고 레이어다. 또한 보안 도구 특성상 합법적·권한 받은 환경(학습·CTF·인가된 테스트)에서만 써야 하며, 레포 자체도 라이선스·면책 조항에서 이를 강조한다. (이 글은 공격 기법이 아니라 에이전트 아키텍처를 설명하는 데 집중한다.)

3기술 스택 전체 지도

"코드"보다 "규약+스크립트+매니페스트". 세 층 — 지시 레이어 / 자동화 레이어 / 연동 레이어.

reverse-skill은 일반적인 "백엔드/프론트엔드/인프라" 프로젝트가 아니다. 산출물의 대부분이 AI가 읽는 문서(.md)이고, 나머지가 그 문서를 거드는 스크립트(.ps1/.sh)·매니페스트(.json)·MCP 브리지다. 그래서 ① 지시 레이어(Instruction) ② 자동화 레이어(Automation) ③ 클라이언트 연동 레이어(Integration) 셋으로 보면 머리에 잘 들어온다.

① 지시 레이어 — AI에게 "어떻게 행동하라"를 적은 .md

이 레포의 진짜 "코드"는 마크다운이다. RFC 2119 키워드(MUST/SHOULD/MAY)까지 동원해 AI의 의무 행동을 규정한다. AI는 이 문서를 프롬프트 컨텍스트로 읽고 그대로 실행한다.

② 자동화 레이어 — 도구 설치·검사 스크립트와 매니페스트

지시만으론 도구가 깔리지 않는다. 그래서 실제 OS에서 도는 스크립트가 붙는다. 핵심은 bootstrap-manifest.json — "어떤 도구를 어떤 방식으로 설치할지"를 데이터로 적은 표다. 스크립트는 이 표를 읽어 설치를 수행한다(설정 vs 실행의 분리).

③ 클라이언트 연동 레이어 — MCP·hooks·steering

마지막으로, 이 규약을 실제 AI 클라이언트에 꽂는 접착제다. 대상 분석을 위한 외부 능력은 MCP(Model Context Protocol) 서버로 연결한다(IDA·BurpSuite·브라우저 분석 등).

4아키텍처 심화 분석 — 라우팅·자가부팅·자동진화

심장은 세 개의 톱니바퀴 — '라우터(분류)', '부트스트랩(도구 보급)', 'field-journal(회고·진화)'.

reverse-skill의 동작은 하나의 행동 사슬로 요약된다. 작업이 들어오면 AI는 정해진 순서로 문서를 읽어 길을 정하고, 도구를 확인·보충한 뒤 실행하고, 끝나면 경험을 남긴다. 실제 ARCHITECTURE.md의 흐름을 단순화하면 다음과 같다.

핵심 설계 1 — 3축 라우팅 매트릭스 (분류의 두뇌)

routing.md는 단순한 목록이 아니라 "대상 유형 / 사용자 의도" 두 개의 큰 표다. AI는 들어온 작업을 이 표와 대조해 정확히 한 곳(또는 조합)으로 보낸다. 핵심 규칙은 "먼저 라우팅, 그 다음 실행"과 "안 맞으면 억지로 끼우지 말고 새 스킬을 제안"이다.

여기서 영리한 건 "경로 교차(Path Crossing)" 설계다. 한 작업이 여러 스킬에 걸치면(예: APK 분석 중 .so가 나오면 IDA로, PoC를 쓰면 pwn-chain으로) 스킬들이 사슬처럼 이어진다. 모놀리식이 아니라 조립식 스킬 그래프인 셈이다.

핵심 설계 2 — 데이터 기반 자가부팅 (도구 보급)

도구 설치 로직을 코드에 하드코딩하지 않고 bootstrap-manifest.json에 데이터로 뽑아낸 게 핵심이다. 항목마다 설치 방식(bootstrapKind)·저장소·검증 명령이 적혀 있어, 스크립트는 이 레시피만 보고 동작한다. 새 도구는 코드를 안 고치고 JSON에 한 줄이면 끝(설정과 실행의 분리, OCP).

// bootstrap-manifest.json 한 항목의 예 (요지)
{
  "name": "jadx",
  "bootstrapKind": "github-release-zip",   // 설치 방식
  "repo": "skylot/jadx",                    // 어디서 받나
  "assetRegex": "^jadx-[0-9].*\\.zip$",     // 어떤 파일
  "installDir": "%USERPROFILE%\\Tools\\jadx",
  "canAutoInstall": true,
  "verifyCommand": "jadx"                    // 설치 후 검증
}

현재 매니페스트에는 18개 능력이 정의돼 있고, 설치 방식(bootstrapKind)은 9종으로 다양하다 — 같은 "설치"라도 도구마다 받는 법이 다르기 때문이다.

핵심 설계 3 — field-journal (스스로 진화하는 기억)

가장 독특한 부분. 작업이 끝나면 AI는 field-journal/에 "무슨 작업을, 어떤 사슬로, 어떤 함정을 겪고, 어떻게 풀었는지 + 재사용 가능한 코드"를 정해진 템플릿(_template.md)으로 적는다. 다음에 같은 유형이 오면 _index.md를 먼저 뒤져 검증된 절차를 재사용하고 같은 함정을 피한다. 시간이 갈수록 똑똑해지는 경험 라이브러리다.

마지막으로, 이 모든 걸 받치는 메타 설계가 "복종성 공학(agent-obedience-engineering)"이다. llm-security/에 들어있는 이 문서는 에이전트가 설명만 하다 멈추거나, 단계를 건너뛰거나, 빈 확인만 반복하는 것을 막는 프롬프트 엔지니어링 기법을 담는다. 즉 reverse-skill은 "무엇을 할지(라우팅)"뿐 아니라 "실제로 끝까지 실행하게 만드는 법"까지 설계에 넣었다.

5디렉토리 구조 해부

레포는 '지시 문서 + 22개 스킬 + 41개 CTF 서브스킬 + 자동화 스크립트'의 평면 모노레포다.

최상위는 크게 ① 부팅·규칙 문서(루트의 .md) ② skills/(22개 스킬 + 라우팅 + 경험 라이브러리) ③ CTF-Sandbox-Orchestrator/(41개 경쟁용 서브스킬) ④ burp-mcp-full/(MCP 브리지) ⑤ 플랫폼 문서·워크플로로 나뉜다. 핵심은 skills/ 안의 "입구 3종(SKILL·routing·tool-index) + 도메인 스킬들 + scripts + field-journal" 구성이다.

6학습 포인트 (기술별)

코드 한 줄 없이도, '에이전트를 설계하는 법' 거의 전부가 이 레포에 들어 있다.

① 에이전트 스킬 설계 — SKILL.md 작성법

요즘 코딩 AI 생태계의 핵심 산출물이 "스킬"이다. 이 레포는 22개 스킬을 어떻게 한 장의 SKILL.md로 정의하는지의 거대한 표본이다. "언제 쓰는지(트리거)·도구 사슬·첫 실행 동작·실행 계약"을 어떻게 적는지 패턴이 보인다.

② 라우팅 = 의도 분류 시스템

routing.md는 사실상 "자연어 의도 → 행동"의 매핑 테이블이다. LLM이 분류기로 동작하도록 입력을 어떻게 구조화하는지(대상 유형 / 사용자 의도 / 도구 체인 3축), "미스매치 시 새 스킬 제안" 같은 안전 기본값을 어떻게 두는지 배운다.

③ 데이터 기반 자동화 — 매니페스트 + 실행기 분리

bootstrap-manifest.json + bootstrap-reverse.ps1은 "설정(데이터) ↔ 실행(코드)" 분리의 모범이다. 설치 방식을 코드에 박지 않고 JSON에 빼두니, 새 도구 추가가 "코드 수정"이 아니라 "데이터 한 줄"이 된다. OCP(개방-폐쇄 원칙)의 실전 사례.

④ 자기 진화 시스템 — 메모리 + 안전 머지

field-journal/은 "AI가 자기 경험을 글로 남겨 다음에 재사용"하는 메모리 루프다. 더 중요한 건 진화의 안전장치 — GitHub Actions가 경험 파일만 자동 머지하고 핵심 로직은 사람 리뷰를 강제한다. "자율성과 통제"의 균형을 코드로 어떻게 구현하는지 배운다.

⑤ 멀티 클라이언트 이식성 — 한 규칙, 여러 에이전트

RULES.md 한 파일로 Claude Code·Cursor·Cline·Windsurf·Kiro·Codex를 모두 덮는 설계는, "클라이언트 감지 → 그 클라이언트의 설정 위치에 주입"이라는 영리한 추상화다. 도구별로 파일을 복제하지 않고 단일 진실원(single source)을 유지하는 법을 보여 준다.

⑥ MCP로 외부 능력 붙이기

burp-mcp-full/(Java 도구를 Node 브리지로 MCP화)와 IDA·jshookmcp 연동 예시는 "기존 도구를 AI 에이전트의 손발로 만드는 법"의 실전 카탈로그다. MCP의 세 가지 기동 방식(URL 등록형 HTTP, npx 명령형, 로컬 서버형)을 한 레포에서 비교할 수 있다.

7필요 환경 / 전제

레포 자체는 가볍다 — 진짜 전제는 'AI 클라이언트 + 합법적 사용 환경'이다.

이 팩 자체는 문서·스크립트·JSON이라 다운로드만으로 끝난다(빌드 불필요). 부담은 컴퓨터 성능이 아니라 ① 이걸 읽고 실행할 AI 클라이언트와 ② 작업에 실제로 필요한 외부 도구(필요할 때 자가부팅), 그리고 무엇보다 합법적·인가된 사용 환경이다.

8직접 해볼 수 있는 실습 과제

"구조 읽기 → 라우팅 추적 → 매니페스트 해독 → 나만의 스킬 팩"으로 난이도 상승. (전부 합법적 학습 범위)

과제 1. 행동 사슬 따라 읽기 난이도 ★☆☆☆☆

레포를 클론해 OVERVIEW.md → ARCHITECTURE.md → skills/SKILL.md 순으로 읽고, "작업 1건이 거치는 7단계"(규칙로드→라우팅→경험조회→도구확인→실행→산출→진화)를 자기 말로 한 문단 요약해 보라. 코드 없이 "에이전트 워크플로 설계"를 읽는 첫걸음.

과제 2. 가상 작업 라우팅 추적 난이도 ★★☆☆☆

routing.md를 펼쳐 두고, 가상의 요청 3개("이 .so 파일 분석", "웹 로그인 암호화 파라미터 찾기", "이 LLM 앱 프롬프트 인젝션 점검")가 각각 어느 스킬로 가는지를 표에서 직접 짚어 보라. "경로 교차"가 일어나는 케이스도 하나 찾아본다.

과제 3. bootstrap 매니페스트 해부 난이도 ★★★☆☆

bootstrap-manifest.json 전체를 열어 18개 능력을 9가지 bootstrapKind로 분류한 표를 만들어 보라. 그리고 bootstrap-reverse.sh가 그 데이터를 어떻게 읽어 분기하는지(설치 방식별 처리)를 흐름도로 그린다. "데이터 기반 자동화"의 핵심을 손으로 익히는 과제.

과제 4. field-journal 진화 루프 재현 난이도 ★★★☆☆

field-journal/_template.md와 seed-*.md 사례 하나를 비교해, "회고 일지가 어떤 항목으로 구성되는지"를 정리하라. 그런 다음 아무 학습 경험(예: 어떤 라이브러리 설치 삽질)을 그 템플릿에 맞춰 한 건 작성하고, _index.md에 색인 줄을 추가해 본다 — 자기 진화 시스템을 직접 돌려보는 셈.

과제 5. 나만의 미니 스킬 라우팅 팩 만들기 난이도 ★★★★★

보안과 무관한 도메인(예: "데이터 정제" 또는 "글쓰기")을 골라, reverse-skill의 구조를 본떠 ① SKILL.md(총괄) ② routing.md(분류 2-표) ③ 스킬 폴더 2~3개 ④ 작은 bootstrap-manifest.json을 갖춘 미니 스킬 팩을 직접 설계하라. 더 나아가 Claude Code의 스킬/플러그인 포맷에 맞춰 실제로 붙여, "route first, execute second"가 동작하는지 확인한다.

9관련 기술 심화 학습 로드맵

'에이전트 스킬 → 라우팅/오케스트레이션 → MCP 도구 연동 → 자기 진화 시스템'의 4주 코스.

10핵심 키워드 사전

reverse-skill 문서·구조에서 반복되는 용어를 한 곳에.

11참고 링크

공식 저장소·문서·관련 표준.