jira-task-pr

jira-task-pr: Create Pull Request for Jira Task

Language Rule

모든 출력을 한국어로 작성한다: 사용자 응답, 생성 문서, Jira 코멘트 내용 등 모든 텍스트가 대상이다. 예외: 코드, 변수명, 브랜치명, 파일명, 명령어는 영어를 유지한다. Jira 코멘트: 섹션 제목(##, ###)은 영어로, 내용(설명·요약·노트)은 한국어로 작성한다.

Prerequisites

• 메인 레포에서 실행: worktree가 아닌 원본 레포 디렉토리에서 실행해야 함
• jira-local-merge가 먼저 완료되어야 함 (feature 브랜치가 로컬 base에 병합된 상태)
• gh CLI 설치 및 인증됨 (gh auth status로 확인)
• Feature branch feature/<TASK-ID>에 커밋이 있어야 함
• Remote에 push 되어 있어야 함

Workflow

Step 1: Gather Context

1. .jira-context.json에서 활성 태스크 정보 읽기
2. mcp__atlassian__jira_get_issue로 이슈 상세 조회
3. Jira 호스트 URL 추출: get-issue 응답의 self 필드(예: https://company.atlassian.net/rest/api/...)에서 호스트 부분을 추출하여 Jira 이슈 링크 생성에 사용. 예: https://company.atlassian.net/browse/<TASK-ID>
4. Base branch 확인:

   git rev-parse --abbrev-ref HEAD  # 현재 브랜치 확인
   

Step 2: Verify Prerequisites

# gh CLI 확인
gh auth status

# 커밋 확인
git log --oneline <base-branch>..feature/<TASK-ID>

# Remote push 상태 확인
git status -sb

Push가 안 되어 있으면:

git push -u origin feature/<TASK-ID>

Step 3: Generate PR Content

PR Title: <TASK-ID>: <Jira 이슈 summary>

PR Body (Jira 이슈 정보 기반으로 생성):

## Summary
<Jira 이슈 description 요약>

## Jira Issue
- **Key**: [<TASK-ID>](<Jira host URL extracted from Step 1>/browse/<TASK-ID>)
- **Type**: <issue type>
- **Priority**: <priority>

## Changes
<git diff --stat 기반 변경 파일 요약>

### Key Changes
- <주요 변경사항 1>
- <주요 변경사항 2>

## Acceptance Criteria
- [ ] <Jira 이슈의 acceptance criteria 1>
- [ ] <Jira 이슈의 acceptance criteria 2>

## Test Plan
<테스트 리포트가 있으면 docs/test/<TASK-ID>.test-report.md 요약>
<없으면 수동 테스트 체크리스트>

## Screenshots
<해당하는 경우>

Step 4: Create PR

gh pr create \
  --title "<TASK-ID>: <summary>" \
  --body "<generated body>" \
  --base <base-branch> \
  --head feature/<TASK-ID>

PR URL을 캡처.

선택적 옵션 (사용자에게 확인):

• --reviewer <reviewer> : 리뷰어 지정
• --label <label> : 라벨 추가
• --assignee @me : 본인 할당
• --draft : Draft PR로 생성

Step 5: Post PR Link to Jira

mcp__atlassian__jira_add_comment로 Jira에 PR 링크 게시:

## Pull Request Created

**PR**: <PR URL>
**브랜치**: feature/<TASK-ID> → <base-branch>
**변경 파일 수**: <count>개

<PR 설명 요약>

Step 6: Transition Issue (Optional)

사용자에게 확인 후 이슈 상태를 "In Review"로 전환:

먼저 mcp__atlassian__jira_get_transitions으로 전환 목록 조회 후
mcp__atlassian__jira_transition_issue with transitionId: <In Review transition ID>

주의: jira_transition_issue에 comment 파라미터를 절대 사용하지 말 것. comment 필드는 ADF JSON을 요구하므로 일반 텍스트를 넣으면 오류가 발생한다. 코멘트는 별도로 jira_add_comment를 호출하여 추가한다.

Step 7: Completion Summary

.jira-context.json의 completedSteps에 "pr" 추가 후, 아래 형식으로 완료 요약 출력:

---
✅ **PR Created** — <TASK-ID>

- PR URL: <PR URL>
- Title: <TASK-ID>: <summary>
- Base: <base-branch> ← feature/<TASK-ID>
- Files: <count> changed
- Jira 코멘트 게시됨

**Progress**: init → start → plan → design → impl → test → review → merge → **pr ✓** → done

**Next**: PR 머지 후 `/jira-task done <TASK-ID>` — 태스크를 완료 처리합니다
---