# Git Qa

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

- **Type:** Skill
- **Install:** `agentstack add skill-scroogy-dev-scroogy-agent-skills-git-qa`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [scroogy-dev](https://agentstack.voostack.com/s/scroogy-dev)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [scroogy-dev](https://github.com/scroogy-dev)
- **Source:** https://github.com/scroogy-dev/scroogy-agent-skills/tree/main/git-qa

## Install

```sh
agentstack add skill-scroogy-dev-scroogy-agent-skills-git-qa
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

## 개요

배포 전 통합테스트를 체계적으로 수행하기 위해, 배포 대상 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`에 파일을 생성합니다.

---

## 출력 템플릿

```markdown
## 배포 대상 요약

| 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가 변경 내용을 기반으로 추론한 것이므로, 필요 시 항목을 추가·수정·삭제할 것을 권고

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [scroogy-dev](https://github.com/scroogy-dev)
- **Source:** [scroogy-dev/scroogy-agent-skills](https://github.com/scroogy-dev/scroogy-agent-skills)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-scroogy-dev-scroogy-agent-skills-git-qa
- Seller: https://agentstack.voostack.com/s/scroogy-dev
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.