jira-task-clean

name	jira-task-clean
description	Clean up git worktrees and branches for completed Jira tasks. Triggers: jira-task clean, remove worktree; 워크트리 정리, 브랜치 정리.
user-invocable	false
argument-hint	<TASK-ID> [TASK-ID ...] | --all | --list
allowed-tools	["Read","Bash"]

jira-task-clean: Worktree & Branch Cleanup

Language Rule: 프로젝트 CLAUDE.md의 Conventions 섹션 참고 (한국어 출력).

Overview

완료된 Jira 태스크의 worktree와 branch를 일괄 정리한다. scripts/clean-worktree.py 스크립트를 실행하여 처리.

반드시 메인 레포(main 브랜치)에서 실행해야 한다. worktree 안에서 실행하면 자기 자신을 삭제할 수 없어 실패한다. worktree 세션에서 요청받은 경우, 세션을 종료하고 메인 레포에서 다시 실행하라고 안내한다.

Script Location

이 스킬은 플러그인 내장 스크립트를 사용한다. 스크립트 경로를 찾는 방법:

# 1) CLAUDE_PLUGIN_ROOT가 있으면 (스킬 실행 컨텍스트의 정확한 버전) 그것을 사용
# 2) 없으면 cwd 기준 직접 설치 경로
# 3) 그래도 없으면 캐시에서 최신 semver 버전 선택 (sort -V | tail -1)
SCRIPT=""
if [ -n "$CLAUDE_PLUGIN_ROOT" ] && [ -f "$CLAUDE_PLUGIN_ROOT/scripts/clean-worktree.py" ]; then
  SCRIPT="$CLAUDE_PLUGIN_ROOT/scripts/clean-worktree.py"
elif [ -f "scripts/clean-worktree.py" ]; then
  SCRIPT="scripts/clean-worktree.py"
else
  SCRIPT=$(find ~/.claude/plugins -path "*/jira-integration/*/scripts/clean-worktree.py" 2>/dev/null | sort -V | tail -1)
fi
[ -z "$SCRIPT" ] && { echo "clean-worktree.py를 찾을 수 없습니다." >&2; exit 1; }

중요: 절대 find ... | head -1로 잡지 말 것 — 파일시스템 순서로 가장 오래된 캐시 버전을 잡아서 stale 스크립트가 실행되는 사고가 있었음.

Workflow

Case 1: clean <TASK-ID> [TASK-ID ...]

특정 태스크의 worktree와 branch를 정리한다.

python3 "$SCRIPT" <TASK-ID> [TASK-ID ...]

주의: 사용자에게 정리 대상을 확인한 후 실행한다. --dry-run으로 먼저 보여주고 확인 후 실행:

# 1. 먼저 dry-run으로 대상 확인
python3 "$SCRIPT" --dry-run <TASK-ID>

# 2. 사용자 확인 후 실제 실행
python3 "$SCRIPT" <TASK-ID>

Case 2: clean --all

병합/완료된 모든 worktree를 일괄 정리한다.

# dry-run으로 먼저 확인
python3 "$SCRIPT" --all --dry-run

# 사용자 확인 후 실제 실행
python3 "$SCRIPT" --all

Case 3: clean --list

현재 worktree 목록과 상태를 표시한다.

python3 "$SCRIPT" --list

Completion Summary

---
🧹 **Worktree Cleanup Complete**

- 정리된 태스크: <TASK-ID list>
- 삭제된 worktree: <count>개
- 삭제된 branch: <count>개
- MCP config 정리: <count>개
---