tomevault-io QA Swarm Skill
개요
에이전트팀을 활용하여 여러 유형의 QA를 병렬로 동시 실행한다. 각 QA 영역의 전문 팀원이 동시에 작업하여 전체 QA 소요 시간을 단축한다.
적용 기준
- 사용: 대규모 프로젝트 (테스트 스위트가 다양), 새 프로젝트의 QA 단계, 릴리즈 전 종합 검증
- 미사용: 단위 테스트만 있는 소규모 프로젝트 → 기존 /test 스킬 사용
프로세스
1. 프로젝트 분석
$ARGUMENTS에서 프로젝트 경로/대상을 파악한다. 프로젝트 루트의 설정 파일(package.json, Cargo.toml, pyproject.toml, go.mod, Makefile 등)을 읽어 사용 가능한 테스트/린트/빌드/감사 도구를 감지한다.
2. QA팀 생성 및 태스크 동적 배정
TeamCreate("qa-team")
감지된 도구에 따라 아래 4개 카테고리 중 해당하는 것만 태스크로 생성한다:
| 카테고리 | 팀원 이름 | 역할 |
|---|---|---|
| 단위/통합 테스트 | qa-tester | 테스트 프레임워크 감지 → 전체 테스트 실행 → 실패 시 에러/스택 트레이스 보고 |
| 린트/정적 분석 | qa-linter | 프로젝트 린터 전체 실행 → 자동 수정 적용 → 수동 수정 항목 보고 |
| 빌드 검증 | qa-builder | 빌드 명령 실행 → 컴파일/타입 에러, 경고 보고 |
| 보안 스캔 | qa-security | 패키지 매니저 감사 도구 실행 → 취약점 심각도별 분류 보고 |
각 카테고리에 대해 동일 패턴으로 태스크 생성 및 팀원 스폰:
# 감지된 각 카테고리에 대해 반복:
TaskCreate({
subject: "<카테고리명>",
description: "<위 표의 역할 설명>",
activeForm: "<카테고리명> 실행 중"
})
Task(team_name="qa-team", name="<팀원 이름>"):
"<카테고리명>을 실행하세요. 프로젝트 경로: [경로].
결과는 실제 명령어의 exit code로 판단하세요.
완료 후 TaskUpdate로 결과를 보고하세요."
3. 결과 종합
모든 태스크가 completed 상태가 되면:
- 각 팀원의 결과를 수집
- 실패 항목을 심각도별로 분류
- 자동 수정이 적용된 항목 정리
- 수동 수정이 필요한 항목 목록 생성
4. 정리
SendMessage(type="shutdown_request")로 모든 팀원 종료
TeamDelete()
검증 규칙
빌드/테스트 결과는 실제 명령어의 exit code로만 판단한다. 텍스트 보고("통과했습니다")를 신뢰하지 않는다. TaskCompleted 훅(task-quality-gate.sh)이 구현 태스크의 빌드/테스트를 자동 검증한다.
출력
@output-template.md 참조
Orchestrator 통합
Orchestrator가 새 프로젝트 또는 대규모 변경의 QA 단계에서 qa-swarm을 선택할 수 있다:
- 테스트 스위트가 다양한 프로젝트 →
Skill("qa-swarm", "<프로젝트 경로>") - 단순 프로젝트 →
Skill("test", "<전체 또는 변경된 모듈>")
비용 주의
최대 4개의 별도 Claude 인스턴스를 스폰하므로, 단일 테스트 대비 최대 4배의 토큰을 사용한다. 테스트 스위트가 하나뿐인 프로젝트에는 기존 /test 스킬을 사용하라.
Converted and distributed by TomeVault — claim your Tome and manage your conversions.