choiminyeong
5e5ef8c36f
소스(Core/Shell/Launcher)와 실행 PC가 받아갈 업데이트 파일(dist)을 함께 올린다. Launcher가 켤 때 이 저장소의 dist와 D:\UbisamPlatform\bin을 비교해 새 버전이면 받아간다. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
46 lines
2.3 KiB
Markdown
46 lines
2.3 KiB
Markdown
---
|
|
name: qa
|
|
description: "테스트 계획과 실제 구현 코드를 대조해 통합 정합성을 검증하는 feature-pipeline 4단계. '구현 다 했어 QA 해줘', '품질 검증해줘' 요청이나 QA 실패 후 재검증 요청에 사용."
|
|
---
|
|
|
|
# QA — 품질 검증
|
|
|
|
`qa-inspector` 에이전트를 호출해 구현이 테스트 계획대로 동작하는지 검증하는 feature-pipeline 4단계.
|
|
|
|
## 실행 모드: 서브 에이전트
|
|
|
|
## 워크플로우
|
|
|
|
### 1. feature-slug 확인 + 선행 조건 확인
|
|
- `_workspace/{slug}/03_test_plan.md`가 없으면 진행하지 않고 `plan-eng-review` 먼저 완료할 것을 안내한다.
|
|
- 사용자에게 구현이 완료되었는지 확인한다(구현 중인데 QA를 호출하면 결과가 무의미하므로).
|
|
|
|
### 2. 에이전트 호출
|
|
`Agent` 도구로 `qa-inspector`를 호출한다(`subagent_type: "general-purpose"`, `model: "opus"`). 입력: `03_test_plan.md` 경로 + 변경된 코드(git diff 또는 사용자가 지정한 경로). 출력: `_workspace/{slug}/04_qa_report.md`.
|
|
|
|
### 3. 상태 갱신
|
|
- `pipeline_state.json`의 `stages.qa.status`를 `completed`로, `result`를 결론(통과/조건부 통과/실패)으로, `completed_at`을 갱신한다.
|
|
- `plan/{slug}/progress.md` 액션 로그에 행 추가. **결론이 통과/조건부 통과일 때만** 체크리스트 4번 항목을 체크한다.
|
|
|
|
### 4. 안내
|
|
- 결론이 **통과/조건부 통과**이면 다음 단계 `review` 안내.
|
|
- 결론이 **실패**이면 발견된 결함 목록을 요약해 전달하고, 수정 후 다시 `/qa`를 호출할 것을 안내한다.
|
|
|
|
## 에러 핸들링
|
|
- 빌드 도구가 없는 환경이면 에이전트가 정적 검토로 대체하고 보고서에 한계를 명시하도록 지시한다.
|
|
- 실물 자원(하드웨어, 외부 서비스 등)이 필요한 테스트 케이스는 "미검증"으로 남기고 임의로 통과 처리하지 않는다.
|
|
|
|
## 테스트 시나리오
|
|
|
|
### 정상 흐름
|
|
1. 사용자: "구현 다 했어, QA 해줘"
|
|
2. `03_test_plan.md` 존재 확인, 구현 완료 여부 확인
|
|
3. `qa-inspector` 호출 → 결론 "통과"
|
|
4. 상태/진행 로그 갱신, 체크박스 체크
|
|
5. `review` 안내
|
|
|
|
### 에러 흐름
|
|
1. QA 결론이 "실패", 결함 2건 발견
|
|
2. 결함 목록 전달, 사용자가 수정
|
|
3. 사용자가 다시 `/qa` 호출 → 재검증
|