steffen74/to-quiz

퀴즈 만들기

한 단원의 퀴즈를 작성하고 발행합니다. 작업 전 COURSE-CANVAS.md, PLAN.md, RESOURCES.md, DECISIONS.md, AGENTS.md의 ## 에이전트 기반 과정 생성 섹션, 그리고 해당 단원의 자료(퀴즈가 다루는 비디오와 과제)를 읽습니다. assumed-knowledge를 로드합니다.

1. 도구와 소스

AGENTS.md에는 /setup-course에서 설정한 - 퀴즈: <소스 파일>, 도구 <이름>, 커넥터 <이름|없음> 형식의 줄이 있어야 합니다. 없으면 한 번 물어보고, 추천한 후 작성합니다:

• 소스: 비공개 과정 저장소의 한 파일에 모든 질문과 옵션, 정답, 설명이 저장됩니다. CSV 형식(열: session, type, question, option_a, option_b, option_c[, option_d], correct, explanation) 또는 이를 반영하는 Markdown을 사용합니다. 퀴즈 도구는 복사본일 뿐 소스가 아닙니다.
• 도구: 과정마다 한 번 선택합니다(예: Microsoft Forms 또는 Formbricks). 점수 매기기는 선택 사항이며, 대부분의 비디오 확인은 수업에서 토론할 답변 분포만 필요로 합니다.

2. 질문 작성

단원에 대해 세 가지에서 다섯 가지 질문을 초안으로 작성하며, 각 질문은 다음을 포함합니다:

• 학습자가 세션 전에 접한 내용(이전 단원의 비디오와 과제)에 관한 질문. 세션 자체에서 소개하는 내용은 절대 묻지 않습니다.
• 세 개 또는 네 개의 옵션 중 하나가 정답. 오답은 (가능한 경우 SIGNALS.md에서) 학습자가 실제로 가지는 오해에 기반해야 하며, 꼬임 질문이 아니어야 합니다.
• 한두 문장으로 된 설명으로, 강사가 수업에서 사용할 수 있도록 합니다.
• 유형: 비디오, 과제 또는 스킬과 해당 출처.

질문은 자료가 실제로 말하는 내용에 기반해야 합니다. 읽을 수 없는 비디오에 기반한 질문은 설명에 제목만으로 작성이라고 표시합니다. 강사가 비디오와 비교하여 확인합니다.

질문을 보여주고 강사의 승인을 기다립니다. 그런 다음 소스 파일에 작성합니다.

3. 도구에 생성

• 커넥터 연결됨: 생성될 퀴즈를 보여주고 승인을 기다린 후, 초안으로 생성하고 공유 링크를 기록합니다. 커넥터 자체 스키마(도구 설명을 읽으십시오. 스키마는 버전마다 다릅니다)에 따라 퀴즈 소스에서 요청을 구성하고, 유효성 검사 도구가 있다면 먼저 사용합니다.
  • Formbricks: 공식 MCP 서버(OAuth 로그인 포함, https://app.formbricks.com/api/mcp 또는 자체 호스팅의 경우 https://<도메인>/api/mcp)를 제공합니다. 도구로는 list_workspaces, validate_survey, create_survey 등이 있습니다. 과정이 Formbricks를 사용하는데 연결되지 않은 경우, 강사에게 에이전트에 추가하는 명령어를 알려줍니다(Claude Code의 경우: claude mcp add --transport http formbricks https://app.formbricks.com/api/mcp, 그런 다음 /mcp를 통해 로그인). 에이전트 구성을 직접 변경하지 마십시오.
  • Microsoft Forms: 퀴즈 생성을 위한 API가 없으며 공식 커넥터도 없습니다. 아래 내보내기를 사용하십시오.
• 커넥터 없음: CSV 소스에서 scripts/export_quiz.py를 사용하여 내보냅니다:
  • Formbricks: --format formbricks는 관리 API용 설문 본문을 작성하고 curl 명령어를 출력합니다. 강사는 환경 변수에서 자신의 API 키를 사용하여 실행합니다. 키를 요청하거나 파일에 기록하지 마십시오.
  • Microsoft Forms: --format forms는 빠른 가져오기용 .docx 파일과 정답 키를 작성합니다. 빠른 가져오기는 정답을 지원하지 않으므로 강사가 키에서 직접 표시해야 합니다(점수 매기기를 사용하는 경우에만 필요).
  • 다른 도구: 도구가 수용하는 가장 가까운 가져오기 형식 또는 붙여넣기용 일반 목록을 작성합니다.

정답과 설명은 참가자용 파일이나 공개 위치에 절대 나타나지 않습니다.

4. 인계

단원에 대한 RESOURCES.md(열 퀴즈)에 퀴즈 링크를 기록합니다. 슬라이드에는 질문이 아닌 링크(슬라이드 형식이 허용하는 경우 QR 코드)가 표시됩니다. /to-slides는 RESOURCES.md에서 이 링크를 가져옵니다.

질문이 소스에 있거나, 퀴즈가 도구에 초안으로 존재하거나 가져오기 파일이 지침과 함께 준비되어 있고, 링크 또는 상태가 RESOURCES.md에 기록되면 완료됩니다.