KGU Beamer Lecture

kgulec — KGU Beamer Lecture

경기대학교 대학 강의를 위한 LaTeX Beamer 슬라이드 생성·수정·실습코드·테마 셋업 Claude Code 플러그인.

전공 무관 — 슬라이드 생성 골격(템플릿·디자인·분량·오버플로 검사)은 분야에 종속되지 않는다. /kgulec:setup에서 지정한 **주요 도메인(분야)**에 맞춰 후보 토픽·웹검색·내용 생성이 그 분야 기준으로 이뤄지므로(동음이의 혼입 방지), CS/공학뿐 아니라 인문·사회·자연과학 등 어떤 전공 강의에도 쓸 수 있다. (단 실습코드 모드 /kgulec:code는 Python/HTML 코드 데모라 CS·공학 강의에 가장 잘 맞는다.)

주제만 줘도, 강의 노트·원고를 줘도, 기존 .tex를 줘도 대응한다. 수식(amsmath), 알고리즘(algorithm2e), TikZ 다이어그램, tcolorbox 색상 코딩 디자인을 활용하며 한글·영어를 모두 지원한다. 경기대 내 공용·오픈소스 사용을 목적으로 한다.

권장 모델: 자료 조사·구조 설계·LaTeX 생성이 복잡해 Opus 이상(Claude Opus 4.x 등) 모델에서 가장 잘 동작한다. 더 작은 모델은 컴파일 오류·레이아웃 품질이 떨어질 수 있다.

요구사항

Claude Code CLI (필수)

이 플러그인은 Claude Code 플러그인이라 Claude Code CLI가 먼저 설치돼 있어야 한다. 설치·로그인 후 마켓플레이스로 플러그인을 추가한다(아래 설치 참고).

LaTeX

컴파일에는 TeX 배포판(macOS/Linux TeX Live full 권장, Windows는 MiKTeX 또는 TeX Live)과 다음 패키지가 필요하다(shared/beamer-templates.md 기준):

• beamer(Madrid 테마), tcolorbox(most), kotex(한글), fontawesome5, algorithm2e
• amsmath, tikz, graphicx, booktabs, array, multicol, multirow
• xcolor(svgnames,table), csquotes, bbm, pifont, ragged2e, fp, hyperref, verbatim

도구: 컴파일 pdflatex/latexmk, PDF→PNG 변환(테마 미리보기·오버플로 검사용) pdftoppm/pdftocairo(poppler) 또는 magick(ImageMagick) 중 하나.

이 도구가 없으면 /kgulec:setup·/kgulec:new가 OS·패키지 매니저에 맞는 설치 명령을 동의받아 안내·실행한다(무음 설치 안 함, shared/environment-check.md).

• /kgulec:setup은 하드 게이트다. 컴파일 도구(pdflatex)와 PDF→PNG 도구가 둘 다 설치 확인되어야 다음 단계로 진행한다. 설치가 안 되면 setup을 중단하고, 설치 후 재실행하도록 안내한다.
• /kgulec:new·edit·code는 비차단이다. 도구가 없어도 .tex는 생성하고, 설치 후 컴파일하라고 안내한다(컴파일·미리보기만 건너뜀).

OS 무관 동작: 폴더 생성·복사 등 내부 명령은 macOS/Linux(bash)와 Windows(PowerShell) 모두 지원한다. 스킬이 실행 OS를 확인해 맞는 명령을 쓴다. 사용자 설정 경로: macOS/Linux ~/.claude/kgulec/, Windows %USERPROFILE%\.claude\kgulec\.

설치 (마켓플레이스)

두 명령을 한 번에 붙여넣으면 일부 환경에서 에러가 난다. Step 1 실행 후, Step 2를 따로 실행한다.

Step 1 — 마켓플레이스 추가

/plugin marketplace add minercode625/kgulec

Step 2 — 플러그인 설치

/plugin install kgulec@kgulec-marketplace

이후 처음 한 번 /kgulec:setup으로 테마·공통 설정을 잡아두면, 이후 생성물에 자동 적용된다.

명령어

