git-qa

name	git-qa
description	배포 대상 PR 목록에서 관련 이슈를 수집하고 repo별 QA 체크리스트를 생성합니다. QA 체크리스트, qa checklist, 배포 QA, deploy QA 시 사용합니다.

개요

배포 전 통합테스트를 체계적으로 수행하기 위해, 배포 대상 PR 목록에서 관련 이슈를 수집하고 repo별 QA 체크리스트를 생성합니다.

관련 skill

• git-pr (참고): PR 정보 수집 시 PR 메시지 구조를 참고합니다.

참조 문서

• 공통 규칙: .ai/10_rules/context-loading.md — 있으면 따르며, 이미 적재되어 있으면 재로딩하지 않습니다.
• 스킬 고유 추가 참조:
  • .ai/40_domain/index.md — 관련 도메인 spec·policy가 있으면 해당 기준을 테스트 항목에 반영 (index 먼저 → 관련 파일만 선택적으로)
  • .ai/30_contract/index.md — 외부 API 제공이 QA 대상에 포함되면 계약을 테스트 항목 기준으로 활용 (index 먼저 → 관련 파일만 선택적으로)

---

실행 조건

사용자가 배포 대상 PR 링크 목록을 제공하면 이 절차를 수행합니다.

필수 입력

• PR 링크 목록: 배포 대상 PR URL을 1개 이상 제공 (여러 repo에 걸쳐도 무관)

선택 입력

• QA repo 링크: QA 이슈를 생성할 대상 저장소 URL
• QA 이슈 링크: 내용을 채워 넣을 기존 QA 이슈 URL
• 배포 예정일: 미지정 시 오늘 날짜를 사용

---

분석 절차

1단계: PR 정보 수집

제공된 PR 링크를 순회하며 아래 정보를 수집합니다.

• PR 제목, 상태(merged 여부), 대상 브랜치
• PR body에서 연결된 이슈 링크 추출 (closes, fixes, resolves 키워드 또는 #이슈번호 참조)
• PR에 포함된 변경 파일 목록과 diff 요약

2단계: repo별 그룹화

수집한 PR을 repo 단위로 그룹화합니다.

repo-A
├── PR #10 → Issue #5, Issue #6
└── PR #12 → Issue #8

repo-B
└── PR #33 → Issue #21

3단계: 이슈별 변경 요약

각 이슈에 대해 아래 내용을 정리합니다.

• 이슈 제목 및 링크
• 변경 요약: 비즈니스 관점에서 무엇이 변경되었는지 1~2문장으로 기재
• 영향 범위: 변경이 영향을 미치는 주요 영역 (API, UI, DB, 배치 등)

4단계: 통합테스트 체크리스트 생성

이슈별 변경 내용을 기반으로 테스트 항목을 추론하여 체크리스트를 작성합니다. .ai/40_domain/index.md를 참고하여 관련 도메인 spec·policy가 있으면 해당 기준을 테스트 항목에 반영하여 정확도를 높입니다. 외부 API 제공이 QA 대상에 포함되면 .ai/30_contract/index.md를 참고하여 계약(응답 형식·상태 코드 등)을 검증 항목으로 반영합니다.

테스트 유형 예시:

• 웹 화면 확인: 해당 페이지 접속 후 정상 렌더링 스크린샷 첨부
• API 응답 확인: 엔드포인트 호출 후 응답 값 캡처
• DB 결과 확인: 변경된 테이블/컬럼의 데이터 조회 결과 캡처
• 스토리지 확인: 파일 업로드·다운로드 결과물 캡처
• 배치/이벤트 확인: 작업 실행 로그 또는 이벤트 발행 결과 캡처
• 회귀 확인: 기존 기능이 영향받지 않는지 주요 시나리오 재검증

각 항목은 체크박스(- [ ]) 형태로 작성하며, 검증 방법을 구체적으로 명시합니다.

---

결과 출력

아래 우선순위에 따라 출력 방식을 결정합니다.

우선순위 1: GitHub 이슈 생성

QA repo 링크가 제공된 경우, gh issue create 명령으로 QA 이슈를 직접 생성합니다.

• 이슈 제목: YYYY-MM-DD 배포 QA
• 이슈 본문: 아래 템플릿 구조를 따름

우선순위 2: 기존 QA 이슈에 내용 작성

QA 이슈 링크가 제공된 경우, 해당 이슈의 body를 아래 템플릿 구조로 업데이트합니다.

우선순위 3: 로컬 파일 생성 (기본값)

위 두 입력이 모두 없는 경우, .ai/99_workspace/qa_checklist_YYYY-MM-DD.md에 파일을 생성합니다.

---

출력 템플릿

## 배포 대상 요약

| Repo | PR | 관련 이슈 |
|------|----|-----------|
| repo-A | #10 | #5, #6 |
| repo-A | #12 | #8 |
| repo-B | #33 | #21 |

---

## repo-A

### Issue #5 - [이슈 제목]
- **변경 요약:**
  - ...
- **영향 범위:**
  - API
  - DB

#### 테스트 체크리스트
- [ ] `POST /api/orders` 호출 후 201 응답 확인 — 응답 body 캡처
- [ ] `orders` 테이블에 신규 레코드 생성 확인 — 쿼리 결과 캡처

### Issue #6 - [이슈 제목]
- **변경 요약:**
  - ...
- **영향 범위:**
  - 웹 UI

#### 테스트 체크리스트
- [ ] 주문 목록 페이지 접속 후 정상 렌더링 확인 — 스크린샷 첨부
- [ ] 신규 필터 옵션 동작 확인 — 필터 적용 전후 스크린샷 첨부

### Issue #8 - [이슈 제목]
...

---

## repo-B

### Issue #21 - [이슈 제목]
...

---

## 비고
<!-- 배포 관련 특이사항, 의존성 순서, 환경 설정 변경 등 -->

---

실행 후 안내

결과 생성 후 사용자에게 아래 내용을 안내합니다.

• 출력 위치 (이슈 URL 또는 파일 경로)
• 테스트 체크리스트는 AI가 변경 내용을 기반으로 추론한 것이므로, 필요 시 항목을 추가·수정·삭제할 것을 권고