📢 핵심 30초 요약
일일이 손으로 채점하고 "누가 다 풀었니?" 확인하느라 바쁘셨나요? 구글 제미나이(Gemini)에 프롬프트를 입력하면, 학생들이 문제 풀이 후 체크박스만 눌러도 [1초 자동 타임스탬프 기록 + 모둠별 실시간 진도율 SPARKLINE 게이지 + 에디터 에러 방지 방어 코드]가 탑재된 완성형 Google Apps Script(GAS)가 완성됩니다.
선생님, 그리고 아이들의 개별화 맞춤형 수업과 자기주도적 학습 관리를 고민하시는 교육 가족 여러분 안녕하세요! 프롬프트로 배우는 바이브 코딩 블로그 에디터입니다. 😊
초등 5~6학년 실과 소프트웨어(SW) 단원이나 수학 개별화 문제 풀이 시간에 "학생들이 과제를 몇 시 몇 분에 끝냈는지 기록하고, 모둠별 진도 상황을 파악하느라 수업 시간이 턱없이 부족했던 경험" 다들 있으실 텐데요.
구글 제미나이(Gemini)용 바이브 코딩 프롬프트를 활용하면, 구글 스프레드시트의 onEdit 자동화 트리거를 활용해 학생이 체크박스를 누르는 즉시 제출 시각이 초 단위로 자동 찍히고, 실시간 모둠별 진도율 막대그래프가 차오르는 '스마트 자기주도 과제 대시보드'를 단 1분 만에 구축할 수 있답니다!
📊 온에디트(onEdit) 실시간 과제 시트의 3가지 핵심 기능
교사의 수기 기록 부담을 제로로 만들고 학생의 메타인지 학습을 돕는 자동화 기능입니다.
| 무엇이 바뀌었나요? (영역) | 초보자를 위한 쉬운 설명 | 이렇게 한번 써보세요! |
|---|---|---|
| ⏱️ 1초 자동 타임스탬프 (onEdit Trigger) |
학생이 자신의 이름 옆 '완료' 체크박스를 클릭하면, Apps Script가 수정된 행을 감지하여 옆 셀에 현재 시각을 초 단위까지 자동 입력합니다. | 수학 10문제 풀이 완료 시간 및 과제 제출 순서 자동 기록 |
| 📊 모둠별 실시간 진도율 (SPARKLINE Gauge) |
각 모둠원들의 과제 완수율(%)에 따라 셀 안에 알록달록한 미니 진행 바(Progress Bar)가 실시간으로 차오릅니다. | 전자칠판에 대시보드를 띄워 모둠별 협동 및 또래 멘토링 유도 |
| 🛡️ 스크립트 에러 방지 (Defensive Error-Zero) |
편집 이벤트 객체(`e`)의 undefined 오류를 방지하는 방어 코드가 포함되어, 초보 교사가 복사해 붙여넣어도 에러 없이 100% 작동합니다. | 스크립트 편집기에서 에러 메시지 걱정 없이 안전하게 배포 |
💡 초보자를 위한 바이브 코딩 실전 사용 예시
초보자도 에러 없이 바로 실행할 수 있도록 '에러 방지 기본 안전장치'가 내장되고, 우리 반 시트 구조에 맞게 조율하는 '거꾸로 프롬프트(Reverse Prompting)'가 적용된 제미나이 전용 만능 프롬프트입니다.
🪄 제미나이 전용 '온에디트 과제 제출 & 진도율 대시보드' 만능 프롬프트
"당신은 Google Apps Script(GAS) 및 구글 스프레드시트 교육용 자동화 최고 전문가입니다.
학생들이 과제 상태를 변경하면 제출 시간이 자동 기록되고 진도율이 갱신되는 '온에디트(onEdit) 과제 대시보드' 단일 스크립트 코드를 작성해 주세요.
[에러 방지 기본 환경 세팅 (Zero-Error Baseline)]
1. onEdit(e) 방어 코드 내장: 이벤트 객체 `e`가 없는 수동 실행 시에도 오류(`Cannot read properties of undefined`)가 발생하지 않도록 `if (!e || !e.range) return;` 방어 조건을 최상단에 배치해 주세요.
2. 한국 표준시(KST) 타임스탬프: `Utilities.formatDate(new Date(), 'Asia/Seoul', 'yyyy-MM-dd HH:mm:ss')` 형식을 적용해 주세요.
3. 코드 생략 금지: 주석 생략 없이 복사하여 즉시 실행 가능한 100% 완전한 GAS 코드로 출력해 주세요.
[핵심 요구 기능 및 기술 사양]
1. 타깃 시트 및 셀 감지: 특정 시트(예: '과제제출')의 '과제완료 체크박스 열'이 TRUE(체크)로 변경될 때만 동작하고, 체크 해제 시에는 타임스탬프 셀을 빈칸으로 초기화
2. 실시간 진도율 게이지 함수/서식: 모둠별 완료 개수를 카운트하여 SPARKLINE 수평 막대 게이지 및 달성률(%)을 자동 계산하는 시트 수식 템플릿 안내
3. 교사용 메뉴: 상단에 '📊 과제 관리' 메뉴 생성 (▶ 전체 타임스탬프 초기화, 📥 제출 현황 요약 리포트)
코드를 작성하기 전, 구글 시트의 열 구조(예: C열 체크박스, D열 제출시간)나 모둠 인원 구성을 어떻게 할지 나에게 2가지 질문을 먼저 물어봐줘."
학생들이 과제 상태를 변경하면 제출 시간이 자동 기록되고 진도율이 갱신되는 '온에디트(onEdit) 과제 대시보드' 단일 스크립트 코드를 작성해 주세요.
[에러 방지 기본 환경 세팅 (Zero-Error Baseline)]
1. onEdit(e) 방어 코드 내장: 이벤트 객체 `e`가 없는 수동 실행 시에도 오류(`Cannot read properties of undefined`)가 발생하지 않도록 `if (!e || !e.range) return;` 방어 조건을 최상단에 배치해 주세요.
2. 한국 표준시(KST) 타임스탬프: `Utilities.formatDate(new Date(), 'Asia/Seoul', 'yyyy-MM-dd HH:mm:ss')` 형식을 적용해 주세요.
3. 코드 생략 금지: 주석 생략 없이 복사하여 즉시 실행 가능한 100% 완전한 GAS 코드로 출력해 주세요.
[핵심 요구 기능 및 기술 사양]
1. 타깃 시트 및 셀 감지: 특정 시트(예: '과제제출')의 '과제완료 체크박스 열'이 TRUE(체크)로 변경될 때만 동작하고, 체크 해제 시에는 타임스탬프 셀을 빈칸으로 초기화
2. 실시간 진도율 게이지 함수/서식: 모둠별 완료 개수를 카운트하여 SPARKLINE 수평 막대 게이지 및 달성률(%)을 자동 계산하는 시트 수식 템플릿 안내
3. 교사용 메뉴: 상단에 '📊 과제 관리' 메뉴 생성 (▶ 전체 타임스탬프 초기화, 📥 제출 현황 요약 리포트)
코드를 작성하기 전, 구글 시트의 열 구조(예: C열 체크박스, D열 제출시간)나 모둠 인원 구성을 어떻게 할지 나에게 2가지 질문을 먼저 물어봐줘."
🏃 실전 적용 3단계 순서
- 1단계 (제미나이에 프롬프트 입력): 위 프롬프트를 복사하여 구글 제미나이에 전달하고, 우리 반 시트 열 번호에 맞춰 AI 질문에 답합니다.
- 2단계 (Apps Script에 붙여넣기): 구글 스프레드시트 [확장 프로그램] ➔ [Apps Script] 메뉴에 코드를 붙여넣고 저장(Ctrl+S)합니다.
- 3단계 (실시간 자기주도 학습): 학생들에게 시트 링크를 공유하면, 학생들이 체크할 때마다 1초 만에 제출 시각이 찍히고 모둠 진도율이 올라가는 스마트한 수업이 진행됩니다!
🎯 에디터 한줄평
"선생님의 확인 도장을 기다리는 수동적인 교실에서, 자신의 과제 시간을 스스로 기록하고 관리하는 능동적인 배움터로! 제미나이 바이브 코딩으로 교실에 실시간 피드백의 활력을 불어넣어 보세요!"
📌 구글 제미나이 웹 및 개발자 리소스
Google Gemini 공식 포털 바로가기 🔗
