받은편지함 분류하기

이 가이드에서는 받은편지함을 다루는 방법을 설명합니다. 받은편지함은 나를 막거나 나를 명시적으로 요청하는 모든 항목, 즉 대기 중인 에이전트 승인, 실패한 티켓 동기화, 그리고 나를 리뷰어나 작성자로 포함하는 모든 풀 리퀘스트를 한곳에 모으는 유일한 화면입니다.

받은편지함 열기

사이드바에서 받은편지함을 클릭합니다. 배지에는 대기 중인 에이전트 승인, 실패한 동기화, 리뷰를 기다리는 열린 PR의 수가 표시됩니다.
또는 ⌘K를 누르고 받은편지함 탐색 명령을 실행합니다.
또는 /workspaces/<workspace-id>/inbox로 바로 딥링크합니다.

사이드바 항목에는 항상 실시간 개수가 표시되므로, 페이지를 열지 않고도 분류할 작업이 쌓이는 것을 볼 수 있습니다.

심각도를 한눈에 파악하기

위에서 아래로 훑어보세요. 받은편지함은 이미 긴급도 순으로 정렬되어 있습니다.

고정된 확인이 필요합니다 스트립이 PR 섹션 위에 자리합니다. 모든 카드에는 심각도 칩이 붙습니다. 등록된 소스(확인 프롬프트에 멈춘 에이전트, 공급업체 미러가 오래된 티켓 동기화)는 차단됨을 표시합니다.
스트립 안에서는 가장 긴급한 심각도가 먼저 오고, 동률이면 가장 오래 기다린 항목이 앞섭니다.
스트립 아래에서 PR은 고정된 리뷰 수명주기 섹션, 즉 리뷰가 필요합니다, 나에게 돌아옴, 승인됨, 초안, 리뷰어 대기 중, 병합 중 및 최근 병합됨, 작성자 대기 중으로 묶입니다. 위쪽 섹션은 나에게 필요한 것이고, 나머지는 내 PR이 어디에 있는지를 보여 줍니다. 리뷰가 필요합니다에는 팀 리뷰가 있는 forge에서 내가 속한 팀을 아직 요청 중인 PR도 포함됩니다(GitHub은 팀원 중 한 명이라도 리뷰하면 팀 요청을 제거합니다).

항목은 무언가를 막거나 나를 명시적으로 요청할 때만 받은편지함에 들어옵니다. 스트립과 섹션 목록이 모두 비어 있을 때 모두 확인했습니다를 표시하는 것은 그 비어 있음이 믿을 만할 때뿐입니다.

모든 forge에 걸친 하나의 받은편지함

워크스페이스에 둘 이상의 코드 호스트에 있는 저장소가 있으면, 받은편지함은 이들을 하나의 흐름으로 병합합니다. GitHub 풀 리퀘스트와 Bitbucket 풀 리퀘스트가 공급업체별로 묶이지 않고 시간순으로 같은 섹션에 놓입니다. 행의 repo #number 메타 정보가 이들을 구분해 줍니다.

“내 것”은 forge별로 해석됩니다. forge마다 다른 계정이기 때문입니다. 풀 리퀘스트가 내 것이거나 내 리뷰를 요청하는 것으로 간주되는 것은, 해당 저장소가 실제로 있는 forge에서 내 아이덴티티와 일치할 때뿐입니다.

중단되었거나 연결되지 않은 forge는 아무것도 제공하지 않고 나머지 받은편지함을 그대로 둡니다. 연결 하나가 끊겼다고 해서 목록 전체가 비는 일은 없습니다. 모든 forge 로그인이 아직 해석되지 않았거나(GitHub 계정을 확인할 수 없습니다 — 문구는 여전히 GitHub을 지칭합니다), githubstatus.com이 장애를 보고하거나, 연결된 저장소를 포함하는 GitHub App 설치가 일시 중단된 경우에는 빈 상태가 모두 확인했습니다 대신 주의 사항을 알려 줍니다.

주의 스트립 정리하기

각 스트립 카드에는 하나의 다음 동작이 있습니다.

카드가 대기 중인 에이전트 확인이면 검토를 클릭합니다. 그러면 대기 중인 확인과 함께 해당 에이전트의 스페이스로 이동합니다. 거기서 승인하거나 거부합니다(에이전트와 채팅 참고).
카드에 공급업체에 대한 동기화 실패가 표시되면 열기를 클릭합니다. 그러면 설정 → 워크스페이스 → 일반으로 이동하고, 여기의 동기화 상태 카드에 각 연결의 마지막 동기화, 연속 실패 횟수, 최근 결과가 표시됩니다. 받은편지함에는 공급업체별 최신 실패만 나타나므로, 동기화가 복구되면 카드가 지워집니다.
카드는 근본 상태가 해결되면(에이전트가 응답을 받거나 동기화가 복구되면) 스스로 사라집니다. 수동으로 닫을 것은 없습니다.

