jira-workflow Skill | Agent Skills

jira-workflow

Jira 티켓을 올바르게 작성하고, 자동화 규칙이 정상 동작하도록 안내하는 스킬입니다. 중점과제는 테크스팩 수준의 상세 디스크립션을, 운영과제는 간결한 디스크립션을 자동 생성합니다.

언제 사용하나요?

Jira 티켓(Epic/Task/Subtask)을 새로 만들 때
티켓 제목 형식이나 계층 구조가 맞는지 검토할 때
자동화가 동작하지 않는 원인을 파악할 때
Subtask를 일괄 생성하거나 제목 목록을 만들어야 할 때

전제 조건

Atlassian MCP 연결: Jira 티켓 조회/생성을 위해 필요
대상 프로젝트 코드베이스 접근: 중점과제 테크스팩 생성 시, 대상 프로젝트의 디렉토리 구조와 기존 코드를 탐색하여 파일 경로 기반의 기술적 접근 방식을 작성합니다. 코드베이스에 접근할 수 없는 경우 컴포넌트/모듈명 수준으로 작성합니다.

MCP 에러 대응

| 에러 상황 | 동작 | |-----------|------| | MCP 서버 미연결 | "Atlassian MCP 연결을 확인해주세요." 안내 후 중단 | | 티켓 조회 실패 (404) | "티켓을 찾을 수 없습니다. 키를 확인해주세요." | | 권한 없음 (403) | 디스크립션·Subtask 목록을 텍스트로 출력 (읽기 전용 모드) | | 생성 실패 (서버 오류) | 생성된 내용을 텍스트로 출력하고 수동 생성 안내 |

API 호출 실패 시 최대 1회 자동 재시도합니다. 재시도 후에도 실패하면 사용자에게 안내하고 수동 처리를 유도합니다.

파라미터

| 파라미터 | 설명 | 출처 | |----------|------|------| | {{projectName}} | 상위 Epic의 프로젝트명 | Epic 제목에서 자동 추출 | | {{serviceName}} | 작업 대상 서비스명 | Epic 또는 PROD 티켓에서 자동 판단, 불명확 시 사용자 선택 |

{{projectName}}은 상위 Epic 제목 앞 태그에서 추출합니다. Epic 제목이 [상담톡] 채팅 기능 개발이면 {{projectName}} = 상담톡

{{serviceName}}은 상위 Epic 티켓 또는 Epic 하위 PROD 티켓의 내용을 참고하여 작업 범위를 판단합니다. 작업 범위를 판단하기 어려운 경우, 임의로 입력하지 않고 references/service-names.md의 사용자 선택지 형식으로 선택지를 제공합니다.

참조 파일

| 파일 | 설명 | |------|------| | references/ticket-structure.md | 티켓 계층 구조, Task·Subtask 제목 규칙 | | references/automation-rules.md | Jira 자동화 규칙 전체 목록 | | references/service-names.md | 유효한 서비스명 목록 | | references/classify-issue-type.md | 운영과제/중점과제 판별 기준 | | references/build-description.md | Task 디스크립션 작성 기준 | | references/generate-subtasks.md | Subtask 목록 생성 기준 | | templates/task-description-ops.md | 운영과제 Task 디스크립션 템플릿 + 예시 | | templates/task-description-key.md | 중점과제 Task 디스크립션 템플릿 + 예시 | | templates/subtask-list.md | Subtask 목록 출력 템플릿 + 예시 |

입력 검증

실행 순서 진입 전, 사용자가 제공한 Epic 정보를 검증합니다.

| 상황 | 동작 | |------|------| | Epic 키가 유효하지 않음 (조회 실패) | "Epic {키}를 찾을 수 없습니다. 올바른 Epic 키를 입력해주세요." | | Epic이 아닌 이슈 타입 (Task, Subtask 등) | "{키}는 {이슈타입}입니다. 상위 Epic 키를 입력해주세요." | | 대상 프로젝트가 FE가 아닌 경우 | "입력한 Epic은 {프로젝트} 보드 소속입니다. FE 보드 Task를 생성하려면 FE 프로젝트의 Epic을 입력해주세요." |

실행 순서

references/ticket-structure.md 로 제목 형식 확인
Task 중복 확인 (references/build-description.md "공통: 중복 확인" 참조)
- 존재하면 → 업데이트 플로우 (diff 표시 → 사용자 확인)
- 없으면 → 신규 생성 진행
references/classify-issue-type.md 로 과제 유형 판별
references/build-description.md 로 디스크립션 작성 기준 확인
유형에 맞는 템플릿으로 디스크립션 작성
- 중점과제: 코드베이스 탐색 후 templates/task-description-key.md 형식으로 테크스팩 수준 자동 생성
- 운영/내부과제: templates/task-description-ops.md 형식으로 간결하게 작성
디스크립션을 사용자에게 출력 → 확인("이 내용으로 Task를 생성할까요?") 후 Jira API로 Task 생성
references/generate-subtasks.md 로 Subtask 목록 생성 → templates/subtask-list.md 형식으로 출력
사용자 확인("이대로 Subtask를 생성할까요?") 후 Jira API로 Subtask 생성

확인 단계에서 취소 시

각 확인 단계에서 사용자가 거부한 경우:

| 단계 | 취소 시 동작 | |------|-------------| | Task 업데이트 확인 (2단계) | 기존 Task 유지, 스킬 종료 | | Task 생성 확인 (6단계) | 디스크립션 수정 요청을 받거나, 스킬 종료 | | Subtask 생성 확인 (8단계) | Subtask 목록 수정 요청을 받거나, Subtask 생성만 건너뛰기 |

부분 실패(예: 5개 Subtask 중 3개 생성 후 API 에러) 시, templates/subtask-list.md의 "부분 실패 시 출력 형식"에 따라 결과를 안내하고 재시도 여부를 확인합니다.

Agent Skills: jira-workflow

Install this agent skill to your local

Skill Files