ZeKaiNie/universal-examprep-skill

무엇인가

Exam Cram Coach는 Claude Code, Codex, Cursor, Windsurf, Gemini CLI와 같은 코딩 에이전트에 "스킬"로 설치할 수 있는 AI 시험 준비 튜터입니다. 강의 자료(강의 슬라이드, 노트, 숙제, 과거 시험)가 있는 폴더를 지정하면, 챕터별로 과정을 가르치고, 자신의 노트에서 실제 그림을 보여주며, 실제 숙제/시험 문제로 퀴즈를 내고, 실수를 추적하고, 치트 시트를 만듭니다.

작동 방식

이 프로젝트는 에이전트 스킬(에이전트가 읽는 지침 세트)과 작은 Python 도구 coach.py로 구성됩니다. 에이전트는 coach.py setup과 같은 명령을 실행하여 자료를 파싱합니다: 과정을 챕터로 나누고, PDF 페이지에서 그림을 크롭하고, 숙제 파일을 솔루션 파일과 페어링하고(예: hw2.pdf와 hw2solutions.pdf), 문제를 문제 은행으로 추출합니다. 학습 세션 중 에이전트는 모든 주장에 특정 파일과 페이지를 인용하고, 크롭된 그림을 인라인으로 표시하며, 그 은행에서 퀴즈를 냅니다. 모든 상태는 로컬 study_state.json에 저장되므로 채팅을 닫고 나중에 재개할 수 있습니다.

주요 기술 포인트

• 설계상 환각 방지: 모든 문장에는 출처가 태그됩니다——🟢(자료에서, file p.N 인용 포함), 🟡(AI 보충), 또는 ⚠️(자료에 없는 AI 생성 답변). 범위를 벗어난 쿼리는 답변을 조작하는 대신 0이 아닌 상태로 종료됩니다.
• 데이터베이스 없는 영구 메모리: 진행 상황, 퀴즈 결과, 실수는 일반 JSON 파일에 저장됩니다; 실수는 간격을 둔 재퀴즈에서 우선 처리됩니다. 벡터 DB도 토큰 팽창도 없습니다.
• 약한/작은 모델에서도 작동: Gemini Flash-Lite와 Claude Haiku에서 1,000페이지 이상의 실제 확률 노트로 벤치마크——명령 조작 0건, 환각 인용 0건 보고.
• 자동 그림 추출: pypdfium2를 사용하여 PDF 페이지에서 벡터 그림을 크롭하므로 튜터가 강의나 솔루션의 정확한 다이어그램을 표시할 수 있습니다.

범위 및 제한 사항

독립 실행형 앱이 아닙니다——터미널이 있는 코딩 에이전트가 필요합니다. PDF 지원에는 pypdfium2가 필요합니다(선택 사항; PPTX/DOCX/Markdown과 같은 다른 형식은 없이도 작동합니다). 스캔 또는 손으로 쓴 페이지는 감지되어 건너뛰며, Excel/오디오 파일은 읽지 않습니다. 두 가지 에디션이 있습니다: Flash(가볍고, 권장되며, 작은 모델에서 작동)와 Full(v4.3, 인쇄 가능한 HTML/PDF 학습 가이드와 검증 파이프라인을 추가하지만 더 강력한 모델이 필요합니다).