atlassian

aydenden's avatarfrom aydenden

Jira 이슈 조회, 생성, 편집, 상태 변경, 댓글 관리 등 Atlassian CLI를 활용한 Jira 작업 수행. 사용자가 Jira, 이슈, 티켓, SF-, PROJ- 같은 이슈 키, JQL, 스프린트, 보드를 언급할 때 사용.

⭐1stars🔀1forks📁View on GitHub🕐Updated Dec 17, 2025
[Project Management]

When & Why to Use This Skill

This Claude skill provides a robust integration with the official Atlassian CLI (ACLI) to automate Jira project management tasks directly within the chat interface. It enables users to query, create, and edit Jira issues, manage comments, and handle status transitions using JQL (Jira Query Language). By centralizing issue tracking and workflow management, it streamlines developer productivity and ensures real-time project synchronization without the need to switch between multiple tools.

Use Cases

  • Efficient Issue Tracking: Quickly view detailed ticket information or search for specific issues using JQL to stay updated on project progress and team workloads.
  • Automated Workflow Management: Create new tasks or bugs with specific metadata and transition issue statuses (e.g., 'In Progress' to 'Done') to maintain an accurate and up-to-date project board.
  • Batch Operations and Updates: Perform bulk edits on multiple issues or add common comments across various tickets simultaneously, significantly reducing manual administrative overhead.
  • Seamless Team Collaboration: Manage assignees and communicate through Jira comments directly from the agent, facilitating faster feedback loops and better documentation within the development lifecycle.
nameatlassian
description>

Atlassian CLI Integration

공식 Atlassian CLI (ACLI)를 사용하여 Jira를 관리합니다.

⚠️ 주의: ACLI v1.3.5는 Jira만 지원합니다. Confluence는 지원되지 않습니다.

빠른 시작

인증 확인

acli jira auth status

인증이 필요한 경우:

acli jira auth login --web

상세한 인증 방법은 authentication.md 참고

핵심 명령어

이슈 조회

# 이슈 상세 보기 (모든 필드)
acli jira workitem view SF-946 --fields "*all"

# 특정 필드만 조회
acli jira workitem view SF-946 --fields "summary,status,assignee,description"

# 웹 브라우저에서 열기
acli jira workitem view SF-946 --web

이슈 검색 (JQL)

# 프로젝트의 모든 이슈
acli jira workitem search --jql "project = SF"

# 현재 사용자에게 할당된 미완료 이슈
acli jira workitem search --jql "assignee = currentUser() AND status != Done"

# JSON 출력
acli jira workitem search --jql "project = SF" --json

이슈 생성

# 기본 생성
acli jira workitem create \
  --project "SF" \
  --type "Task" \
  --summary "새로운 작업"

# 상세 정보 포함
acli jira workitem create \
  --project "SF" \
  --type "Bug" \
  --summary "버그 제목" \
  --description "상세 설명" \
  --assignee "@me"

이슈 편집

# 요약 변경
acli jira workitem edit --key "SF-946" --summary "새로운 요약"

# 담당자 변경
acli jira workitem edit --key "SF-946" --assignee "@me"

# 여러 이슈 일괄 편집
acli jira workitem edit --key "SF-1,SF-2,SF-3" --assignee "@me"

상태 변경

# 단일 이슈
acli jira workitem transition --key "SF-946" --status "In Progress"

# 여러 이슈
acli jira workitem transition --key "SF-1,SF-2" --status "Done"

댓글 관리

# 댓글 조회
acli jira workitem comment list --key "SF-946"

# 댓글 추가
acli jira workitem comment create --key "SF-946" --body "댓글 내용"

# 여러 이슈에 댓글 추가
acli jira workitem comment create --jql "project = SF" --body "공통 댓글"

자주 사용하는 패턴

내 작업 조회

acli jira workitem search --jql "assignee = currentUser() AND status != Done"

할당되지 않은 이슈 조회

acli jira workitem search --jql "project = SF AND assignee is EMPTY"

CSV로 내보내기

acli jira workitem search --jql "project = SF" --csv > issues.csv

유용한 옵션

--json          # JSON 출력
--csv           # CSV 출력 (search만)
--yes           # 확인 없이 실행
--web           # 웹 브라우저에서 열기

추가 문서

  • reference.md - 전체 명령어 레퍼런스 (프로젝트, 보드, 스프린트, 필드, 관리자 등)
  • examples.md - JQL 예제, 배치 작업, 실전 사례
  • authentication.md - 설치 및 인증 가이드

문제 해결

인증 문제:

acli jira auth status
acli jira auth login --web

연결 테스트:

acli jira project list --limit 1

도움말:

acli jira workitem --help

참고 링크