Sphinx - AI가 작성한 코드를 이해했는지 푸시 전에 퀴즈로 확인하는 도구

1 week ago 20

“생각은 외주를 줄 수 있어도 이해는 외주를 줄 수 없다” - AI가 작성한 코드를 푸시하기 전 ‘스핑크스의 질문’으로 개발자의 이해도를 확인하는 Git 훅
지정한 브랜치로 git push하면 잠시 멈추고, 질문에 통과하면 기다리던 푸시를 그대로 재개
코드를 작성한 대화에 참여하지 않은 별도 리뷰어 모델이 커밋과 관련 코드를 읽고 출제
함수 이름을 외우는 대신 실제 동작과 실패 상황, 반드시 지켜야 할 조건을 묻는 방식
“작업은 완료했지만 큐에 완료 응답을 보내기 전에 죽으면 중복 실행되는가?”처럼 구체적인 상황의 결과를 예측
틀리면 이유를 알려주고 다른 상황으로 다시 질문하며, 코드와 diff를 보면서 답하는 오픈북 방식
Claude Code, Codex, Cursor, OpenCode, Pi와 일반 Git에서 사용하며, 브라우저나 터미널로 응답 가능
검사할 브랜치와 커밋/푸시 시점, 질문 수를 설정하고, 설계 의도와 구현 세부사항 중 어디에 초점을 맞출지 선택 가능
기존 Claude Code/Codex 구독이나 OpenRouter, OpenAI 호환 API로 리뷰하며, 선택한 모델의 사용량과 비용 발생
설치 시 전역 Git 훅에 적용되며, 검사는 건너뛸 수 있고 그 기록을 남기는 이해도 학습 도구
Node.js 22.19 이상과 macOS/Linux/WSL 지원
MIT 라이선스