By name: classroom-setup description: Google Classroom 연동 초기 설정. 패키지 설치, OAuth 인증을 자동으로 처리합니다. allowed-tools: - Bash - Read - Write - AskUserQuestion user-invocable: true
Google Classroom 초기 설정
사용자는 OAuth JSON 파일 경로만 알려주면 됩니다. 나머지는 자동으로 처리합니다.
경로 규칙
- CLI 스크립트: 이 SKILL.md 기준
../../classroom/classroom.py(플러그인 루트 기준) - 인증 데이터:
~/.config/dgsw-classroom/(credentials.json, token.pickle)
실행 시 base directory 정보를 이용하여 CLI 경로를 구성합니다:
PLUGIN_ROOT = "<Base directory>/../../"
CLI = "<PLUGIN_ROOT>/classroom/classroom.py"
실행 순서
1. Python 패키지 자동 설치
python3 -c "from googleapiclient.discovery import build" 2>/dev/null || pip3 install google-api-python-client google-auth-oauthlib google-auth-httplib2
2. credentials.json 확인
ls ~/.config/dgsw-classroom/credentials.json 2>&1
파일이 있으면 → 3단계로 건너뛰기
파일이 없으면 → AskUserQuestion으로 OAuth JSON 파일 경로를 받습니다:
Google Classroom API OAuth 인증 파일이 필요합니다.
GCP Console에서 OAuth 클라이언트 ID(데스크톱 앱)를 만들고
다운로드한 JSON 파일의 경로를 알려주세요.
아직 만들지 않았다면:
1. https://console.cloud.google.com 접속 (학교 계정)
2. 프로젝트 생성 → Classroom API 활성화
3. OAuth 동의 화면 설정 (내부)
4. 사용자 인증 정보 > OAuth 클라이언트 ID > 데스크톱 앱 > JSON 다운로드
경로를 받으면 자동 복사:
mkdir -p ~/.config/dgsw-classroom
cp "<사용자가 입력한 경로>" ~/.config/dgsw-classroom/credentials.json
3. 인증 실행
Base directory에서 CLI 경로를 구성하여 실행:
python3 "<PLUGIN_ROOT>/classroom/classroom.py" auth
브라우저가 열리면 학교 계정으로 로그인하라고 안내합니다.
4. 인증 확인
python3 "<PLUGIN_ROOT>/classroom/classroom.py" courses
수업 목록이 나오면 성공.
5. 완료 메시지
Google Classroom 연동 완료!
사용법:
- "과제 확인해줘" → 수업별 과제 목록
- "과제 제출해줘" → 과제 제출
- /dgsw-classroom:classroom → 과제 관리 스킬
오류 대응
403 Forbidden
학교 IT 관리자가 API 접근을 차단한 경우. 관리자에게 Google Classroom API 허용 요청 필요.
credentials.json 형식 오류
OAuth 클라이언트 ID가 "데스크톱 앱" 유형인지 확인.