make-backlog-comment - SKILL.md Agent Skill

name: make-backlog-comment description: Backlog 이슈에 PR 주소와 변경사항 요약 코멘트를 한국어로 남기는 스킬. 현재 브랜치의 PR 정보를 분석하여 3줄 요약을 자동 생성하고 Backlog API로 코멘트를 등록한다. 트리거 - "backlog 코멘트", "백로그 코멘트", "코멘트 남겨", "PR 코멘트 backlog", "이슈에 코멘트", "make-backlog-comment" 등. PR을 올린 후 Backlog 이슈에 작업 내용을 기록하고 싶을 때, 또는 이슈 키를 지정하여 코멘트를 남기고 싶을 때 사용한다. 일본어 병기가 필요하면 make-backlog-comment-jp 스킬을 대신 사용한다.

Make Backlog Comment

Backlog 이슈에 PR 주소와 변경사항 요약 코멘트를 한국어로 남긴다.

사용법

/make-backlog-comment CONTENTSHUB-1234

인자가 없으면 현재 브랜치의 PR 제목에서 이슈 키를 자동 추출한다.

워크플로우

1. Backlog 설정 로드

CONFIG="/Users/casper/.config/santaclaude/backlog/config.json"
SPACE_KEY=$(jq -r '.spaceKey' "$CONFIG")
DOMAIN=$(jq -r '.domain' "$CONFIG")
API_KEY=$(jq -r '.apiKey' "$CONFIG")

apiKey가 비어있으면 중단하고 /backlog 스킬로 설정하라고 안내한다.

2. 이슈 키 결정

인자로 전달된 경우: 그대로 사용 (예: CONTENTSHUB-1234)
인자 없는 경우: gh pr view --json title --jq '.title'에서 [CONTENTSHUB-XXXX] 패턴 추출

3. PR 정보 수집

gh pr view --json url,title,body --jq '{url, title, body}'

4. 코멘트 작성

PR의 변경사항을 분석하여 한국어 3줄 요약을 작성한다.

코멘트 형식:

PR: {PR URL}

- {변경사항 요약 1}
- {변경사항 요약 2}
- {변경사항 요약 3}

5. Backlog API 호출 및 결과 파싱

주의: Backlog API 응답의 content 필드에 raw 개행 문자가 포함되어 jq와 python3 json.loads가 파싱에 실패한다. 응답에서 Comment ID만 필요하므로 grep -o로 추출한다.

RESULT=$(curl -s -X POST "https://${SPACE_KEY}.${DOMAIN}/api/v2/issues/${ISSUE_KEY}/comments?apiKey=${API_KEY}" \
  --data-urlencode "content=${COMMENT}")

COMMENT_ID=$(echo "$RESULT" | grep -o '"id":[0-9]*' | head -1 | grep -o '[0-9]*')

COMMENT_ID가 비어있으면 API 호출 실패 — $RESULT 원문을 출력하여 에러 원인을 안내한다.
성공 시 코멘트 ID와 이슈 키를 출력한다.