CTF Super Hub — 그것이 무엇이고 어떻게 작동하는지

한 문장으로

CTF Super Hub는 CTF(캡처 더 플래그) 및 리버스 엔지니어링 챌린지를 위한 초보자 친화적인 "현관문"입니다 — AI 어시스턴트에게 "무엇을 해야 할지 전혀 모르겠다"에서 시작하여 챌린지를 단계별로 안내하는 방법을 알려줍니다.

이것은 도구 모음도, 문제 은행도, 코딩이 필요한 것도 아닙니다. 이것은 스킬 세트입니다 — 스킬을 AI에게 "사용자가 챌린지를 주면 이 절차를 따르세요"라고 지시하는 서면 플레이북으로 생각하세요.

---

해결하는 문제

README는 핵심 문제를 명확히 말합니다: "도구가 부족한 것이 아니라 챌린지를 받았을 때 첫 단계가 무엇인지 모르는 경우가 많습니다."

해결하는 일반적인 초보자痛点:

• 챌린지가 Web, Crypto, Reverse, Pwn 또는 Misc인지 구분할 수 없음
• 많은 스킬 이름을 보지만 어떤 것을 먼저 호출해야 할지 모름
• 첫 번째로 입력할 명령을 모름
• AI가 전문 용어를 쏟아내는 대신 단계별로 안내해 주길 원함
• 다른 출력 스타일(교육 vs. 경쟁 vs. 힌트 전용)을 원함

---

두 가지 진입점(이 두 가지만 기억하면 됩니다)

1. ctf-super-hub(기본, 대부분의 사람에게 권장)

이것은 전체 저장소의 단일 오케스트레이션 센터입니다. 그것은:

• 문제가 어떤 챌린지 카테고리와 비슷한지 자동으로 추측합니다
• 정보가 충분하지 않으면 먼저 최소 브레인스토밍을 실행합니다
• 세 가지 출력 스타일을 전환합니다: teaching, competition, hints-only
• 머신에 실제로 설치된 스킬을 스캔하고 해당 스킬에만 라우팅합니다(설치하지 않은 스킬을 추천하지 않음)
• 웹/인터페이스/취약점 검증 작업을 strix-* 스킬에 넘길 수 있습니다
• 팀 구성을 지원: 1개의 메인 역할 + 최대 2명의 어시스턴트

2. ctf-beginner-hub(순수 초보자용)

메인 진입점의 더 부드러운 변형. 동일한 라우팅 규칙이지만 용어를 평이한 언어로 설명하고 먼저 짧은 튜토리얼을 제공합니다. 완전히 새롭거나 전문 용어에 압도당하기 쉬운 경우 이 진입점을 사용하세요.

---

작동 방식: 두 가지 모드

모드 1 — 자동 라우팅

이미 자료가 있을 때 사용합니다: 챌린지 텍스트, 첨부 파일, URL, IP:PORT, 소스 코드 또는 바이너리 파일. 세 가지를 수행합니다:

1. 챌린지가 가장 유사한 카테고리를 판단합니다
2. 더 구체적인 ctf-* 또는 strix-* 스킬로 전환할지 결정합니다
3. 다음 1~3개의 가장 가치 있는 단계만 알려줍니다

모드 2 — 먼저 브레인스토밍, 그 다음 라우팅

챌린지를 전혀 이해하지 못하거나, 자료가 충분한지 모르거나, 다음에 어떤 정보를 수집해야 할지 모를 때 사용합니다. 세 가지를 수행합니다:

1. 목표를 명확히 하는 데 도움을 줍니다
2. 단서와 누락된 정보를 정리합니다
3. 그런 다음 어떤 스킬을 호출할지 결정합니다

---

strix-*란 무엇인가

이것은 확장 레이어이며 두 번째 메인 시스템이 아닙니다. 메인 흐름은 ctf-super-hub / ctf-beginner-hub가 처리합니다; strix-*는 웹, 인터페이스 및 취약점 검증 작업에만 개입합니다. strix-* 이름을 기억할 필요가 없습니다 — 메인 진입점이 처리합니다.

---

궤도를 벗어나지 않게 하는 두 가지 규칙

1. 핸드오프 계약: 스킬은 현재 작업이 완료될 때까지 다음 단계로 이동하지 않습니다. 명시적으로 "다음은?"이라고 물을 때만 오케스트레이션 센터로 돌아갑니다 — 스스로 스킬을 연쇄하지 않습니다.
2. 설치 인식 라우팅: 오케스트레이션 센터는 무엇이든 추천하기 전에 실제로 설치된 것을 스캔합니다. 설치되지 않은 스킬은 절대 제안되지 않습니다.

---

사용 방법(빠른 시작)

1. 스킬 폴더를 AI 도구의 스킬 디렉토리에 설치합니다(Codex, Claude Code, Gemini CLI 또는 OpenCode — 사용하는 것을 선택).
2. 새 대화를 시작합니다(오래되고 긴 대화는 덜 안정적입니다).
3. 시작 프롬프트를 붙여넣습니다, 예:

   "ctf-super-hub를 사용하여 이 챌린지를 도와주세요. 유형을 결정할 수 있으면 가장 적합한 ctf-* 스킬로 자동 라우팅하세요. 정보가 불충분하면 먼저 저와 최소 브레인스토밍을 하세요. 기본값은 교육 스타일입니다."

4. 가지고 있는 자료를 붙여넣습니다 — 챌린지 텍스트, URL, IP:PORT, 첨부 파일, 소스 코드, 이미 시도한 명령, 막힌 지점. 완벽하게 정리할 필요는 없습니다.
5. 다음 단계 지침을 따릅니다. 더 많은 정보가 필요하다고 말하면 정상입니다 — 작동 중인 것이지 고장난 것이 아닙니다.

