Python QA 자동화
결과 계약
- 이 스킬을 비즈니스 요구사항이 명확해진 후의 QA 내부 루프로 취급합니다.
- 호출당 하나의 즉시 전달 가능한 결과물을 완료합니다. 설계에서 구현, 통합 또는 오류 수정으로 자동으로 넘어가지 않습니다.
- API와 UI를 별도의 모드로 유지합니다. UI 모드에서는 UI 시나리오와 관련된 설정, 정리 또는 사후 조건 확인에만 API를 사용합니다.
- 증거와 함께
Clarified,Ready,Verified게이트를 통과합니다. 스킬을 호출했다는 사실만으로 완료 증거가 되지 않습니다.
사전 점검
references/common-rules.md를 읽습니다.<skill-dir>을 이SKILL.md가 포함된 디렉토리로 확인하고, 번들 스크립트는 대상 프로젝트 디렉토리가 아닌 해당 디렉토리에서 실행합니다.- 대상 프로젝트 루트를 식별하고, 편집 전에 해당 프로젝트의 지침, 매니페스트, 관련 테스트,
git status를 읽습니다. - 원자료, 예상 결과, 환경 경계, 데이터 소유권, 검증 방법을 식별합니다. 코드를 생성하는 경로에는 명령어가 필요합니다.
- 예상 결과를 찾거나 확인할 수 없는 경우, 테스트 설계 단계에서 중단하고 시나리오를 탐색적/수동으로 표시하며 단정문을 임의로 만들지 않습니다.
경로 선택
사용자의 즉시 요청 결과에 따라 정확히 하나의 전달 경로를 선택합니다. 원자료와 API/UI 모드를 경로에 대한 입력으로 취급하며, 추가 경로로 취급하지 않습니다.
| 경로 | 즉시 전달 결과물이 다음과 같은 경우 사용 | 필수 참고자료 | 완료 조건 |
|---|---|---|---|
test-design | 코드 없는 적용 범위 매트릭스 또는 자동화 권장사항 | references/test-design.md | 예상 결과, 계층, 우선순위, 데이터, 자동화 결정이 명시적임 |
new-project | 비어 있거나 새로운 대상에 실행 가능한 최소 pytest 스캐폴드 | 선택한 모드 가이드 | 스캐폴드가 유효하고 하나의 의미 있는 스모크 테스트가 수집되거나 실행됨 |
existing-project | 기존 저장소에서 가장 작은 호환 가능한 테스트 변경 | references/existing-project.md + 선택한 모드 가이드 | 프로젝트 규칙이 유지되고 영향을 받는 검증이 통과함 |
delivery-integration | CI, Jenkins, 보고서, 릴리스 게이트 또는 성능 스모크 | references/delivery-integrations.md | 요청된 통합이 추가되고 로컬에서 확인 가능한 부분이 검증됨 |
failure-analysis | 실패한 테스트의 증거 기반 분류 또는 수리 | references/failure-analysis.md | 근본 원인이 뒷받침되거나 다음 누락된 탐색 단계가 명명됨 |
하나의 작업에 요구사항, 기존 저장소, UI 흐름이 포함되어 있다고 해서 경로를 결합하지 마십시오. 예를 들어, 기존 Playwright 프로젝트에 체크아웃 적용 범위를 추가하는 것은 ui 모드의 existing-project입니다. 테스트 포인트가 아직 승인되지 않은 경우 test-design.md를 지원 지침으로 로드합니다.
필요 시 모드 선택
test-design의 경우, 매트릭스가 가장 낮은 신뢰할 수 있는 계층을 선택하도록 합니다. 해당 결정 전에 API 또는 UI를 강제하지 않습니다.- 엔드포인트 동작, 계약, 인증, 검증, 상태, 통합에는
api를 선택합니다.references/api-mode.md를 읽습니다. - 브라우저 동작, 클라이언트 검증, 레이아웃 종속 상호작용, 중요 사용자 여정에는
ui를 선택합니다.references/ui-mode.md를 읽습니다. - 전달 전용 작업이나 기존 프로젝트와 증거가 이미 스택을 결정하는 실패 분석에는 모드를 요구하지 않습니다.
- 요청된 전달 결과물이 병렬 API 및 UI 스위트를 생성하는 경우, 사용자에게 하나를 선택하도록 요청합니다. UI 설정/정리 API 호출은 병렬 API 스위트로 간주하지 않습니다.
조건부 참고자료 로드
- 요구사항, 사용자 스토리, 버그 티켓, 릴리스 범위, 스크린샷 또는 테스트 포인트가 승인되지 않은 변경에는
references/test-design.md를 읽습니다. - 로그인, 생성/수정/삭제, 업로드, 시드 데이터, 설정/정리, 서버 측 상태 확인에는
references/test-data.md를 읽습니다. - 간헐적 실패, 타이밍, 대기, 재시도, 폴링, 동적 UI, 병렬 간섭에는
references/flaky-diagnosis.md를 읽습니다. - 스키마, 계약, 호환성, 권한, 역할, 테넌트, 소유권, 오류 코드 적용 범위에는
references/api-contracts.md를 읽습니다. - Appium/모바일, 시각적 회귀, 다중 탭/창, 다운로드, 업로드, 대화상자, iframe, 복잡한 브라우저 상태에는
references/advanced-ui.md를 읽습니다.
게이트 및 프로젝트 자산
다음 게이트를 순서대로 통과합니다.
- Clarified: 출처, 소유자 또는 권한, 예상 결과, 범위, 비범위가 명시적입니다.
- Ready: 경로, 필요 시 모드, 코드 생성 작업의 대상 파일, 데이터/정리 경계, 환경 안전성, 검증 방법이 명시적입니다.
- Verified: 코드 생성 경로가 대상 명령어와 관련 회귀 테스트를 실행했습니다. 설계 전용 경로는 모든 예상 결과를 승인된 출처에 매핑합니다. 모든 검증되지 않은 부분과 그 이유를 명시합니다.
대상 프로젝트에 TEST_PLAN.md가 있거나 해당 지침에서 이를 요구하는 경우, 적용 범위를 선택하기 전에 읽고, 구현 전에 활성 시나리오를 In Progress로 설정하고, 검증 후에만 Automated로 표시합니다. 사용자 또는 프로젝트 규칙에서 요구하지 않는 한, TEST_PLAN.md를 사용하지 않는 프로젝트에 도입하지 마십시오.
선택한 경로 실행
existing-project의 경우, 편집 전에 저장소를 검사하고 보고된 파일을 읽습니다.- 선택한 경로, 모드, 즉시 전달 결과물, 대상 파일, 명시적 비범위를 명시합니다.
- 예상 동작이 아직 승인되지 않은 경우, 코드보다 먼저 테스트 포인트를 생성하거나 확인합니다.
- 선택한 경로를 완료하는 가장 작은 변경을 수행합니다. 기존 프로젝트 구조를 유지하고 인접한 백로그 작업을 피합니다.
- 먼저 좁은 대상 검증을 실행한 다음, 관련 회귀 명령어를 실행합니다.
- 해당 게이트를 통과한 후에만 프로젝트 테스트 계획 상태를 업데이트합니다.
- 선택한 경로의 완료 조건에서 중단하고 핸드오프를 반환합니다. 다른 스킬이나 경로를 자동으로 호출하지 않습니다.
test-design의 경우, 자동화 코드를 편집하지 않습니다. failure-analysis의 경우, 요청된 결과가 진단 전용일 때 편집하지 않습니다. 사용자가 수정을 요청하고 증거가 근본 원인을 뒷받침하는 경우에만 수리합니다.
번들 도구
<skill-dir>을 이 스킬의 절대 디렉토리로 바꿉니다.
기존 프로젝트 검사:
python "<skill-dir>/scripts/inspect_project.py" "<project-dir>"
새롭거나 빈 대상에만 스캐폴드:
python "<skill-dir>/scripts/scaffold.py" --mode api --out "<output-dir>" --project-name "<name>"
python "<skill-dir>/scripts/scaffold.py" --mode ui --out "<output-dir>" --project-name "<name>"
스캐폴드는 기존 파일을 덮어쓰지 않습니다. 사용자가 생성된 파일을 교체하도록 명시적으로 요청하지 않는 한 --force를 사용하지 마십시오.
생성되거나 편집된 Python/TOML 검증:
python "<skill-dir>/scripts/validate_generated.py" "<project-dir>"
python "<skill-dir>/scripts/validate_generated.py" "<project-dir>" --collect
기존 프로젝트의 기본 검증으로 대상 프로젝트 자체의 테스트 명령어를 사용합니다. 검증 상태가 partial이면 검증되지 않은 것으로 간주합니다. 수집이 통과했다고 주장하기 전에 대상 프로젝트 환경에 종속성을 설치합니다. UI 실행의 경우, 필요한 Playwright 브라우저가 설치되었는지 확인합니다.
핸드오프
다음을 보고합니다.
- 선택한 경로 및 모드;
- 요구사항 출처 및 오라클로 사용된 예상 결과;
- 변경된 파일 및 해당되는 경우
TEST_PLAN.md상태; - 검증 명령어와 정확한 통과, 실패, 부분 통과, 또는 건너뜀 결과;
- 검증되지 않은 작업, 남은 위험, 다른 경로가 필요한 경우 다음 결정.
비범위
- 기본적으로 하이브리드 API+UI 프레임워크를 구축하지 않습니다.
- UI 모드에서는 광범위한 API 엔드포인트 적용 범위를 추가하지 않습니다. API 호출은 UI 시나리오와 관련된 설정, 정리 또는 사후 조건 확인에만 사용됩니다.
- 기본적으로 CI, Jenkins, Allure, Appium, 데스크톱 자동화, 시각적 회귀 테스트, 성능 테스트를 추가하지 않습니다. 명시적으로 요청되고 범위가 지정된 경우에만 추가합니다.
.env를 만들지 않고, 자격 증명을 저장하지 않으며, 프로덕션 시스템을 호출하지 않고, 실제 토큰을 만들지 않습니다.- 생성된 테스트 프로젝트 내에 LLM API 종속성을 추가하지 않습니다. 호스트 에이전트가 추론 및 수리를 수행합니다.