본문으로 건너뛰기
인터페이스 언어: 한국어
감사 / Signal

AI 코드 리뷰에는 실제로 읽은 버전을 밝혀야 합니다

AI 코드 리뷰의 의견을 비교한 버전, 실제 읽은 파일, 수정 뒤 확인 결과와 연결합니다.

본문 언어: 한국어

짙은 리본과 금빛 봉인으로 묶인 종이 더미가 펜 옆에 놓여 있다.
목차

“변경 사항을 검토했습니다. 사소한 의견 두 개 외에는 이견이 없습니다.” 이 보고서로 일이 끝날 수도 있습니다. 다만 한 가지 불편한 질문이 남습니다. 어느 변경 사항일까요? 리뷰가 진행되는 동안 작성자는 검증 로직을 추가하고 설정 파일을 바꾸었으며 의견 하나를 반영했습니다. 어시스턴트는 읽기를 마쳤지만 코드는 계속 바뀌고 있었습니다.

이는 가상의 예입니다. 여기서 살펴볼 것은 특정 저장소의 평가가 아니라 리뷰 범위를 보여 주는 증거입니다. 이 글에서 코드 리뷰는 문제를 찾기 위해 변경 사항과 그 맥락을 읽는 일입니다. 테스트 실행이나 배포 승인과는 다릅니다. “오류를 찾지 못했습니다”라는 문장은 어디에서 어떤 버전을 살펴봤는지와 함께 있을 때 의미가 있습니다.

회사는 Aeneia Audit에 AI 사용 방식과 그 작업을 인수할 증거의 검토를 의뢰할 수 있습니다. 코드 자체의 정확성이나 보안을 전문적으로 평가하려면 적절한 역량과 별도의 범위가 필요합니다. 여기서는 리뷰어가 받은 자료와 의사결정자에게 전달된 결론의 관계를 정리합니다.

하나의 요청 번호 안에도 서로 다른 변경이 있습니다

한 스튜디오가 장비 예약 포털을 확장한다고 가정해 봅시다. 수정의 목적은 사용 중단된 장비를 새 예약에서 제외하되 이력에는 남기는 것입니다. 장비 선택, 가용성 확인, 예약 저장, 설정, 테스트의 다섯 파일을 바꿉니다. 과거 예약에서는 새 고객에게 더 이상 제공하면 안 되는 장비도 계속 알아볼 수 있어야 합니다. 이 차이가 읽기의 초점입니다.

풀 리퀘스트는 코드 변경을 제안하는 요청으로, 하루 종일 같은 번호를 유지할 수 있습니다. 하지만 그 안에는 저장된 버전이 차례로 추가됩니다. 따라서 요청 식별자는 실제로 읽은 바이트를 정확히 가리키는 표지가 아닙니다. 보고서에는 비교의 기준점이 필요합니다. 시작 상태와 평가한 제안 상태입니다.

델타는 두 상태 사이의 차이입니다. 시작점을 정하지 않았다면 “변경 사항을 리뷰했습니다”는 마지막 수정, 작업 시작 이후의 전체 변경, 아직 저장된 버전에 포함되지 않은 로컬 파일 중 무엇이든 뜻할 수 있습니다. 각각 정당한 범위가 될 수 있습니다. 다만 도구의 기본 동작 때문에 우연히 하나가 선택되어서는 안 됩니다.

git diff 문서는 작업 파일과 스테이징 영역의 비교, 스테이징 영역과 한 버전의 비교, 저장된 두 상태의 비교를 구분합니다. 따라서 “diff”라는 단어만으로는 평가한 자료의 쌍을 알 수 없습니다.

포털 예에서 수정 전 상태를 A, 다섯 파일의 변경을 포함한 상태를 B라고 약속해 봅시다. 리뷰어는 A와 B의 차이와 필요한 맥락을 받아야 합니다. 이 글의 글자는 실제 버전 식별자가 아닌 예시 표기입니다. 실제 보고서에서는 평가한 자료를 찾을 수 있는 정확한 정보로 바꿔야 합니다.

로컬 파일을 다룰 때 저장된 저장소 식별자는 현재 수정 사항을 포함하지 않을 수 있습니다. 그러면 평가한 상태를 보존한 사본이나 다른 합의된 방식이 필요합니다. 읽기가 끝난 뒤 새 식별자를 적는다고 이전 검토가 새 파일을 포함하게 되지는 않습니다.

