상담 신청
홈 › 작업 노트 › 기획·QA › Jira 이슈 하나에 들어가는 항목

기획·QA · 도구 다루기

Jira 이슈 하나에 들어가는 항목

빌드에서 상점 구매 버튼이 두 번 눌리는 문제를 찾았다고 해 봅시다. 메신저로 "구매 버튼 이상해요"라고 보내면 하루 뒤에는 아무도 기억하지 못합니다. Jira 이슈 한 건은 이 발견을 누가 언제 어떤 상태로 처리하는지 끝까지 추적하게 해 주는 기록 단위입니다.

작업 노트 601 · 읽는 시간 약 5분 · 2026.11.17 정리

이슈 화면의 칸들이 각각 답하는 질문

Jira 이슈의 칸은 저마다 하나의 질문에 답합니다. 요약은 무엇이 문제인지, 이슈 유형은 버그인지 작업인지, 우선순위는 얼마나 급한지를 말합니다. 영향 버전은 어느 빌드에서 나타났는지, 환경은 어떤 기기와 운영체제에서 봤는지를 적는 칸입니다. 칸 이름보다 이 질문을 기억해 두면 처음 보는 프로젝트 화면에서도 무엇을 채워야 할지 헷갈리지 않습니다.

설명 칸은 재현 절차와 기대 결과, 실제 결과가 들어가는 본문입니다. 담당자는 지금 이 이슈를 처리할 사람, 보고자는 이슈를 등록한 사람으로 자동 기록됩니다. 컴포넌트와 레이블은 UI, 전투, 결제처럼 영역을 묶어 나중에 모아 보게 해 줍니다. 수정 버전은 보통 QA가 아니라 개발 쪽에서 언제 고칠지 정하며 채우는 경우가 많습니다.

팀마다 심각도, 재현율, 빌드 번호 같은 칸을 따로 만들어 쓰기도 합니다. Jira는 관리자가 필드를 추가할 수 있어서 회사마다 화면이 조금씩 다릅니다. 최근 클라우드 버전 안내 문서에서는 이슈를 업무 항목이라고 부르기도 하니, 이름이 달라도 같은 기능으로 보면 됩니다. 입사 후 첫 주에는 팀의 이슈 작성 규칙 문서부터 읽어 두세요.

요약 한 줄을 먼저 쓰는 이유

이슈 목록 화면에는 대개 요약 한 줄만 보입니다. 개발자나 QA 리드는 수십 건이 쌓인 목록에서 요약만 보고 자기 일인지 판단합니다. 그래서 요약에는 위치, 행동, 결과가 함께 들어가야 합니다. "상점 버그"보다 "상점 - 구매 버튼 연속 터치 시 재화가 두 번 차감됨"처럼 쓰면 열어 보기 전에 내용이 짐작됩니다.

많은 팀이 요약 앞에 대괄호로 영역을 붙이는 규칙을 둡니다. 예를 들어 [상점], [튜토리얼], [보스전]처럼 앞머리를 맞추면 목록을 정렬했을 때 같은 영역끼리 모입니다. 규칙이 정해져 있다면 그대로 따르고, 없다면 처음 한 달 동안 본인이 쓴 요약들을 다시 읽으며 형식이 일정한지 확인해 보세요.

요약에 감정이나 추측은 넣지 않습니다. "구매 버튼이 완전히 망가짐", "서버 문제로 보임" 같은 표현은 판단을 흐립니다. 원인을 추측했다면 설명 칸 아래에 참고 의견으로 따로 적습니다. 요약은 관찰한 사실만 담고, 길이는 목록에서 잘리지 않을 정도로 한 문장 안에서 끝내는 것이 좋습니다.

게임QA 과정에서 만드는 결과물 예시
게임QA 과정에서 만드는 결과물 예시

설명 칸을 채우는 순서

  1. 사전 조건: 계정 상태, 보유 재화, 진행 단계처럼 재현 전에 맞춰 둘 것
  2. 재현 절차: 1부터 번호를 붙여 한 줄에 한 동작
  3. 기대 결과: 기획 문서 기준으로 일어나야 하는 일
  4. 실제 결과: 화면에서 실제로 본 일, 숫자 변화 포함
  5. 재현율과 참고: 10번 중 몇 번 나타났는지, 다른 기기 결과

이 순서를 지키면 읽는 사람이 위에서 아래로 따라 하기만 해도 같은 화면에 도착합니다. 절차는 "상점에 들어간다"가 아니라 "로비 하단 상점 아이콘을 누른다"처럼 손가락이 어디로 가는지까지 적습니다. 기대 결과와 실제 결과를 나란히 두면 어디서 어긋났는지 한눈에 보여, 개발자가 확인 질문을 다시 보내는 일이 줄어듭니다.

