git-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 먼저 → 관련 파일만 선택적으로)
  • .ai/10_rules/writing-principles.md·.ai/10_rules/writing-principles-local.md — 있으면 산출물 작성 원칙으로 참조 (충돌 시 local 우선; 없으면 본문의 "산출물 접기 기준"이 기본값)

---

실행 조건

사용자가 배포 대상 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 이슈를 직접 생성합니다.