할 일 목록은 입력을 기다리는 항목을 시간순으로 보여 주는 목록입니다. 이 항목을 할 일 아이템 이라고 합니다.

할 일 목록을 사용하면 GitLab에서 수행하는 업무와 관련된 조치를 추적할 수 있습니다. 다른 사용자가 연락하거나 확인이 필요한 상황이 생기면 할 일 아이템이 할 일 목록에 표시됩니다.

할 일 목록 접근#

할 일 목록에 접근하려면 다음을 수행합니다.

오른쪽 위 모서리에서 To-do items ([task-done])를 선택합니다.

할 일 목록 필터링#

할 일 목록을 필터링하려면 다음 단계를 따릅니다.

1. 목록 위의 텍스트 상자에 커서를 놓습니다.
2. 미리 정의된 필터 중 하나를 선택합니다.
3. Enter를 누릅니다.

할 일 목록 정렬#

할 일 목록을 정렬하려면 다음 단계를 따릅니다.

1. To Do 탭의 오른쪽 위 모서리에서 다음 옵션 중 하나를 선택합니다.

   • Recommended: 생성 날짜와 이전 스누즈 날짜를 조합해 정렬하며, 이전에 스누즈한 항목이 위에 표시됩니다.
   • Updated: 항목이 가장 최근에 업데이트된 날짜순으로 정렬합니다.
   • Label priority: 설정한 우선순위에 따라 정렬합니다.

2. 선택 사항. 정렬 방향을 선택합니다.

할 일 아이템을 만드는 액션#

많은 할 일 아이템이 자동으로 생성됩니다. 할 일 목록에 할 일 아이템을 추가하는 액션에는 다음이 있습니다.

• 이슈나 머지 리퀘스트가 본인에게 할당됩니다.
• 머지 리퀘스트 리뷰가 요청됩니다.
• 이슈, 머지 리퀘스트, 에픽의 설명이나 댓글에서 본인이 언급됩니다.
• 커밋이나 디자인의 댓글에서 본인이 언급됩니다.
• 본인의 머지 리퀘스트에 대한 CI/CD 파이프라인이 실패합니다.
• 열린 머지 리퀘스트가 충돌로 병합되지 않으며, 다음 중 하나에 해당합니다.
  • 본인이 작성자입니다.
  • 본인이 파이프라인 성공 후 자동으로 병합되도록 머지 리퀘스트를 설정한 사용자입니다.
• 머지 리퀘스트가 머지 트레인에서 제거되었고, 본인이 이를 추가한 사용자입니다.
• 본인이 소유한 그룹이나 프로젝트에 멤버 액세스 요청이 제기됩니다.

GitLab 17.8 이상에서는 같은 이슈나 머지 리퀘스트 안에서도 누군가 본인을 언급할 때마다 새 할 일 알림을 받습니다.

할당이나 리뷰 요청처럼 할 일 아이템을 만드는 그 밖의 액션은 같은 이슈나 머지 리퀘스트에서 여러 번 발생하더라도 액션 유형당 알림을 한 번만 받습니다.

할 일 아이템은 GitLab 알림 이메일 설정의 영향을 받지 않습니다. 다만 알림 설정이 Custom 이고 Merge request you're eligible to approve is created를 선택한 경우에는, 머지 리퀘스트를 승인할 자격이 생길 때 할 일 아이템을 받습니다.

할 일 아이템 만들기#

할 일 목록에 항목을 직접 추가할 수 있습니다.

1. 다음 중 하나로 이동합니다.

   • 이슈
   • 머지 리퀘스트
   • 에픽
   • 디자인
   • 인시던트
   • 목표 또는 핵심 결과
   • 작업

2. 오른쪽 위 모서리에서 Add a to-do item ([todo-add])을 선택합니다.

누군가를 언급하여 할 일 아이템 만들기#

코드 블록을 제외한 어디에서든 누군가를 언급해 할 일 아이템을 만들 수 있습니다. 한 메시지에서 같은 사용자를 여러 번 언급해도 할 일 아이템은 하나만 생성됩니다.

예를 들어 다음 댓글에서는 frank를 제외한 모두에게 할 일 아이템이 생성됩니다.

@alice What do you think? cc: @bob

- @carol can you please have a look?

> @dan what do you think?

Hey @erin, this is what they said:

```
Hi, please message @frank :incoming_envelope:
```

할 일 아이템을 완료로 표시하는 액션#

할 일 아이템의 대상 객체(이슈, 머지 리퀘스트, 에픽 등)에 대한 여러 액션은 해당 할 일 아이템을 완료로 표시합니다.

다음을 수행하면 할 일 아이템이 완료로 표시됩니다.

• 설명이나 댓글에 이모지 반응을 추가합니다.
• 레이블을 추가하거나 제거합니다.
• 담당자를 변경합니다.
• 마일스톤을 변경합니다.
• 할 일 아이템의 대상 객체를 닫습니다.
• 댓글을 작성합니다.
• 설명을 편집합니다.
• 디자인 토론 스레드를 해결합니다.
• 프로젝트 또는 그룹 멤버십 요청을 수락하거나 거부합니다.

다음을 수행해도 할 일 아이템은 완료로 표시되지 않습니다.