막고 있는 항목으로 필터링하기

텍스트 필드에 포커스가 없을 때 f를 눌러 필터 메뉴를 열거나, 도구 모음에서 필터 버튼을 클릭합니다.
상태, 작성자, 리뷰어, 내용, 저장소 소유자/이름, 날짜 범위, 빠르게 리뷰 가능 중에서 원하는 조합을 고릅니다. 메뉴의 패싯 개수는 각 옵션이 일치하는 받은편지함 항목 수를 보여 줍니다.
활성 필터는 목록 위 막대에 칩으로 나타납니다. 칩의 ✕를 클릭하면 그 조건이 해제됩니다.
왼쪽 레일을 사용해 섹션 사이를 이동합니다. 각 항목에는 실시간 개수가 표시되고, 강조 표시는 스크롤 위치를 따라갑니다. 분류하지 않는 섹션(예를 들어 리뷰를 처리하는 동안의 초안)은 섹션 헤더를 클릭해 접습니다.
열 헤더(제목, 변경 사항, 업데이트됨)를 클릭하면 모든 섹션이 정렬됩니다. 활성 열을 다시 클릭하면 정렬 방향이 바뀝니다. 표시 옵션 버튼은 초안 표시 여부, 최근 병합 범위, 행 속성, 정렬 순서, 그룹화를 제어합니다(작성자별 그룹화만 받은편지함 레이아웃을 바꿉니다).

여기의 필터는 PR 큐와 독립적입니다. 받은편지함을 좁혀도 큐의 필터는 바뀌지 않고, 그 반대도 마찬가지입니다.

PR 항목 처리하기

아무 행이나 클릭해 PR 상세 페이지를 엽니다.
PR이 리뷰가 필요합니다에 있으면 리뷰하고 결정을 제출합니다. PR 리뷰 및 병합을 참고하세요.
PR이 나에게 돌아옴(변경 요청됨 또는 CI 실패)에 있으면 체크아웃에서 수정 사항을 푸시하거나 후속 작업을 에이전트에 맡깁니다.
PR이 승인됨에 있으면 상세 페이지에서 병합합니다.
직접 하기보다 리뷰를 위임하고 싶으면 리뷰어 디스패치와 디스패치 수명주기를 참고하세요.

근본 상태가 바뀌면(리뷰가 반영되거나 PR이 병합되면) 분류기가 PR을 새 섹션으로 자동으로 다시 배치합니다.

잘못한 동작 취소하기

⌘Z를 눌러 마지막 동작을 취소하고, ⌘⇧Z를 눌러 다시 실행합니다.
텍스트 필드에 포커스가 있으면 ⌘Z는 대신 필드의 텍스트를 편집합니다. 앱 수준 동작을 취소하려면 먼저 필드 밖을 클릭하세요.

제자리에서 단축키 찾아보기

텍스트 필드에 포커스가 없을 때 ?를 누르면 키보드 단축키 시트가 열립니다. 여기에는 받은편지함의 f 필터 단축키를 포함해 현재 라우트에서 활성인 모든 바인딩이 나열됩니다. 전체 목록은 키보드 단축키 레퍼런스에 있습니다.

커맨드 팔레트에서 조작하기

아무 곳에서나 ⌘K를 눌러 커맨드 팔레트를 엽니다.
받은편지함을 입력해 페이지로 이동하거나 PR 제목을 입력합니다. 팔레트가 일치하는 풀 리퀘스트를 나열하고 선택한 것을 엽니다.
받은편지함이 열려 있을 때 이 페이지 링크 복사를 실행해 해당 URL을 복사해 공유합니다. 이 명령은 현재 라우트를 복사하므로, 받은편지함 URL이 되는 것은 이 페이지에 있을 때뿐입니다.

필요할 때 새로 고치기

받은편지함은 실시간으로 업데이트되지만, 데이터가 오래되었다고 의심되면 도구 모음의 새로 고침 컨트롤을 클릭하세요. 그러면 연결된 모든 forge를 서버 측에서 즉시 훑고 병합/리뷰 오버레이를 다시 가져옵니다. 아이콘은 모든 가져오기가 끝날 때까지 회전합니다.