데이터로부터 계산한 요약값인 AI 보고서의 해시 (폴란드어)(링크된 글은 폴란드어입니다.)는 특정 자료를 알아보는 데 도움이 됩니다. 해시 자체가 그 자료를 읽었다거나 결론이 참이라는 증거는 아닙니다. 버전 표기에는 실제로 읽은 범위가 함께 있어야 합니다. 보고서의 이웃한 열에 들어가더라도 서로 다른 두 증거입니다.

브랜치를 업데이트한 뒤에도 비교의 시작점을 남기세요. 기준이 바뀌면 같은 최종 파일도 다르게 정의된 차이에 속할 수 있습니다. 다음 검토가 B에서 C까지의 수정인지, 새 시작점을 기준으로 한 전체 제안인지 보고서에 설명해야 합니다. 그렇지 않으면 이전에 보이던 파일 두 개가 왜 목록에서 갑자기 사라졌는지 읽는 사람이 알 수 없습니다.

버전은 읽는 동안 안정적으로 유지되거나 나중에 재현할 수 있어야 합니다. 작성자가 계속 작업 중이라면 현재 제안이 C로 넘어가는 동안 리뷰어는 보존된 B 사본을 읽을 수 있습니다. 병렬 작업의 합리적인 방법입니다. 단, 그 보고서를 나중에 C에 대한 리뷰라고 설명해서는 안 됩니다.

이름 다섯 개를 나열했다고 파일 다섯 개를 읽은 것은 아닙니다

가상의 보고서에서 어시스턴트는 변경 목록의 파일 이름 다섯 개를 적습니다. 하지만 구체적인 의견은 장비 선택과 가용성에만 관한 것입니다. 나머지 세 파일은 읽었을까요, 중요하지 않다고 보고 건너뛰었을까요, 아니면 내용 자체를 받지 못했을까요? 이름 목록은 그 질문에 답하지 못합니다. 내용 읽기가 아니라 색인에서 가져온 목록일 수 있습니다.

각 자료에 대한 범위를 간단히 설명해 달라고 요청하세요. 예를 들면 호출 함수와 함께 diff를 읽음, 파일 전체를 읽음, 생성 파일을 건너뜀, 내용을 이용할 수 없음, 도구 응답이 잘림 등입니다. 이 상태들은 뜻이 다릅니다. 작은 수정 하나를 평가하기 위해 주변의 모든 것을 읽었다고 주장할 필요는 없습니다.

우리 포털에서 설정 파일은 어떤 장비 범주가 표시되는지 정합니다. 어시스턴트가 이 파일을 받지 못했다면 사용 중단 장비의 완전한 제외를 확인했다고 주장해서는 안 됩니다. 그래도 가용성 함수에 대해서는 타당한 의견을 낼 수 있습니다. 결론의 범위는 작업 제목이 아니라 실제로 살펴본 의존성만큼이어야 합니다.

GitHub에서는 파일을 Viewed로 표시할 수 있고 파일이 바뀌면 표시가 해제됩니다. 이는 인터페이스에서 진행 상태를 추적하는 기능입니다. 모델 분석의 깊이나 완전성을 독립적으로 증명하지는 않습니다.

도구가 큰 파일의 일부만 보여 줬다면 그 사실을 보고서에 남기세요. 명령을 호출한 것만으로 “파일을 읽음”이라고 옮겨 적지 마세요. 응답이 출력 제한에서 끝났을 수 있습니다. 긴 AI 컨텍스트 (폴란드어)(링크된 글은 폴란드어입니다.)에서도 내용을 전달하는 것과 제대로 활용하는 것은 다릅니다. 리뷰에서는 적어도 먼저 전달됐는지부터 확인해야 합니다.

Aeneia 콘셉트 사진

변경된 줄 밖의 맥락도 중요하지만 질문에 맞춰 골라야 합니다. 장비를 확인하는 새 조건을 보려면 그 함수를 호출하는 위치를 살펴봐야 할 수 있습니다. 매개변수 이름 변경에는 호출부 확인이 필요합니다. 그렇다고 첫 라이선스 파일부터 마지막 아이콘까지 저장소 전체를 반드시 읽어야 한다는 뜻은 아닙니다.