명령	모드	하는 일	트리거
/kgulec:new	A 생성	자료 조사 → Outline 승인 → 슬라이드 생성 → 컴파일·품질검사	명시 + 자연어 자동
/kgulec:edit	B 수정	기존 main.tex 수정·삭제·순서변경·교체·보강	명시 + 자연어 자동
/kgulec:code	C 실습	강의 내용 기반 실습 프로그램(Python/HTML)	명시 + 자연어 자동
/kgulec:setup	D 셋업	색 테마 + 공통 설정(교수명·소속·언어·강의시간)	명시 전용

A/B/C는 "강의자료 만들어줘" 같은 자연어로도 자동 트리거된다. setup은 /kgulec:setup으로만 실행된다.

사용법

0. 처음 한 번 — 셋업

/kgulec:setup

색 테마 + 공통 설정(교수명·소속·주요 도메인(분야)·기본 언어·기본 강의시간)을 한 번에 정해 저장한다. 이후 모든 생성물에 자동 적용되므로 매번 다시 묻지 않는다.

1. 강의자료 만들기

강의자료를 둘 작업 폴더(예: week03/)에서 Claude Code를 열고:

/kgulec:new

또는 자연어로 "경사하강법 3시간 강의자료 만들어줘"처럼 말해도 자동 트리거된다. 진행 흐름:

1. 자료 폴더 안내 — 작업 폴더에 figs/·ref/를 자동 생성하고 자료를 넣을지 묻는다(아래 참고).
2. 자료 조사 — 분야 기준으로 웹·ref/를 조사한다.
3. Outline 승인 — 섹션 구성·슬라이드 수를 제시하고 승인받는다.
4. 생성·컴파일·품질검사 — main.tex 생성 → pdflatex 컴파일 → 오버플로·섹션 표지 검사·수정.

결과물: 작업 폴더에 main.tex + main.pdf.

2. ./figs 와 ./ref 폴더

모드 A 진입 시 작업 폴더에 두 폴더가 자동으로 생긴다. 선택 사항이며, 비워 두고 "자료 없음 — 웹검색만으로 진행"을 골라도 된다.

폴더	무엇을 넣나	어떻게 쓰이나
./figs/	슬라이드에 넣을 이미지(.png 등)	현재 강의와 관련된 그림을 \includegraphics로 삽입. 적합한 그림이 없으면 % TODO [IMAGE] 주석 + 자리만 확보(나중에 파일 넣고 주석 해제)
./ref/	강의자료 생성에 참고할 문헌 자료(PDF)	1차 출처로 삼아 범위·용어·표기·예시를 일관되게 함. 웹 검색은 보완용. 큰 PDF는 자동 요약

자료를 넣을 거면 폴더에 파일을 옮긴 뒤 "넣었어요"를 고르면, 다시 스캔해 반영한다.

3. 수정하기

/kgulec:edit

또는 "3번 슬라이드 예시 더 추가해줘", "이 수식 고쳐줘"처럼. 기존 main.tex를 수정·삭제·순서변경·교체·보강한다. 같은 figs/·ref/ 규칙이 적용된다.

4. 실습코드 만들기 (CS·공학 위주)

/kgulec:code

main.pdf를 읽어 수업시간에 보여줄 실습을 3가지 이상 추천하고, 고른 것을 같은 폴더 code/에 Python 또는 HTML로 작성한다.

사용자 설정 (업데이트 안전)

공통 설정은 플러그인 폴더 바깥 ~/.claude/kgulec/config.md에 저장된다. 같은 폴더의 ~/.claude/kgulec/gotcha/에는 작업 중 새로 발견한 컴파일 에러 기록이 쌓인다. 둘 다 플러그인 폴더 바깥이라 업데이트(/plugin update)해도 유지된다. (번들 shared/gotcha/는 읽기전용 참조 — 새 기록은 사용자 폴더에만 쓴다.)

• 저장: 교수명·소속·주요 도메인(분야)·기본 언어·기본 강의시간·색 테마(이름 + 해석된 4색).
• 스키마가 올라가 새 항목이 생기면, 다음 실행 때 기존 값은 유지한 채 새 항목만 자동 보강(필요 시 그것만 질문)한다. 스키마 정의는 shared/config-schema.md.

색 테마

/kgulec:setup에서 주색(primary) 프리셋을 고른다. 의미색(example=초록, warning=주황, info=회색)은 고정이고 주색만 바뀐다. 기본 6종: Ocean(파랑·기본) / Indigo / Plum / Maroon / Slate / Teal. 카탈로그는 shared/color-presets.md.

디렉토리 구조