원클릭으로 Manus에서 모든 스킬 실행

시작하기

test-guide

스타0

포크2

업데이트2026년 2월 26일 05:42

pytest/Vitest 파일 구조, 커버리지 목표(75%+), fixture 패턴, RAGAS 평가 테스트를 안내합니다. 테스트 작성, 테스트 구조 설계, 커버리지 개선 시 사용합니다.

설치

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

Manus에서 실행

출처

SKNETWORKS-FAMILY-AICAMP

SKNETWORKS-FAMILY-AICAMP/SKN20-FINAL-6TEAM

GitHub 저장소 열기 Creator 저장소 보기

다운로드

Manus에서 실행

Test Guide (Bizi Project)

테스트 디렉토리 구조

backend/tests/
├── conftest.py       # 공통 fixture
├── unit/             # 단위 테스트
├── integration/      # 통합 테스트
└── e2e/              # E2E 테스트

rag/tests/
├── conftest.py
├── unit/
├── integration/
└── evaluation/       # RAGAS 평가 테스트

커버리지 목표

대상	목표
비즈니스 로직	≥80%
API 엔드포인트	≥70%
전체	≥75%
훅/유틸리티 (TS)	≥80%
컴포넌트 (TS)	≥60%

Python 테스트 명명 규칙

def test_<function_name>_<scenario>_<expected_result>():
    pass

# 예시
def test_create_user_with_valid_data_returns_user(): pass
def test_create_user_with_duplicate_email_raises_error(): pass

Mock 패턴 (외부 의존성)

from unittest.mock import patch

@patch("apps.auth.service.send_email")
def test_register_sends_welcome_email(mock_send_email):
    mock_send_email.return_value = True
    result = register_user(email="new@example.com")
    mock_send_email.assert_called_once()
    assert result.email == "new@example.com"

TypeScript (Vitest + React Testing Library)

describe('Button', () => {
  it('should call onClick when clicked', () => {
    const handleClick = vi.fn();
    render(<Button label="Click me" onClick={handleClick} />);
    fireEvent.click(screen.getByRole('button'));
    expect(handleClick).toHaveBeenCalledTimes(1);
  });
});

테스트 파일 위치: 컴포넌트와 동일 디렉토리 (Button.test.tsx)
셀렉터 우선순위: getByRole > getByTestId > getByText

RAG 평가 (RAGAS)

# rag/tests/evaluation/test_rag_quality.py
def test_rag_answer_quality():
    results = evaluate_rag(test_cases)
    assert results["faithfulness"] >= 0.8
    assert results["answer_relevancy"] >= 0.7

메트릭	목표	설명
Faithfulness	≥0.8	답변이 컨텍스트에 충실
Answer Relevancy	≥0.7	답변이 질문에 관련
Context Precision	≥0.7	검색 컨텍스트 정확도
Context Recall	≥0.7	필요 컨텍스트 검색 여부

TDD 워크플로우

RED — 실패하는 테스트 먼저 작성 → [test] add failing test for ...
GREEN — 통과하는 최소 코드 작성 → [feat] implement ...
REFACTOR — 품질 개선 (테스트 계속 통과) → [refactor] extract ...

실행 명령어

# Python
pytest --cov=apps --cov-report=html
pytest --cov=apps --cov-fail-under=75
pytest -m "not slow"

# TypeScript
npm run test
npm run test:coverage

pytest fixture/코드 생성 템플릿은 pytest-suite skill 참조

이 저장소의 다른 Skills

같은 저장소

code-patterns

SKNETWORKS-FAMILY-AICAMP/SKN20-FINAL-6TEAM

SQLAlchemy 2.0 쿼리, FastAPI 라우터/서비스 분리, Zustand 스토어, LangChain 에이전트 구현 패턴을 안내합니다. 백엔드 API 코드, 프론트엔드 상태관리, RAG 에이전트 작성 시 사용합니다.

2026-02-260

implement

SKNETWORKS-FAMILY-AICAMP/SKN20-FINAL-6TEAM

계획 파일을 읽고 즉시 코드를 구현합니다. 계획 모드 없이 파일별로 변경사항을 적용합니다.

