classforgelisted
Install: claude install-skill sehunYang/classforge
# classforge — 수업 자료 한 벌 만들기
수업 주제 하나를 **lesson.json** 한 파일로 설계하면, 검증된 템플릿이 네 가지 산출물을 만든다.
| 산출물 | 파일 | 용도 |
|---|---|---|
| 수업 슬라이드 | `out/slides.html` (+`slides.pdf`) | 교실 프로젝터. Pretendard를 파일 안에 넣어 인터넷 없이 어느 PC에서나 열린다(evidence 수업이 KoPub을 쓰면 KoPub이 설치된 PC에서는 KoPub, 없는 PC에서는 Pretendard로 보이며 — 게이트가 두 경우의 배치를 모두 잰다). →/Space 넘김, 단계 공개, 퀴즈 정답 공개, 활동 타이머(T), 발표자 노트(N) |
| 학생 활동지 | `out/worksheet.pdf` | A4 인쇄. 정답 글자는 파일에 아예 들어가지 않는다 |
| 정답지 | `out/answer-key.pdf` | 같은 배치에 정답과 풀이 |
| 교수·학습 과정안 | `out/lesson-plan.pdf` | A4 가로. 도입·전개·정리, 평가 계획, 예상 질문 |
원칙 (강의 「ChatGPT Astra 업무자동화」와 공냥이 공개 스킬들에서 가져옴):
- **목적을 먼저 분명히** — 학습 목표에서 거꾸로 설계한다(목표 → 평가 문항 → 활동 → 슬라이드).
- **내용과 디자인을 분리** — 작성자는 lesson.json의 내용과 슬라이드 유형만 고른다. 레이아웃은 템플릿이 책임진다. 새 레이아웃을 발명하지 않는다.
- **게이트는 물리적 브레이크** — 스스로 "잘 됐다"고 판단하지 말고 `gate.mjs`가 exit 0을 낼 때까지 고친다. 그다음 캡처를 직접 본다.
- **수치는 출처가 있을 때만** — 화면·활동지의 모든 수치는 `facts`에 출처와 함께 있어야 한다(S4 게이트가 대조).
- **끝나면 회고** — 무엇이 게이트에 걸렸고 어떻게 고쳤는지 `retro.md`에 남긴다.
`SKILL_DIR` = 이 파일이 있는 폴더.
## 절차
### 0. 준비 확인 (처음 한 번)
```bash
cd "$SKILL_DIR" && [ -d node_modules/playwright-core ] || npm install
python -c "import fontTools" || pip install fonttools
```
Chrome(또는 Edge)이 필요하다. 다른 경로면 `CLASSFORGE_CHROME` 환경변수로 지정.
`meta.font` 기본은 `"auto"` — evidence 수업은 이 PC에 KoPubWorld Dotum이 설치돼 있으면 자동으로 쓰고(`local()` 참조, 파일은 넣지 않는다), 없으면 Pretendard로 대체하고 경고만 남긴다. 설치는 kopus.org 사용 등록 후 받는다. 자세히는 `references/design.md`의 "글꼴".
정밀 도식(`{tikz}`/`{refraction}`/`{circuit}`/`{particles}`/`{geometry}`/`{vect