설명이 길어진다면 버그 두 개를 한 이슈에 넣은 것은 아닌지 확인합니다. 구매 시 재화가 두 번 빠지는 문제와 구매 완료 팝업 글자가 잘리는 문제는 원인도 담당자도 다를 수 있습니다. 한 이슈에는 한 문제만 담아야 하나가 고쳐졌을 때 상태를 정확히 바꿀 수 있고, 나머지가 묻히지 않습니다.

환경, 버전, 첨부를 빠뜨리면 생기는 일

환경 칸이 비어 있으면 개발자는 자기 PC에서 재현을 시도하다가 "재현 안 됨"으로 돌려보낼 수 있습니다. 모바일이라면 기기 모델, 운영체제 버전, 네트워크 종류를 적고, PC라면 해상도와 그래픽 설정도 적어 둡니다. 같은 문제가 특정 기기에서만 나타난다면 그 사실 자체가 원인을 좁히는 가장 강한 단서가 됩니다.

영향 버전에는 문제를 본 빌드를 정확히 고릅니다. 이전 빌드에서는 괜찮았다면 그 빌드 번호도 설명에 남깁니다. 언제부터 생겼는지 알면 개발자는 그 사이에 바뀐 코드만 살펴보면 되어 수정이 빨라집니다. 테스트를 시작할 때 빌드 번호를 메모장 맨 위에 적어 두는 습관이 이 칸을 정확하게 채우는 가장 쉬운 방법입니다.

첨부에는 문제 순간이 보이는 스크린샷이나 짧은 녹화, 필요하면 로그 파일을 올립니다. 화면에 재화 숫자가 보이도록 찍고, 녹화는 문제 직전 몇 초부터 담는 편이 좋습니다. 파일 이름에 빌드 번호와 날짜를 넣어 두면 나중에 여러 이슈의 첨부를 비교할 때 헷갈리지 않습니다.

게임QA 수업에서 다루는 작업 예시
게임QA 수업에서 다루는 작업 예시

처음 이슈를 쓸 때 자주 하는 실수와 점검

가장 흔한 실수는 중복 등록입니다. 같은 문제가 이미 올라와 있는데 새 이슈를 만들면 개발자가 두 건을 따로 확인하느라 시간을 씁니다. 등록 전에 검색창에 화면 이름과 핵심 단어를 넣어 기존 이슈를 찾아보고, 이미 있다면 새로 쓰는 대신 그 이슈에 내 환경과 재현 결과를 댓글로 덧붙입니다.

두 번째 실수는 우선순위를 모든 이슈에 높게 거는 것입니다. 우선순위는 팀 기준표에 맞춰 고르고, 진행 불가나 재화 손실처럼 기준이 분명한 경우에만 높게 둡니다. 확신이 없으면 기본값으로 두고 설명에 영향 범위를 적어 리드가 판단하게 하는 편이 낫습니다. 저장한 뒤에는 미리보기에서 번호 목록과 첨부가 제대로 보이는지 다시 확인합니다.

SBS아카데미게임학원 게임QA 과정에서는 Jira와 Redmine으로 실제 게임 빌드의 이슈를 등록하고 관리하는 실습을 합니다. 혼자 써 본 이슈가 실무 형식에 맞는지 궁금하다면, 직접 쓴 이슈 한 건을 가지고 무료 상담에서 첨삭 방향을 함께 확인해 보세요.

자주 묻는 질문

Jira 계정이 없으면 연습을 어떻게 하나요?

개인 사용 조건은 Atlassian 공식 사이트에서 직접 확인하는 것이 정확합니다. 계정이 없어도 요약, 환경, 재현 절차, 기대·실제 결과 칸을 엑셀 표로 만들어 써 보는 것만으로 형식 연습은 충분합니다.

이슈를 등록한 뒤 QA가 할 일은 끝인가요?

개발자가 수정했다고 상태를 바꾸면 QA가 새 빌드에서 다시 확인하고 이슈를 닫습니다. 고쳐지지 않았다면 다시 열고 확인한 빌드 번호를 댓글로 남깁니다.

확인한 자료

외부 기관의 기준과 안내는 바뀔 수 있으니 최신 내용은 해당 기관에서 확인해 주세요.

게임QA 수업 예시
이 글과 이어지는 과정게임QA 과정 안내

수업 순서, 목표별 결과물, 가까운 센터를 한 페이지에서 볼 수 있습니다.

과정 보기 →

함께 읽으면 좋은 노트

무료 상담 신청

읽은 글과 관련해 궁금한 점이나 지금 상황을 남기면 담당자가 연락드립니다.

상담·컨설팅 무료 · 전화 상담 010-2135-9730

전화상담 신청