기록에서는 보조 맥락과 평가한 변경을 구분할 수 있습니다. 리뷰어가 프로젝트 지침을 열었다면 어느 버전의 규칙을 고려했는지 적으세요. 외부 의존성의 코드를 확인하지 않았다면 함수가 그 의존성을 쓴다는 이유만으로 범위에 넣지 마세요. 경계를 분명히 하면 다음 사람이 아직 증거가 없는 곳에 주의를 기울일 수 있습니다.

생성된 요약과 미리보기는 특히 조심해서 다루세요. 의존성 변경 미리보기가 원본 파일의 모든 변화를 보여 주지는 않을 수 있습니다. 이미지나 바이너리 파일도 도구가 새 크기를 기록했다는 이유로 내용까지 평가된 것이 아닙니다. 보고서에서 이런 자료를 다른 방식의 확인 대상으로 솔직하게 표시할 수 있습니다.

Aeneia Audit: 자동 리뷰의 증거를 정리해 보겠습니다. 자료의 버전, 실제 읽은 범위, 수정 후 인수 결과가 대상입니다. 팀은 이전 패치에 대한 의견과 현재 제안에 대한 평가를 구별할 수 있습니다. AI 리뷰 보고서를 특정 변경에 연결하기.

의견을 수정하면 다음 평가 대상이 생깁니다

어시스턴트가 직접 주소를 통해 사용 중단 장비를 여전히 선택할 수 있다는 점을 발견합니다. 작성자는 예약 저장을 고칩니다. 그와 함께 함수 매개변수를 정리하고 테스트를 바꾸며 설정에 새 범주를 추가합니다. 상태 C가 생깁니다. 지적된 문제를 없앴다는 사실만으로 나머지 변경도 정확하다는 증거는 아직 없습니다.

따라서 다시 인수할 때는 두 가지를 묻습니다. B에서 발견한 특정 문제가 제거됐는가? B와 C 사이에 새로 무엇이 생겼는가? 첫 질문만 보면 수정 중 생긴 결함을 놓칠 수 있습니다. 반대로 이전 의견을 파악하지 않은 채 A부터 C까지 전체를 리뷰하면 특별히 확인해야 했던 부분을 놓칠 수 있습니다.

GitHub의 API를 통한 리뷰 생성 설명에서는 평가한 커밋, 즉 저장된 코드 상태의 식별자를 지정할 수 있습니다. 문서는 이후 지정한 줄이 바뀌면 댓글이 오래된 것으로 표시될 수 있다고 경고합니다. 의견의 위치는 자료의 버전과 연결됩니다.

따라서 이동한 줄 번호를 문제 해결로 취급하지 마세요. 오류가 다른 위치에 남아 있어도 인터페이스에서 댓글은 오래된 상태가 될 수 있습니다. 반대로 작성자가 관련 함수를 고쳤는데도 댓글은 계속 보일 수 있습니다. 인수 담당자는 스레드의 겉모습만이 아니라 의견의 내용과 현재 동작을 확인해야 합니다.

다시 읽은 결과는 이렇게 쓸 수 있습니다. “세 파일에서 B와 C의 차이를 확인하고 가용성 함수의 호출부를 다시 읽었습니다. 나머지 두 파일은 B 사본과 같습니다.” 이는 보고서 형식의 예입니다. 작성자가 “거기는 더 건드리지 않았다”고 보증한 뒤가 아니라 실제로 비교한 뒤에만 쓸 수 있습니다.

하지만 바뀌지 않았다는 사실이 이전의 빈틈까지 없애지는 않습니다. B의 설정을 읽지 않았다면 “B와 동일”이라는 정보도 그 설정을 리뷰했다는 뜻이 아닙니다. 범위를 보충하거나 열린 한계로 남겨야 합니다. 이 예에서 설정에 범주를 추가했다면 의존성을 보지 않고 새 줄만 읽는 대신 이전 규칙도 파악해야 합니다.

Copilot 코드 리뷰 안내는 적절한 설정이 없으면 새 푸시가 자동 재검토를 시작하지 않는다고 설명합니다. 수동으로 재검토를 요청하거나 새 푸시 리뷰를 설정할 수 있습니다. 커밋이 하나 더 나타났다는 사실만으로 새 리뷰가 이뤄진 것은 아닙니다.