• 연결된 항목(연결된 이슈 등)을 추가합니다.
• 하위 항목(하위 에픽이나 작업 등)을 추가합니다.
• 시간 추적을 추가합니다.
• 본인을 담당자로 지정합니다.
• 이슈의 상태(health status)를 변경합니다.

다른 사용자가 이슈나 에픽을 닫거나 조치하더라도 본인의 할 일 아이템은 대기 상태로 남습니다.

머지 리퀘스트가 병합되거나 닫히면, 담당자로 지정되었거나 리뷰어 또는 승인자로 추가되었거나 승인이 필요했던 모든 사용자의 할 일 아이템이 완료로 표시됩니다. 여기에는 실패한 파이프라인과 관련된 할 일 아이템도 포함됩니다.

할 일 아이템을 완료로 표시#

할 일 아이템을 직접 완료로 표시할 수 있습니다.

방법은 두 가지입니다.

• 할 일 목록에서 할 일 아이템 오른쪽의 Mark as done (✓)을 선택합니다.
• 해당 리소스(예: 이슈나 머지 리퀘스트)의 오른쪽 위 모서리에서 Mark as done ([todo-done])을 선택합니다.

완료된 할 일 아이템 다시 추가#

실수로 할 일 아이템을 완료로 표시했다면 Done 탭에서 다시 추가할 수 있습니다.

1. 오른쪽 위 모서리에서 To-do items ([task-done])를 선택합니다.
2. 상단에서 Done을 선택합니다.
3. 다시 추가할 할 일 아이템을 찾습니다.
4. 해당 할 일 아이템 옆에서 Undo [redo] 를 선택합니다.

이제 해당 할 일 아이템이 할 일 목록의 To Do 탭에 표시됩니다.

할 일 아이템 스누즈#

할 일 아이템을 스누즈하면 기본 할 일 목록에서 잠시 숨길 수 있습니다. 더 급한 작업에 집중한 뒤 스누즈한 항목으로 돌아올 수 있습니다.

할 일 아이템을 스누즈하려면 다음 단계를 따릅니다.

1. 할 일 목록에서 스누즈할 할 일 아이템 옆의 Snooze ([clock])를 선택합니다.
2. 특정 날짜와 시각까지 할 일 아이템을 스누즈하려면 Until a specific time and date 옵션을 선택합니다. 그 밖의 경우에는 미리 정의된 스누즈 기간 중 하나를 선택합니다.
   • 1시간 동안
   • 오늘 이후까지(4시간 후)
   • 내일까지(현지 시각 기준 내일 오전 8시)

스누즈한 할 일 아이템은 기본 할 일 목록에서 제외되고 별도의 Snoozed 탭에 표시됩니다.

스누즈 기간이 끝나면 해당 할 일 아이템이 기본 할 일 목록으로 자동으로 돌아옵니다. 이때 원래 생성된 시점을 나타내는 표시가 함께 나타납니다.

스누즈된 할 일 아이템 보기#

스누즈한 할 일 아이템을 보거나 관리하려면 다음 단계를 따릅니다.

1. 할 일 목록으로 이동합니다.
2. 목록 상단에서 Snoozed 탭을 선택합니다.

Snoozed 탭에서는 다음을 수행할 수 있습니다.

• 스누즈한 할 일이 기본 목록으로 돌아올 예정 시점을 확인합니다.
• 스누즈를 해제해 항목을 기본 할 일 목록으로 즉시 되돌립니다.
• 스누즈한 할 일을 완료로 표시합니다.

할 일 아이템 일괄 편집#

할 일 아이템은 다음과 같이 일괄 편집할 수 있습니다.

• To Do 탭: 할 일 아이템을 완료로 표시하거나 스누즈합니다.
• Snoozed 탭: 할 일 아이템을 완료로 표시하거나 제거합니다.
• Done 탭: 할 일 아이템을 복원합니다.

할 일 아이템을 일괄 편집하려면 다음 단계를 따릅니다.

1. 할 일 목록에서 다음을 수행합니다.
   • 개별 항목을 선택하려면 편집할 각 항목 왼쪽의 체크박스를 선택합니다.
   • 페이지의 모든 항목을 선택하려면 왼쪽 위 모서리에서 Select all 체크박스를 선택합니다.
2. 오른쪽 위 모서리에서 원하는 액션을 선택합니다.

접근 권한이 변경되면 사용자의 할 일 목록에 미치는 영향#

보안상의 이유로 GitLab은 사용자가 관련 리소스에 더 이상 접근할 수 없게 되면 할 일 아이템을 삭제합니다. 예를 들어 사용자가 이슈, 머지 리퀘스트, 에픽, 프로젝트, 그룹에 더 이상 접근할 수 없으면 GitLab은 관련 할 일 아이템을 삭제합니다.

이 처리는 접근 권한이 변경된 후 한 시간 이내에 이루어집니다. 사용자의 접근 권한이 실수로 철회된 경우의 데이터 손실을 막기 위해 삭제를 지연합니다.

관련 주제#

• 이슈
• 머지 리퀘스트
• 에픽
• 디자인
• 인시던트
• 목표 또는 핵심 결과
• 작업