PR 을 따라 이슈가 움직이게 하기

개발자가 PR 을 열고 머지할 때마다 GoalTrack 에 와서 이슈 상태를 손으로 옮기는 일은 자주 빠집니다. 그러면 이슈 목록과 프로젝트 진척이 실제보다 늦게 보입니다. 저장소를 연결해 두면 이슈가 PR 을 따라 저절로 움직입니다.

준비 — 한 번만

워크스페이스 소유자·관리자가 설정 › 연동 의 GitHub(또는 GitLab) 카드에서 「연결 추가」를 누르고, 결과로 나오는 수신 주소와 비밀값을 GitHub·GitLab 의 webhook 설정에 붙여 넣습니다. 이벤트는 GitHub 은 Pull requests, GitLab 은 Merge request events 만 고르면 됩니다. 자세한 순서와 연결 상태 읽는 법은 GitHub · GitLab 연결에 있습니다.

하루의 흐름

1. 이슈를 맡으면 이슈 상세의 「브랜치 이름 복사」(⌘/Ctrl + ⇧ + .)로 이슈 키가 든 브랜치 이름을 받아 브랜치를 만듭니다. 예: eng-12-fix-login
2. PR 을 열면 이슈가 팀의 첫 “진행” 상태(예: In Progress)로 옮겨지고, 이슈 상세의 「개발」 칸에 PR 카드가 붙습니다. 카드를 누르면 GitHub·GitLab 의 그 PR 로 갑니다.
3. 리뷰를 마치고 머지하면 이슈가 팀의 첫 “완료” 상태(예: Done)로 옮겨집니다. 이슈의 활동 탭에는 GitHub·GitLab 연동이 옮겼다고 남습니다.

이슈를 손으로 옮기지 않아도 되니, 그 이슈가 속한 프로젝트와 이니셔티브의 진척도 PR 과 함께 움직입니다.

이럴 때는 움직이지 않습니다

• 초안(draft) PR — 카드만 붙고 상태는 그대로입니다. 초안을 풀면 진행 중으로 옮겨집니다.
• 참조만 한 PR — 본문에 Refs ENG-12 처럼 참조 말만 적었다면 카드만 붙습니다.
• 외부 기여자의 PR — 열렸을 때는 아무것도 바뀌지 않고, 유지보수자가 머지할 때 완료로 옮겨집니다.
• 사람이 상태를 직접 바꾼 뒤 — 같은 PR 에 push 하거나 제목을 고쳐도 다시 옮기지 않습니다. 이미 완료된 이슈를 진행 중으로 되돌리지도 않습니다.

이슈 키를 어디에 적어야 이어지는지(브랜치 이름 · PR 제목 · 본문의 Fixes ENG-12)는 이슈와 PR 잇기에 표로 정리돼 있습니다.