특정 스타일을 요청할 수도 있습니다: teaching(더 많은 설명), competition(빠른 진행), 또는 hints-only(힌트만, 전체 솔루션 없음).

---

설치(간단히)

• Codex(권장, 가장 쉬움): 저장소 루트에서 내장 스크립트 ./install-to-codex.sh를 실행합니다. 대상 디렉토리를 만들고, 동일한 이름의 기존 스킬을 백업하고, 모든 것을 복사합니다.
• Claude Code / Gemini CLI / OpenCode: 폴더 brainstorming, solve-challenge, ctf-*, strix-*를 도구의 스킬 디렉토리에 수동으로 복사합니다(예: ~/.claude/skills, ~/.gemini/skills, ~/.opencode/skills).
• 설치 후 도구를 다시 시작하거나 새 세션을 엽니다.

설치를 확인하려면: 스킬 디렉토리에 ctf-super-hub/SKILL.md가 존재하는지 확인하거나, 새 세션을 시작하고 더미 챌린지로 테스트합니다.

---

버전 확인 및 업데이트

v1.1.0부터 메인 진입점은 자동으로 업데이트를 확인합니다:

• 각 진입 시 UPDATE.json을 읽고 24시간당 최대 1회 네트워크 요청을 수행합니다(실패는 조용히 무시되며 사용에 영향을 주지 않음)
• 새 버전이 있으면 🔔 알림이 버전 번호와 메모와 함께 나타납니다
• 알림 직후 1이라고 답하면 업데이트 스크립트가 실행됩니다(풀 + 모든 스킬 재동기화)
• 스킬에 커밋되지 않은 로컬 변경 사항이 있으면 업데이트가 실행을 거부하고 파일을 나열합니다 — 작업을 덮어쓰지 않습니다
• 수동 업데이트는 scripts/update_skills.sh로도 가능합니다(미리 보기용 --dry-run 플래그 포함)

---

품질 보증

저장소에는 3단계 검증 시스템이 있습니다:

• L1 — 구조 검증: python3 scripts/validate_skills.py는 모든 35개 스킬의 프론트매터, 설명 트리거 이름, 상대 링크, Python 스크립트 구문 및 주요 저장소 파일을 확인합니다. CI 통합을 위한 --json을 지원합니다.
• L2 — 동작 스모크 테스트 / L3 — 보류 회귀: evals/hub-routing/에는 5개의 블라인드 테스트 시나리오(RSA 분류, SQLi 확장, OSINT 반례, 결합 오케스트레이션, reverse/pwn 보류)가 포함되어 있습니다. 예상 답을 모르는 실행자가 실제 라우팅을 실행한 다음, 심판 + 인간 검토가 결과를 채점합니다. 라우팅 규칙 변경 후 모든 테스트가 다시 실행됩니다; 픽스처는 회귀 기준선 역할을 합니다.
• 경량 감사: 리프 스킬 슬리밍 원칙은 docs/skill-weight-audit.md에 문서화되어 있습니다.

---

기억해야 할 핵심 사실

• 챌린지 유형 분류를 먼저 배울 필요가 없습니다 — 그것이 핵심입니다.
• 스킬 이름을 기억할 필요가 없습니다 — ctf-super-hub와 ctf-beginner-hub만 기억하세요.
• 메인 진입점만 설치하는 것은 권장되지 않습니다 — 메인 진입점의 가치는 다른 스킬로의 라우팅에 있습니다. brainstorming, solve-challenge, ctf-*, strix-*를 함께 설치하세요.
• 단일 URL, zip 파일 또는 ELF 바이너리로 시작할 수 있습니다 — 처음부터 완전한 정보가 필요하지 않습니다.
• "더 많은 정보가 필요합니다"는 좋은 신호입니다 — 시스템이 작동 중임을 의미합니다.
• 백신 오탐지는 예상됩니다: 저장소에는 실행 파일이 포함되어 있지 않습니다 — Markdown 문서, 두 개의 읽을 수 있는 셸 스크립트(하나는 스킬 폴더를 복사하고, 다른 하나는 설치해야 할 도구를 확인/출력), 그리고 Python 검증 스크립트만 있습니다. 보안 교육 콘텐츠는 휴리스틱 탐지를 유발할 수 있습니다; 공식 저장소에서 온 경우 화이트리스트에 추가하세요.

---

저장소 구조(중요한 것)

실제로 신경 써야 할 것은 세 가지뿐입니다:

• ctf-super-hub/ — 메인 오케스트레이션 센터
• ctf-beginner-hub/ — 초보자 변형
• START-HERE.md — 빠른 시작 가이드

나머지(ctf-*/ 카테고리 스킬, strix-*/ 확장 레이어, solve-challenge/, brainstorming/, scripts/, evals/, docs/)는 시스템을 지원하지만 사용자로서 주의를 기울일 필요는 없습니다.

---

커뮤니티

GitHub가 배포를 처리합니다; LinuxDo 커뮤니티가 중국어 피드백과 토론을 처리합니다. 프로젝트는 issues/PRs 및 가장 혼란스러운 단계에 대한 커뮤니티 피드백을 통해 기여를 환영합니다.

결론: 이 프로젝트는 더 많은 스킬을 제공하려는 것이 아닙니다 — 초보자에게 가장 어려운 부분을 해결하려고 합니다: 어디서 시작해야 할지 모를 때 챌린지를 시작하는 것.