2026-02-070

fastapi-endpoint

SKNETWORKS-FAMILY-AICAMP/SKN20-FINAL-6TEAM

FastAPI 엔드포인트 보일러플레이트를 생성합니다. 라우터, 서비스, 스키마를 포함합니다.

2026-01-310

pytest-suite

SKNETWORKS-FAMILY-AICAMP/SKN20-FINAL-6TEAM

Python 모듈의 pytest 테스트 스위트를 생성합니다. TDD 패턴을 따르는 테스트 코드를 작성합니다.

2026-01-310

rag-agent

SKNETWORKS-FAMILY-AICAMP/SKN20-FINAL-6TEAM

새 RAG 에이전트 클래스를 생성합니다. BaseAgent를 상속하고 벡터 컬렉션을 연결합니다.

2026-01-310

react-component

SKNETWORKS-FAMILY-AICAMP/SKN20-FINAL-6TEAM

React 컴포넌트와 테스트 코드를 생성합니다. TypeScript, TailwindCSS, Vitest를 사용합니다.

2026-01-310

name	test-guide
description	pytest/Vitest 파일 구조, 커버리지 목표(75%+), fixture 패턴, RAGAS 평가 테스트를 안내합니다. 테스트 작성, 테스트 구조 설계, 커버리지 개선 시 사용합니다.
user-invocable	false

Test Guide (Bizi Project)

테스트 디렉토리 구조

backend/tests/
├── conftest.py       # 공통 fixture
├── unit/             # 단위 테스트
├── integration/      # 통합 테스트
└── e2e/              # E2E 테스트

rag/tests/
├── conftest.py
├── unit/
├── integration/
└── evaluation/       # RAGAS 평가 테스트

커버리지 목표

대상	목표
비즈니스 로직	≥80%
API 엔드포인트	≥70%
전체	≥75%
훅/유틸리티 (TS)	≥80%
컴포넌트 (TS)	≥60%

Python 테스트 명명 규칙

def test_<function_name>_<scenario>_<expected_result>():
    pass

# 예시
def test_create_user_with_valid_data_returns_user(): pass
def test_create_user_with_duplicate_email_raises_error(): pass

Mock 패턴 (외부 의존성)

from unittest.mock import patch

@patch("apps.auth.service.send_email")
def test_register_sends_welcome_email(mock_send_email):
    mock_send_email.return_value = True
    result = register_user(email="new@example.com")
    mock_send_email.assert_called_once()
    assert result.email == "new@example.com"

TypeScript (Vitest + React Testing Library)

describe('Button', () => {
  it('should call onClick when clicked', () => {
    const handleClick = vi.fn();
    render(<Button label="Click me" onClick={handleClick} />);
    fireEvent.click(screen.getByRole('button'));
    expect(handleClick).toHaveBeenCalledTimes(1);
  });
});

테스트 파일 위치: 컴포넌트와 동일 디렉토리 (Button.test.tsx)
셀렉터 우선순위: getByRole > getByTestId > getByText

RAG 평가 (RAGAS)

# rag/tests/evaluation/test_rag_quality.py
def test_rag_answer_quality():
    results = evaluate_rag(test_cases)
    assert results["faithfulness"] >= 0.8
    assert results["answer_relevancy"] >= 0.7

메트릭	목표	설명
Faithfulness	≥0.8	답변이 컨텍스트에 충실
Answer Relevancy	≥0.7	답변이 질문에 관련
Context Precision	≥0.7	검색 컨텍스트 정확도
Context Recall	≥0.7	필요 컨텍스트 검색 여부

TDD 워크플로우

RED — 실패하는 테스트 먼저 작성 → [test] add failing test for ...
GREEN — 통과하는 최소 코드 작성 → [feat] implement ...
REFACTOR — 품질 개선 (테스트 계속 통과) → [refactor] extract ...

실행 명령어

# Python
pytest --cov=apps --cov-report=html
pytest --cov=apps --cov-fail-under=75
pytest -m "not slow"

# TypeScript
npm run test
npm run test:coverage

pytest fixture/코드 생성 템플릿은 pytest-suite skill 참조