파이썬을 모르는 상태로 1000줄 넘는 파이썬 변경 사항을 제로샷으로 승인받고 머지함
Got a > 1000 line Python change approved and merged zero shot without knowing Python
핵심 요약
파이썬 지식 없이 AI 에이전트와 모범 사례를 활용해 고품질 코드를 작성하고 리뷰를 통과한 사례입니다.
- 체계적 접근 — 모범 사례 레포지토리와 리뷰 이력을 활용해 코드 품질을 개선함
- 에이전트 활용 — 서브 에이전트를 통해 코드 구조와 스타일 규칙을 단계별로 적용함
- 코드 리뷰 — 인간 리뷰어의 요구사항을 사전에 예측하여 즉시 승인받는 전략을 구사함
- 기술적 통찰 — 언어 지식은 부족해도 구조적 사고와 중복 제거를 통해 코드 완성도를 높임
여기는 코드 퀄리티 빡세게 따지는 곳이라, 내 생각엔 이 정도면 합리적인 변경이라고 본다. 난 이걸 나 자신을 위한 도전으로 삼았어. 리뷰어가 대대적인 수정이나 근본적인 재설계를 요구하는 대신, 바로 승인해주거나 사소한 코멘트 정도만 달 수 있게끔 퀄리티를 뽑아내는 거지. 프라이버시 때문에 세부적인 건 좀 뭉뚱그렸지만, 내가 거친 과정은 다음과 같아.
-
일단 원하는 기능 다 돌아가고 테스트 통과하는 초기 코드를 짰음.
-
파이썬 모범 사례 잘 보여주기로 유명한 깃허브 저장소를 하나 다운로드했어 (에이전트한테 물어보면 적절한 예시들 잘 알려줌).
-
서브 에이전트들을 시켜서 각 하위 디렉토리를 읽게 하고, 거기 나온 모범 사례들을 내 코드에 어떻게 적용할지 제안하게 했음. 여기서 진짜 유용한 팁들을 많이 건졌는데, 예를 들면 성공 여부 상관없이 임시 변경 사항을 깔끔하게 되돌리는 context manager 사용법 같은 거 말이야.
-
내 변경 사항이랑 비슷한 다른 변경 건들에 달린 리뷰 코멘트들을 저장소에서 싹 다 뒤져봤어. 그리고 적용 가능한 건 선제적으로 반영해달라고 시켰지 (대부분 메서드 이름 짓는 거였는데, 에이전트가 알아서 수정하게 함).
-
마지막으로, 해당 저장소에서 공식적으로 내놓은 파이썬 스타일 가이드를 가져왔어. 서브 에이전트들을 시켜서 이 규칙들을 하나씩 따로 적용해보고, 메인 에이전트가 전체적인 코드 구조 안 깨뜨리는 선에서 제안들을 검토하게 만들었지.
개인적으로 이 순서가 중요하다고 봐. 처음부터 규칙만 기계적으로 따지다 보면 전체적인 구조는 개판인데 방어적인 코드만 잔뜩 나오거든. 반대로 예전 리뷰어들도 실수할 수 있으니까, 공식적으로 발표된 규칙을 준수하는 걸 마지막 단계로 두는 게 맞아. 프로그래밍 언어도 잘 모르는 상태에서 큰 변경 사항을 머지시키는 게 웃기긴 하지만, 그래도 이 과정 덕분에 첫 버전보다 객관적으로 훨씬 나아졌다고 확신해. 아, 그리고 나도 다른 언어들은 좀 다룰 줄 아니까 에이전트한테 "여기서 똑같은 짓 반복하고 있잖아, 비슷한 코드 경로 타는 키들은 묶어서 처리하게 일반화하자" 같은 지시는 할 수 있었어. 뭐 꼭 프로그래밍을 잘 알아야 한다는 건 아니지만, 구조화된 작업을 수행하는 마인드셋 정도는 갖추고 있어야 할 거야.


