repo-scan

repo-scan 스킬 개요

repo-scan이 하는 일

repo-scan은 저장소의 소스가 얼마나 오리지널 코드인지, 서드파티 코드인지, 아니면 빌드 노이즈인지 빠르게 파악하도록 돕는 크로스스택 소스 감사 스킬입니다. Code Review용 repo-scan이 필요하거나, 마이그레이션 계획을 세우거나, 리팩터링 여부를 판단해야 할 때 특히 유용합니다. 수천 개 파일을 일일이 훑기 전에 먼저 전체 윤곽을 잡고 싶을 때 잘 맞습니다.

누가 설치하면 좋은가

레거시 코드베이스, 모노레포, 또는 소유권이 불분명한 혼합 언어 저장소를 다루는 사람이라면 repo-scan 스킬을 설치할 가치가 있습니다. 특히 C++, Android, iOS, 웹 코드를 한 번에 구조적으로 읽어야 하는 리뷰어, 플랫폼 엔지니어, 아키텍트에게 적합합니다.

무엇이 다른가

repo-scan의 핵심 가치는 단순히 의존성을 나열하는 데 있지 않습니다. 파일을 분류하고, 무엇을 유지할지·추출할지·병합할지·삭제할지 결정하는 데 도움이 되는 실행 가능한 판단을 제공합니다. 그래서 일반적인 프롬프트보다 훨씬 의사결정 지향적이고, 특정 생태계 전용 의존성 도구보다도 실무에 바로 쓰기 좋습니다.

repo-scan 스킬 사용법

repo-scan 설치하기

스킬 파일에 있는 repo-scan 설치 단계를 따르고, 재현성을 위해 고정된 커밋 방식을 유지하세요. Claude skills 디렉터리에 설치한 다음, 민감한 코드에 적용하기 전에 의도한 소스를 사용 중인지 확인해야 합니다.

올바른 입력부터 시작하기

repo-scan을 가장 잘 활용하려면 저장소 경로, 감사 목표, 범위 경계를 함께 전달하세요. 예를 들어 다음과 같은 프롬프트가 좋습니다. “이 monorepo를 스캔해서 payments 서비스를 리팩터링하기 전에 핵심 자산, 포함된 서드파티 코드, 그리고 제거 후보가 될 만한 부분을 식별해줘.” 단순히 “이 repo를 분석해줘”라고 하는 것보다 훨씬 낫습니다. 스킬이 어떤 유용한 판단을 내놓아야 하는지 분명해지기 때문입니다.

먼저 읽어야 할 파일

SKILL.md부터 시작한 뒤, 규칙이나 예외를 설명하는 저장소 수준 문서가 있으면 함께 확인하세요. 있다면 README.md, AGENTS.md, metadata.json과 rules/, resources/, references/, scripts/ 같은 지원 폴더도 스캔 결과를 신뢰하기 전에 읽어두는 것이 좋습니다. 이 저장소에서는 노출된 소스 파일이 SKILL.md 하나뿐이므로, 설치 여부는 주로 문서화된 워크플로와 고정된 소스를 직접 검토했는지에 달려 있습니다.

스캔을 리뷰 흐름에 넣기

repo-scan은 1차 분류 도구로 쓰고, 가장 영향이 큰 결과는 코드 리뷰나 타깃 grep으로 다시 확인하세요. 가장 좋은 흐름은 이렇습니다. 저장소를 스캔하고, 표시된 모듈을 검토한 다음, 소유권과 내장 라이브러리를 검증하고, 그 결과를 리팩터링이나 정리 계획으로 연결합니다.

repo-scan 스킬 FAQ

repo-scan은 대규모 저장소에만 필요한가?

아닙니다. 대규모이거나 혼합 언어 저장소에서 가장 가치가 크지만, 벤더 코드가 많거나 생성된 출력물이 많거나 모듈 경계가 불분명한 작은 코드베이스에서도 도움이 됩니다. 저장소가 이미 깔끔하고 문서화가 잘 되어 있다면 효과는 상대적으로 작습니다.

repo-scan은 일반 프롬프트와 어떻게 다른가?

일반 프롬프트도 저장소를 요약할 수는 있지만, repo-scan은 파일 분류와 판단 결과를 포함한 반복 가능한 감사 워크플로를 유도하도록 설계되어 있습니다. 그래서 일회성 요약보다 일관된 점검 기준이 필요할 때 Code Review용 repo-scan이 더 강합니다.

repo-scan은 초보자도 쓰기 쉬운가?

네, 명확한 목표를 제시하고 결과를 비판적으로 읽을 수 있다면 가능합니다. 이 스킬은 소스 제어 기초를 가르치기보다 판단을 내리는 데 가깝기 때문에, 초보자는 “무엇을 안전하게 제거할 수 있나?”처럼 구체적인 질문으로 쓰는 것이 좋습니다. 막연히 “모든 걸 분석해줘”라고 하기에는 적합하지 않습니다.

repo-scan을 쓰지 말아야 할 때는?

제품을 고수준으로 설명받고 싶을 때, 패키지 의존성 목록만 필요할 때, 또는 런타임 디버깅이 목적일 때는 쓰지 마세요. 저장소가 아주 작거나, 중요한 질문이 코드 소유권이 아니라 동작 테스트라면 역시 잘 맞지 않습니다.

repo-scan 스킬 개선 방법

감사 경계를 더 좁게 지정하기

repo-scan 결과를 가장 잘 개선하는 방법은 저장소의 어느 구간을 볼지와 어떤 결정을 내리고 싶은지 분명히 하는 것입니다. 전체 저장소 스캔인지, 특정 서비스인지, 아니면 서드파티 코드나 죽은 코드일 가능성이 있는 파일만 볼지 명시하세요. 범위를 좁히면 잡음 많은 판단이 줄고, 보고서도 훨씬 실행하기 쉬워집니다.

실제로 쓸 출력 형식을 요청하기

정리 계획이 필요하다면 위험도나 작업량 순으로 모듈을 정렬해 달라고 요청하세요. Code Review 보조가 필요하다면 내장 라이브러리와 생성 자산이 소유권 문제를 숨길 수 있는 위치를 알려 달라고 하세요. repo-scan은 저장소 자체보다, 그다음에 내릴 결정을 프롬프트에 적을 때 가장 잘 작동합니다.

경계 사례는 수동으로 검증하기

가장 흔한 실패는 생성 파일, 벤더 코드, 언어별 빌드 출력물에 대한 1차 분류를 지나치게 신뢰하는 것입니다. 스캔 후에는 상위로 표시된 경로를 직접 확인하고, 저장소의 관례와 비교해 보세요. 그래야 겉보기엔 중복처럼 보여도 실제로는 삭제하면 안 되는 코드를 지킬 수 있습니다.

발견에서 실행으로 이어가기

첫 repo-scan 결과를 받은 뒤에는 가장 애매한 모듈을 겨냥해 후속 질문을 던지세요. 예를 들어 “이렇게 표시된 디렉터리 중 보관해도 안전한 것은 무엇인가?” 또는 “어떤 서드파티 라이브러리가 선언된 것이 아니라 포함된 형태로 보이는가?”처럼 묻는 방식입니다. 이렇게 해야 repo-scan이 구체적인 다음 단계에 붙어 있고, 최종 감사 결과의 실용성도 높아집니다.