JYP Garden Internal

LectureBuilder — Objective → Slide 매핑 규칙

Properties1
tagsconcept, ax-education, lecture-builder, slide-mapping, instructional-design, teaching

6 min read

LectureBuilder — Objective → Slide 매핑 규칙

목적

lecture-plan-teaching-guide-2026의 각 Objective 블록을 파싱해 몇 장의 슬라이드를, 어떤 구조로 생성할지 결정하는 규칙 명세. LectureBuilder 프롬프트 엔지니어링 및 Skills API 연동 코드의 기준 문서.

규칙 1 — 슬라이드 수 결정 공식

슬라이드 수 = 강의포인트 수 + 2 + (실습 있으면 +1, 없으면 +0)
범위 제약: 최소 4장 ~ 최대 10장

근거: 강의안 실측값 (Module 1)

Objective강의 포인트실습공식실측일치
1-1 타입 힌트5개O5+2+1=88장✅
1-2 비동기4개O4+2+1=77장✅
1-3 환경설정4개O4+1+1=66장✅ (그룹화 -1)
1-4 Pydantic4개O4+2+1=77장✅

그룹화 규칙: 강의 포인트가 동일 주제로 묶일 경우 2포인트→1장으로 압축 가능 (최대 1장 절약).

규칙 2 — 슬라이드 유형 5가지 (TCELS)

기호유형역할필수 여부장 수
TTitle학습목표 선언 + 이 Objective를 마치면 할 수 있는 것필수1장
CConcept핵심 이론·개념 설명 (강의 포인트별 1장 원칙)필수2~4장
EExample코드 예제·비교표·다이어그램·실사례필수1~2장
LLab실습 지시 — 단계·사용 데이터셋·예상 결과 요약선택 (실습 O만)0~1장
SSummary핵심 정리·체크리스트·다음 Objective 연결 한 줄필수1장

표준 슬라이드 흐름

T → C → C(→ C → C) → E(→ E) → [L] → S

예시: Objective 1-1 (8장)

슬라이드 1  [T] 학습목표: 타입 힌트를 적용한 AI-native 코드 작성
슬라이드 2  [C] Python 타입 시스템 진화 (그래프: 타입 안전성 vs 유연성)
슬라이드 3  [C] 기본 타입 문법 (int, str, List, Dict, Optional)
슬라이드 4  [C] Union / Optional 문법
슬라이드 5  [C] 제네릭·프로토콜 심화
슬라이드 6  [E] IDE 지원 데모 (PyCharm/VSCode 스크린샷)
슬라이드 7  [E] FastAPI 연동 예제 (자동 문서화)
슬라이드 8  [S] 실전 체크리스트 + "다음: 비동기 프로그래밍"

규칙 3 — 복잡도 등급 (Depth Level)

등급기준슬라이드 범위색상 힌트
🔴 Deep강의포인트 5개+, 이론 중심8~10장진한 배경
🟠 Medium강의포인트 4개, 이론+실습 균형6~7장표준 배경
🟡 Light강의포인트 3개 이하, 실습 중심4~5장밝은 배경

규칙 4 — LectureBuilder 입력 스키마

Claude API 프롬프트에 전달할 각 Objective의 구조화된 입력값:

{
  "objective_id": "1-1",                         # 모듈-순번
  "title": "Python 타입 힌트 이해 및 적용",
  "teaching_points": [                            # 강의안 '강의 포인트' 항목 그대로
    "정적 타입 vs 동적 타입 장단점",
    "Python 타입 힌트 발전사 (PEP 484, 526, 585, 604)",
    "기본 타입·제네릭·유니온·프로토콜 문법",
    "IDE 자동완성·검증·리팩토링 이점",
    "FastAPI 통합"
  ],
  "slide_count": 8,          # 강의안 명시값 우선 / 없으면 공식 계산값 사용
  "has_lab": True,
  "lab_dataset": "users.csv (1,000행)",
  "difficulty": "중급",       # 초급 / 중급 / 고급
  "depth_level": "deep",     # deep / medium / light (규칙 3 기준)
  "module_theme": "data-analytics",  # data-analytics(파랑) | generative-ai(보라)
  "next_objective": "1-2 비동기 프로그래밍"  # Summary 슬라이드의 "다음" 연결
}

규칙 5 — 슬라이드 콘텐츠 생성 원칙

  1. T 슬라이드: ABCD 형식 학습목표 그대로 사용 (강의안 학습 결과 섹션)
  2. C 슬라이드: 강의 포인트 1개 = 슬라이드 1장 (예외: 그룹화 시 1장으로 압축)
  3. E 슬라이드: 코드는 최대 15줄, 다이어그램은 Mermaid 우선
  4. L 슬라이드: “실습 XX분 — 데이터: XXX — 목표: XXX” 3줄 요약
  5. S 슬라이드: 핵심 키워드 3~5개 + 체크리스트 3항목 + 다음 Objective 한 줄

모듈별 예상 슬라이드 총량

과목모듈 수Objective 수 (예상)목표 장 수
데이터분석 및 MLOps7개 (Module 1~7)~28개180장
생성형 AI6개 (Gen-1~6)~20개120장
합계13개~48개300장

평균 Objective당 슬라이드 수: 데이터분석 ≈ 6.4장 / 생성형 AI ≈ 6.0장

관련 페이지

그래프 뷰

백링크