보고된 버그를 초안 PR로 수정하기

엔지니어링 채널에 보고된 버그는 엔지니어가 계획된 작업을 미뤄두고 이를 재현하여 원인을 찾을 때까지 열려 있는 경우가 많습니다. 이러한 조사가 대개 작업의 대부분을 차지하며, 실제 변경 사항은 작습니다.

채널에 Claude Tag가 있고 저장소가 연결되어 있다면, 보고서에 답장하세요. Claude가 버그를 재현하고 원인을 찾은 후 초안 pull request를 엽니다. Claude는 스레드에 진행 상황을 게시하며, 이곳에서 팀의 누구든 다른 접근 방식을 요청할 수 있습니다. Claude는 자체 GitHub 계정으로 코드의 자체 사본에서 작업하므로 브랜치 보호 및 검토가 적용됩니다. 병합 여부는 엔지니어가 결정합니다.

설정

Claude에게 무엇을 요청할지, 그리고 Claude가 하는 일

버그 보고서가 들어오면 해당 스레드에 답장하여 Claude에게 재현하고 수정하도록 요청하세요. 어떤 저장소인지, 그리고 초안 PR이 열리고 CI가 통과하는 등 언제 멈출지 알려주세요.

Claude의 첫 답장은 작업하면서 업데이트하는 체크리스트이므로, 확인하여 Claude의 진행 상황을 볼 수 있습니다. 작업을 마치면 아래 메시지를 게시합니다:

Claude는 자체 GitHub 계정으로 pull request를 열었으므로, 귀하의 브랜치 보호 및 검토 규칙이 적용됩니다.

누군가 병합하기 전에 pull request에서 변경된 코드를 읽고 새 테스트가 보고된 사례를 다루는지 확인하세요.

후속 조치

스레드에서 접근 방식 수정하기

스레드에 있는 누구든 Claude를 다시 태그하지 않고도 변경을 요청할 수 있으며, Claude는 동일한 pull request를 업데이트합니다(스레드에서 답장하여 방향을 조정하기). export 코드를 담당하는 Leo가 스레드에 답장합니다:

Claude가 pull request를 팔로우하도록 하기

Claude는 누가 열었든 상관없이 pull request를 팔로우하고 각 CI 결과를 스레드에 게시할 수 있습니다. 검사가 실패했을 때만 태그하도록 요청하세요.

Claude가 새로운 보고서마다 조치하도록 하기

채널에서 자동 응답이 켜져 있으면 Claude는 태그 없이도 새로운 보고서에 조치를 취할 수 있습니다(상시 작업). 아래 메시지를 한 번 보내면 Claude가 새로운 버그 보고서마다 재현을 시도합니다. Claude는 초안 pull request를 게시하거나, 시도한 내용을 게시합니다.

채널에 설정된 상시 지침 확인하기

Claude는 요청하면 채널의 상시 지침을 나열하므로, 하나를 변경하거나 중지할 수 있습니다.

진단만 요청하기

Claude가 얼마나 진행할지는 사용자가 결정합니다. 원인만 요청하면 Claude는 코드를 변경하거나 pull request를 열지 않고 스레드에 조사 결과를 게시합니다.

팁

Claude에게 저장소와 명확한 중단 지점 알려주기

첫 메시지를 보내기 전에는 스레드가 시작될 때 Claude에게 코드 사본이 없습니다. 메시지에서 저장소 이름을 언급하면 Claude가 이를 클론합니다. CI가 통과하는 등 언제 멈출지 알려주면 Claude가 수정이 완료된 시점을 알 수 있습니다.

Claude에게 저장소의 규칙을 한 번만 알려주기

Claude는 파일이 어디에 위치해야 하는지, pull request에 무엇이 포함되어야 하는지 등 저장소의 규칙을 작업할 때마다 따를 수 있습니다(저장소 규칙을 고정하기).

관련 리소스

• Claude Tag 소개 과정에서 자세히 알아보세요.
• Claude Tag 시작하기: 채널에 @Claude를 추가하고 그곳에서 무엇을 읽을 수 있는지 확인하세요.
• 버그 수정하기: 이 사용 사례가 기반으로 하는 Claude Tag 문서 페이지입니다.