# Test Standardization Engine

> 프로젝트 전반의 단위 테스트 및 E2E 테스트 과정을 표준화합니다. 테스트 시나리오 추출, 하이브리드 방식의 테스트 코드 작성, 영구적인 테스트 리포트 생성을 관리하여 테스트 품질과 일관성을 보장합니다.

- Skill: `lsw417/test-standardization-engine` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add lsw417/test-standardization-engine`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lsw417/test-standardization-engine/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: lsw417 (https://skillmd.com/u/lsw417)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/lsw417/test-standardization-engine

---


# Test Standardization Engine

다양한 프로젝트 환경에서도 일관된 테스트 품질을 유지하기 위한 표준 프레임워크입니다. 테스트 시나리오 도출부터 코드 작성, 결과 보고까지의 전 과정을 정규화하여 에이전트와 개발자 간의 신뢰를 구축합니다.

## 핵심 가치
- **Review-First**: 코드를 짜기 전 테스트 시나리오를 먼저 승인받아 의도하지 않은 테스트 누락을 방지합니다.
- **Consistency**: AAA 패턴과 프로젝트 내 'Golden Example'을 결합하여 이질감 없는 테스트 코드를 작성합니다.
- **Permanence**: 모든 테스트 결과를 `docs/test-reports/`에 영구 문서화하여 히스토리를 관리합니다.

## 수행 프로세스 (3-Phase Workflow)

### Phase 1: 지능형 시나리오 추출 및 승인 (TC Extraction)
테스트 코드를 작성하기 전, 반드시 소스코드와 요구사항을 분석하여 테스트 케이스(TC) 목록을 작성합니다.
1.  **추출**: Happy Path, 경계값, 에러 핸들링, 분기 커버리지를 고려하여 TC 매트릭스를 도출합니다.
2.  **승인**: 도출된 리스트를 `references/tc_matrix_template.md` 형식을 참고하여 사용자에게 제시하고 **명시적인 승인**을 받습니다.

### Phase 2: 하이브리드 테스트 코드 작성 (Implementation)
승인된 TC를 바탕으로 코드를 구현합니다.
1.  **AAA 패턴**: Arrange, Act, Assert 구조를 엄격히 준수합니다.
2.  **참조(Reference) 활용**: 프로젝트 내 기존 테스트 코드(`tests/`, `__tests__/` 등)를 분석하여 모킹 라이브러리 사용법, 네이밍 규칙을 그대로 따릅니다.

### Phase 3: 표준 리포트 생성 및 저장 (Reporting)
테스트 수행 후 결과를 자산화합니다.
1.  **파일 저장**: `docs/test-reports/YYYY-MM-DD_[FeatureName]_report.md` 경로에 저장합니다.
2.  **분석 포함**: 실패 시 단순 로그 출력이 아닌, `references/test_report_template.md`를 참고하여 **심층 원인 분석 및 수정 제안**을 리포트에 포함합니다.

## 활용 가이드
- "이 기능을 위한 단위 테스트를 표준 절차에 따라 만들어줘"라고 요청하세요.
- 에이전트는 먼저 시나리오 리스트를 보여줄 것입니다. 확인 후 "진행해"라고 답하면 코드를 작성합니다.
- 테스트 완료 후 생성된 리포트 파일을 확인하여 변경 사항이나 실패 원인을 파악하세요.

## 참조 템플릿
- [테스트 시나리오 매트릭스 템플릿](references/tc_matrix_template.md)
- [표준 테스트 리포트 템플릿](references/test_report_template.md)