gh-excavate: GitHub Copilot과 함께 코드 발굴

Source: Dev.to

(번역할 텍스트를 제공해 주시면, 요청하신 대로 한국어로 번역해 드리겠습니다.)

내가 만든 것

새벽 2시, 알 수 없는 레포지토리에 갇혔나요?
실수로 프로덕션 코드를 삭제하고 그 코드가 무엇을 했는지 파악하려고 애쓰고 있나요?
문서가 전혀 없는 코드베이스를 인수받았나요?

우리 모두 그런 경험이 있습니다.

저는 gh‑excavate 를 만들었습니다 — 코드 고고학을 위한 AI 기반 GitHub CLI 확장입니다. 이것은 터미널에 바로 통합되는 어시스턴트 로, 코드가 무엇을 하는지뿐만 아니라 왜 존재하는지 이해하도록 도와줍니다.

커밋을 일일이 살펴보고 파일을 스캔하며 맥락을 맞춰가는 대신, 한 번의 명령만 실행하면 gh‑excavate 가 레포지토리를 파고 들어갑니다.

기능

• 레포지토리 또는 폴더를 분석해 목적, 아키텍처, 위험 요소를 설명
• 파일이 생성된 순간부터 삭제될 때까지의 생애 추적
• 잠재적인 죽은 코드 또는 잊혀진 코드 감지
• “왜 이게 존재하나요?” 라는 질문을 조사하는 데 도움
• 로컬 경로와 원격 GitHub 레포지토리 모두 지원

CLI가 구조를 담당하고, Git이 히스토리를 관리합니다. GitHub Copilot이 작업의 두뇌이자 영혼—맥락을 종합하고 의도를 해석하며 원시 코드와 Git 히스토리를 터미널에서 바로 인간 수준의 설명 으로 변환하는 추론 엔진입니다.

gh‑excavate 코드를 단순히 읽는 것이 아니라 해석합니다.

데모

저장소: gh‑excavate

gh‑excavate는 GitHub CLI 확장 프로그램입니다. 설치하면 터미널 안에서 바로 실행됩니다.

설치

검증

명령

예시 실행

GitHub Copilot CLI와 함께한 나의 경험

GitHub Copilot CLI는 이 프로젝트를 접근하는 방식을 근본적으로 바꾸어 놓았습니다. 깨지기 쉬운 휴리스틱과 무거운 파싱 로직에만 의존하는 대신, 의미 있는 프롬프트를 설계하고, Git 히스토리에서 올바른 컨텍스트를 추출하며, CLI를 지능적으로 구조화하는 데 집중했습니다 — 그 사이 Copilot이 더 깊은 추론을 담당했습니다.

Copilot은 다음과 같은 역할을 맡았습니다:

• 해석 엔진
• 아키텍처 분석가
• 기술 히스토리스트
• 컨텍스트 종합자

gh‑excavate는 증거를 수집합니다 — 커밋 로그, 파일 히스토리, 구조적 컨텍스트. Copilot CLI는 점들을 연결합니다.

개발 과정에서 가장 중요한 깨달음은 다음과 같습니다: 실제 문제는 코드를 접근하는 것이 아니라 의도를 이해하는 것이라는 점입니다. Git은 무엇이 바뀌었는지를 알려주고, Copilot은 왜 바뀌었는지를 추론하도록 도와줍니다.

터미널에서 직접 Copilot과 작업하는 느낌은 자연스럽고 개발자 친화적이었습니다. Git 명령을 검증하고, 파일 삭제와 같은 엣지 케이스를 고민하며, CLI를 떠나지 않고 워크플로를 다듬을 수 있었습니다.

이 프로젝트는 단순히 자동화에 그치는 것이 아니라, 개발자의 인지를 증강하는 데 목적이 있습니다. 코드베이스에 길을 잃었을 때 필요한 것은 자동완성이 아니라 이해입니다. 코드는 시간이 지나면서 오래되고, 컨텍스트는 사라집니다. gh‑excavate는 그 컨텍스트를 되찾아 줍니다.

git 로그가 난해하고 프로덕션이 불타오를 때 — excavate 하세요. “누가 이 코드를 썼지?”는 전략이 될 수 없습니다.