자동화에서는 완료된 실행이 어떤 버전을 대상으로 했는지 보존하세요. 프로세스가 B에서 시작해 C가 공개된 뒤 끝나더라도 B의 결과를 정확히 보고할 수 있습니다. 두 사건이 같은 요청에서 일어났다는 이유만으로 요약이 그 평가를 현재 버전에 붙일 때 문제가 생깁니다.

리뷰가 풀 리퀘스트의 CI 프로세스 (폴란드어)(링크된 글은 폴란드어입니다.)에서 실행된다면 어떤 지침과 내용을 쓰는지도 별도로 정하세요. CI는 저장소의 변경으로 실행되는 자동 과정입니다. 무엇을 읽었는지에 대한 증거가 환경에 적절한 접근 경계가 있었는지까지 해결하지는 않습니다. 도구가 결과 하나를 보여 주더라도 읽기 범위와 환경 접근에는 별도의 답이 필요합니다.

파일 이름이 바뀐 뒤에도 이전 범위와의 연결을 남기세요. 옛 경로가 사라졌다고 동작도 제거된 것은 아닙니다. 코드가 옮겨졌을 수 있습니다. 리뷰어는 수정 사항이 이동한 위치를 찾아 필요한 호출부를 확인해야 합니다. “이전 이름이 없으므로 문제 종료”라고 쓴 보고서는 새 모듈의 같은 결함을 놓칠 수 있습니다.

이런 보고서로 무엇을 받아들일 수 있을까요?

보고서는 설명된 범위에서 문제를 찾지 못했다고 정직하게 말할 수 있습니다. 오류가 없다는 증거는 아닙니다. 테스트 실행도 자동으로 확인하지 못합니다. AI와 함께 실행한 테스트의 증거 (폴란드어)(링크된 글은 폴란드어입니다.)에는 명령, 조건, 결과가 포함됩니다. 코드를 읽는 것은 다른 작업입니다. 두 자료는 최종 결정을 보완할 수 있지만 서로를 대신하는 척해서는 안 됩니다.

모든 정보를 “확인됨”이라는 한 단어에 모으는 대신, 경계를 나눈 짧은 결과를 남기세요.

  • 리뷰가 다룬 버전과 비교 대상.
  • 실제로 읽은 파일과 필요한 맥락.
  • 발견한 문제와 이후 해결 방식.
  • 건너뛰었거나 이용할 수 없던 자료와 그 한계가 결론에 미치는 영향.
  • 테스트가 작업 범위에 포함됐다면 그 실행을 보여 주는 별도 증거.

이 기록은 수행 업체의 코드와 문서를 인수할 때 (폴란드어)(링크된 글은 폴란드어입니다.)도 도움이 됩니다. 회사가 실제로 받은 자료에 평가를 연결하기 때문입니다. 브랜치 이름, 회의 날짜, 의견 수는 상황을 파악하는 데 도움이 될 수 있지만 이 연결을 대신하지는 못합니다.

결정하기 전에 현재 제안을 마지막으로 인수한 범위와 비교하세요. 장비 범주 설정이 추가됐다면 그것을 읽도록 넘기고 이전 보고서는 B의 평가로 보존합니다. 다음 버전이 합의한 수정만 다룬다면 그 수정과 의존성을 어떻게 확인했는지 적습니다. 바뀌지 않은 파일을 모두 다시 대규모로 리뷰할 필요는 없습니다. 다만 오래된 보고서가 미래를 읽은 것처럼 다루어서는 안 됩니다.

Aeneia / Aeneia 편집부

편집부의 글입니다. 본문에 출처 링크가 있습니다.

Aeneia 소개

함께한 브랜드

  • L’Oréal
  • Garnier
  • Netflix
  • Carrefour
  • Warner Bros. Discovery
  • Biedronka
  • HBO Max
  • Wolt
  • Żabka
  • COSRX
  • 주폴란드 중국대사관
  • Mixa
Aeneia / Initium

지식에서 결정으로

정리하고 싶은 과제를 알려 주세요. 어디서 시작할지 함께 정합니다.

Aeneia에 문의하기

파트너의 솔루션을 활용합니다

  • Google
  • OpenAI
  • Microsoft
  • Stripe
  • Anthropic
  • Linear