검사란하나의 검사입니다. 실행이란실행은 정책에 따라 변경 사항에 대해 검사를 수행하는 과정입니다. 발견 사항이란발견 사항은 검사에서 보고된 내용을 의미합니다.
해당 내용은 다음 경로에서 확인할 수 있습니다:품질 → 실행및품질 → 발견 사항.
실행 내용 확인하기
실행 결과에는 각 검사 항목과 그 결과, 출력 내용이 표시됩니다. 검증에 실패한 경우 실행 내역을 통해 원인을 파악할 수 있습니다.
상단부터 순서대로 확인하세요. 가장 먼저 실패한 검사가 실제 문제일 가능성이 높으며, 이후의 실패는 대개 그 결과일 뿐입니다. 빌드 실패 뒤에 12개의 테스트 실패가 발생했다면 이는 하나의 문제이지 13개의 문제가 아닙니다.
발견 사항
발견 사항은 리뷰어 에이전트, 스캐너, 자문 게이트에서 생성됩니다. 각 발견 사항에는 발견된 내용, 위치, 심각도가 포함되어 있습니다.
그 처리 과정은 다음과 같습니다:
- 생성됨검사 또는 리뷰어에 의해 생성됩니다.
- 전달됨수정 가능한 발견 사항은 개발자 에이전트에게 재작업을 위해 전달되고, 나머지는 pull request에 등록됩니다.
- 해결됨수정되었거나, 수락되었거나, 무시된 상태를 의미합니다.
분류 작업
각 발견 사항에 대한 핵심 질문은 '이것이 사실인가?'가 아니라 '이것이 다음 단계에 영향을 미치는가?'입니다.
- 즉시 수정정확성, 보안 등 리뷰 단계에서 반드시 통과해야 하는 사항입니다.
- 수락문제는 있지만 현재 시점에서 조치할 필요가 없는 경우입니다. 그 이유를 반드시 기록해 두세요.
- 무시오탐지이거나 해당 코드에 적용되지 않는 규칙인 경우입니다.
무시할 때는 반드시 그 이유를 명시해야 합니다. 이유 없이 무시하는 것은 불편한 진실을 숨기는 것과 다를 바 없으며, 6개월 후에는 그 차이를 구분할 수 없게 됩니다.
발견 사항이 너무 많은 경우
발견 사항의 수는 코드 품질이 아닌 설정 관련 신호입니다.
대부분의 변경 사항에서 동일한 검사가 반복적으로 작동한다면 이는 문제를 찾아낸 것이 아니라 코드베이스를 그대로 반영한 것입니다. 규칙이 프로젝트 관례와 맞지 않거나, 이미 감수하기로 한 기술 부채일 뿐입니다. 어느 쪽이든 해당 검사는 적절한 형태가 아닙니다.
발견 사항과 게이트
자문 게이트에서 나온 발견 사항은 참고용 정보입니다. 반면 차단 게이트에서 나온 발견 사항은 작업 진행을 중단시킵니다. 발견 사항 자체는 동일하지만 정책에 따라 그 영향이 달라집니다.
검사 결과는 옳지만 너무 엄격할 경우 이를 제거하는 대신 심각도를 조정하는 것이 해결 방법입니다. 자세한 내용은품질 정책 및 게이트.