jira-task-pr

name	jira-task-pr
description	Create a pull request for a Jira task and link it back to the issue. Triggers: jira-task pr, create PR; PR 만들어, PR 등록.
user-invocable	false
argument-hint	<TASK-ID>
allowed-tools	["Read","Bash","Glob","Grep"]

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

Language Rule: 프로젝트 CLAUDE.md의 Conventions 섹션 참고 (한국어 출력, Jira 코멘트 제목은 영어).

Prerequisites

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

Workflow

Jira 호출은 python3 "<scripts>/jira-cli.py" … (규약: skills/_shared/jira-cli.md). 호출 prompt가 <scripts>/ 절대 경로를 줬으면 그대로 쓰고, 없으면 skills/_shared/script-lookup.md로 SCRIPT_NAME="jira-cli.py" 1회 해석.

Step 1: Gather Context

1. .jira-context.json에서 활성 태스크 정보 읽기
2. Cache-first: .jira-context.json의 cachedIssue 확인 (CLAUDE.md "Issue Cache" 참고). hit이면 호출 생략 후 캐시된 description/issuetype을 PR 본문 생성에 사용. miss이면 python3 "<scripts>/jira-cli.py" get <TASK-ID> 호출 (압축 JSON의 summary/status/description/issuetype/labels — PR 본문 생성에 필요한 항목만) 후 cache 갱신.
3. Jira 호스트 URL 추출: python3 "<scripts>/jira-cli.py" config show의 url(예: https://company.atlassian.net)을 Jira 이슈 링크 생성에 사용. 예: https://company.atlassian.net/browse/<TASK-ID>. 없으면 JIRA_URL 환경변수를 fallback으로 사용.
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

산출물 작성 전 반드시 Read tool로 templates/pr-description.template.md를 읽고 contract(필수/옵셔널 분류, 옵셔널 마커 규약)를 따른다.

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

PR Body: template의 섹션 구조를 따라 Jira 이슈 정보(description, type, priority, acceptance criteria), git diff --stat, 테스트 리포트 요약을 채워 넣는다.

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

PR 링크 코멘트를 scratchpad md 파일로 쓰고 python3 "<scripts>/jira-cli.py" comment <TASK-ID> @<파일>로 Jira에 게시:

## Pull Request Created

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

<PR 설명 요약>

Step 6: Transition Issue (Optional)

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

python3 "<scripts>/jira-cli.py" transitions <TASK-ID>            # 전환 목록 조회
python3 "<scripts>/jira-cli.py" transition <TASK-ID> "In Review"  # {"key","status"} — status가 실제 결과

코멘트는 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 → approach → impl → test → review → merge → **pr ✓** → done

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