평가 스위트 부트스트랩 (evals-bootstrap)
에이전트의 실제 실패 사례를 모아 trace 기반 행동 검증 테스트 스위트와 실행 러너를 처음부터 만들어 줍니다.
개발·코딩중급★ 815⑂ 128AI 점수 9/10마지막 업데이트: 2026. 9. 29.
무엇을 해주나
- 에이전트 로그·트랜스크립트를 읽어 실제로 발생한 실패를 최대 20건 수집하고, 4~8개의 행동 패턴으로 묶어 줍니다.
- 각 실패를
cases.yaml의 케이스로 변환합니다.input, 사람이 읽는expect, 그리고 실제 테스트가 되는check규칙(trace has X,trace has X before Y,trace lacks X)을 만듭니다. - trace 저장 구조(
traces/<id>.json)가 없으면 로깅 연결부터 잡아 줍니다. - 의존성이 거의 없는(
pyyaml만) 러너check_traces.py를 생성하고, 실패 시 non-zero로 종료해 CI 게이트로 쓸 수 있게 합니다. - 마지막에 "매주 새 trace 확인 → 실패를 케이스로 추가 → 가장 큰 묶음 수정 → 재실행"의 운영 루프를 문서로 남깁니다.
이런 분께 추천
- LLM 에이전트나 툴 호출 워크플로를 운영하며 프롬프트/모델 교체 후 회귀가 두려운 개발자
- 아직 평가 체계가 없어 "골든 셋"을 처음 만들어야 하는 팀
- LLM 심판(judge) 대신 빠르고 결정적인 어설션 테스트를 원하는 분
활용 예시
- "프롬프트를 바꿨는데 안 깨졌는지 확인하고 싶어" → 기존 트랜스크립트에서 실패를 캐내 회귀 스위트 생성.
- 환불 에이전트가 주문 조회 없이 답변한 사고 →
trace has get_order before send_reply케이스 추가. - 승인 없이 환불을 실행한 사고 →
trace has approval_request before refund규칙으로 고정하고python check_traces.py를 CI에 연결.
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/undefined-ui/second-brain-os/HEAD/plugins/agents-course/skills/evals-bootstrap/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 undefined-ui/second-brain-os 의 plugins/agents-course/skills/evals-bootstrap 폴더를 내 ~/.claude/skills/evals-bootstrap/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/undefined-ui/second-brain-os.git && mkdir -p ~/.claude/skills && cp -r second-brain-os/plugins/agents-course/skills/evals-bootstrap ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 엽니다.
- 저장소를 클론합니다:
git clone https://github.com/undefined-ui/second-brain-os.git - 스킬 폴더를 만듭니다:
mkdir -p ~/.claude/skills - 스킬을 복사합니다:
cp -r second-brain-os/plugins/agents-course/skills/evals-bootstrap ~/.claude/skills/ - Python 3와 pyyaml을 준비합니다:
pip install pyyaml - Claude Code를 다시 시작한 뒤 "에이전트 eval 스위트를 만들어줘"처럼 요청하면 스킬이 발동합니다.
- 에이전트 실행 로그(또는 Claude Code 트랜스크립트) 위치를 알려주면 케이스 추출이 시작됩니다.
GitHub에서 원본 보기 ↗라이선스: MIT