Communitygithub.com

퀴즈 사이트 빌더

자연어로 모바일 우선 대화형 퀴즈 웹사이트를 만들고, 개선하며, 배포합니다. 중국 성격/캐릭터 매칭, 서바이벌/스토리, 강점 테스트, 문제 은행, 결정론적 점수 계산, 공유 가능한 결과, 검증, GitHub 소스 게시, Cloudflare Pages 배포를 지원합니다. 사용자가 온라인 테스트나 퀴즈를 만들고 싶을 때 사용하세요. 기본적으로 결제나 카드 코드는 포함하지 않습니다.

퀴즈 사이트 빌더란 무엇인가요?

퀴즈 사이트 빌더는 사용자의 아이디어를 Cloudflare Pages에 곧바로 배포할 수 있는 모바일 최적화 대화형 퀴즈 웹사이트로 전환하는 AI 에이전트 스킬입니다. 중국 성격/캐릭터 매칭, 서바이벌/인터랙티브 스토리, 강점 테스트 등 다양한 퀴즈 유형을 지원하며, 결정론적 점수 계산, 공유 가능한 결과, 철저한 검증 기능을 갖추고 있습니다. Claude Code, Cursor, Codex, WorkBuddy 등 다양한 AI 에이전트와 호환되도록 설계되었습니다. 기본적으로 무료이며 익명이며 정적인 프런트엔드 전용 접근 방식을 따르고, 사용자가 명시적으로 요청하지 않는 한 결제, 인증 또는 분석 기능을 도입하지 않습니다. 스킬은 공동 창작 모드(아이디어 탐색 → 설계 → 스타일 결정)와 원클릭 모드(즉시 구축)를 모두 제공하며, 요구에 맞춰 유연하게 대응합니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/jinceci9-netizen/quiz-site-builder/tree/HEAD/skills/quiz-site-builder

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

퀴즈 사이트 빌더 — 이식 가능한 에이전트 스킬

사용자와 함께 퀴즈 콘셉트를 공동 창작한 후, 합의된 디자인을 정교하고 테스트된 Cloudflare Pages 준비 웹사이트로 전환합니다. 이 스킬은 벤더 중립적인 Agent Skills 폴더 형식을 따릅니다. 특정 Agent 제품이나 벤더별 도구를 요구하지 않습니다. 항상 GitHub 소스 호스팅과 Cloudflare 웹사이트 배포를 구분합니다. 스킬 자체의 저장소와 각 생성된 퀴즈 사이트의 저장소는 별개입니다.

먼저 읽어주세요

  1. 파일을 건드리기 전에 사용자의 작업 디렉터리를 검사하세요. 기존 프로젝트, 파일, 설정 또는 배포를 덮어쓰지 마세요.
  2. 공동 창작 중에는 메커니즘을 자동으로 수정하지 말고 제안하세요. 전체 구현 전에 확인 또는 위임을 받으세요:
    • 성격/캐릭터 매칭: 차원 → 결정론적 유형/캐릭터 매칭; 동점 처리에 대해 설명합니다.
    • 서바이벌/인터랙티브 스토리: 순서가 있는 결정 → 추적되는 상태 변수 및 체크포인트 → 도달 가능한 결말.
    • 진단/강점: 자연스러운 편안함 + 소모 + 최고 경험 → 해석 가능한 강점 및 행동.
  3. 질문, 결과 및 점수 균형에 대해 references/quiz-design.md를 읽으세요. 주제별 글쓰기 및 디자인에 대해 references/visual-and-copy.md를 읽으세요. 글꼴, 이미지 또는 종속성을 선택하기 전에 references/mainland-readiness.md를 읽으세요. 완료를 선언하기 전에 references/qa.md를 읽으세요. 배포 요청 시 Cloudflare Pages via GitHub에 대해 references/publishing.md를 읽으세요.
  4. 승인된 개발 단계에서 처음부터 시작할 때: 전체 assets/starter/를 새 웹사이트 디렉터리에 복사하세요. 재사용 가능한 스타터를 직접 수정하지 마세요. 스타터에는 3개의 예제 퀴즈, 타입이 지정된 점수 엔진, 반응형 뷰 및 결과 공유가 포함되어 있습니다. 컴포넌트를 편집하기 전에 src/data/*.json을 사용자 지정하세요.
  5. 기본적으로 유료화 금지. 사용자가 요청하지 않는 한 결제, 카드 코드, Cloudflare Workers, 인증, D1 또는 KV를 도입하지 마세요. 액세스 코드가 요청되면 references/access-codes-optional.md를 읽고 사용자에게 보안 아키텍처를 안내하세요. 자동으로 구현하거나 유료 서비스를 배포하지 마세요.

기본 모드: 사용자 참여 공동 창작

초기 요청이 "웹사이트 만들기"이거나 개발 작업을 나열하더라도 기본적으로 공동 창작을 진행합니다. 먼저 창의적인 방향을 명확히 하세요. 즉시 전체 문제 은행을 생성하거나, 스타터를 복사하거나, 전체 사이트를 구축하지 마세요. 사용자에게 다시 묻는 대신 이미 제공된 선택 사항을 재사용하세요. 기존 파일을 검사하고 범위가 제한된 제안을 준비하는 것은 허용됩니다.

일반적으로 응답당 하나의 단계씩 세 단계를 순서대로 진행합니다. 각 단계는 구체적인 권장 사항을 제공하고 총 1~2개의 핵심 질문만 합니다. 이미 답변한 질문을 반복하지 마세요. 모든 Agent에서 일반 채팅을 사용하세요. 선택적 양식은 필수가 아니어야 합니다.

  1. 아이디어 탐색 — 사용자의 주제에 대해 의미 있게 다른 23가지 각도를 제시합니다. 각각 후크, 대상 및 차별화된 경험을 포함합니다. 입증되지 않은 바이럴 주장이 아닌, 독특한 플레이어 긴장감과 기억에 남고 정직하게 공유할 수 있는 결과를 선호합니다. 사용자가 명시적으로 다른 개수(예: 5가지 아이디어)를 요청하면 23가지를 강요하지 않고 이를 따릅니다. 하나를 추천하고 이유를 설명합니다. 어떤 각도를 발전시킬지 묻고, 개념을 실질적으로 변경하는 최대 하나의 추가 질문을 합니다.
  2. 테스트 설계 — 제안된 알고리즘을 평이한 언어로 제시합니다(상태/차원, 선택이 차원에 미치는 영향, 체크포인트/동점 및 결말 선택 방식). 결과 유형과 차이점, 그리고 2~3개의 완전한 샘플 질문(옵션 및 설명된 트레이드오프 포함)을 제시합니다. 확인된 각도에 맞는 메커니즘을 추천하고, 채택할지 아니면 핵심 트레이드오프를 변경할지 묻습니다. 샘플은 제안일 뿐이며 전체 은행이 아닙니다.
  3. 스타일 결정 — 팔레트, 타이포그래피, 휴대폰 흐름 및 3:4 공유 카드 처리를 포함한 2~3가지 구체적인 시각적 방향을 제시합니다. 하나를 추천합니다. 제목, 해석, 강점, 약점 및 조언을 포함한 대표적인 결과 보고서 초안을 보여줍니다. 시각적 선택과 통합된 디자인의 최종 승인을 묻습니다(최대 2개의 질문). 사용자가 디자인을 확인하거나 나머지 결정을 명시적으로 위임할 때까지 전체 개발을 시작하지 마세요.

각 단계가 끝날 때마다 간결한 의사 결정 기록을 표시합니다: 확인된 선택, 아직 확인을 기다리는 AI 권장 사항, 남은 결정. 위임/건너뛴 선택은 사용자가 선택한 기본 설정이 아닌 "AI 결정" 또는 "건너뜀, 권장 사항 채택"으로 기록합니다. 이 기록을 채팅에 유지합니다. 승인 후 생성된 사이트의 docs/DESIGN.md에 저장합니다. 사용자가 결정을 수정하면 기록을 업데이트하고 모든 단계가 아닌 실질적으로 영향을 받는 제안만 다시 검토합니다.

각 단계에서 사용자는 수정, 건너뛰기 또는 AI에게 결정을 맡길 수 있습니다. "이 단계 건너뛰기"는 해당 단계만 위임합니다: 권장 기본값을 기록하고 다음 단계로 진행합니다. "나머지는 네가 결정해"는 남은 모든 선택을 위임합니다: 선택된 디자인을 간략히 기록하고 구현을 계속합니다. 침묵이나 경과 시간은 승인이 아닙니다. 입력이 필요하면 관련 단계에서 중단하세요. 응답 없음을 빌드 허가로 간주하지 마세요.

원클릭 모드

사용자가 "직접 해", "한 번에 생성", "네가 결정해"라고 말하거나 모든 디자인 논의를 건너뛰고 즉시 구축하도록 명시적으로 요청하면 현재 요청에 대해 원클릭 모드로 전환합니다. 선택된 기본값을 명시하고 세 가지 대화 게이트 없이 콘텐츠, 로직, UI, 검증 및 로컬 미리보기를 자율적으로 진행합니다. 기존 사용자 제약은 여전히 적용됩니다. 사용자는 언제든지 공동 창작 모드로 돌아갈 수 있습니다. 명확한 사전 디자인 승인도 단계를 반복하지 않고 자율적인 개발을 허용합니다.

디자인 승인 또는 원클릭 모드는 요청된 개발 및 디버깅을 승인할 뿐 관련 없는 외부 작업은 승인하지 않습니다. 요청된 로컬 전용 경계를 유지합니다. GitHub 게시 및 Cloudflare 배포는 여전히 사용자 의도와 사용 가능한 권한이 필요합니다.

종단 간 워크플로

1. 사용자의 아이디어를 사용 가능한 제품 사양으로 전환

공동 창작 모드에서는 위의 세 단계를 완료하고 구현 전에 의사 결정 기록을 통합합니다. 원클릭 모드에서는 기다리지 않고 이러한 기본값을 선택하고 간략히 명시합니다. 한 문장 후크, 대상, 질문 수(기본 ~10–16), 결과 클래스, 메커니즘, 트레이드오프, 테마/색상 방향, 모바일 흐름 및 공유 카드 아이디어를 포함합니다. 지정되지 않은 경우 기본적으로 무료, 익명, 진행 상황이 로컬에 저장되는 정적 사이트입니다. 확인된 선택에 대해 다시 묻지 마세요. 공동 창작 모드에서는 제안된 기본값이 수락되거나 위임될 때까지 레이블을 지정합니다. 엔터테인먼트 성격 테스트를 과학적 진단으로 설명하지 마세요.

2. 디자인 승인 또는 위임 후 UI보다 먼저 퀴즈 콘텐츠와 로직 작성

자율적으로 전체 은행을 제공합니다(플레이스홀더 샘플 아님). 일상적인 기술 결정에 대해 묻지 않고 승인된 사이트를 구현/디버깅합니다. 명백하지 않은 옵션이 포함된 내러티브 질문을 사용합니다. src/data/*.json을 표준 퀴즈 데이터로 유지합니다. 각 성격/진단 옵션에 대해 선언된 축만 참조합니다. 서바이벌의 경우 danger 및 influence는 유한 정수 상태 효과여야 하며, 에피소드는 순서가 지정되고, 여러 결말이 현실적으로 도달 가능해야 합니다. 실패 및 성공 경로를 테스트합니다. "항상 가장 안전한 답변 선택" 악용을 방지합니다. 라이선스 미디어/명명된 작품의 경우 검증 가능한 줄거리 사실을 창작된 상황과 분리합니다. 실제 연대기를 주장하기 전에 신뢰할 수 있는 출처나 사용자 제공 참조 자료를 참조하세요. 사용할 수 없는 경우 격차를 명시하고 사용자가 선택할 수 있는 원본 대안을 제안합니다. 명명된 작품에 대한 요청을 해당 이미지, 대화 또는 프로모션 자산을 복사하는 허가로 취급하지 마세요. 사용 권한을 확인하고 정확한 플롯 연대기를 조작하지 마세요.

3. 매력적이고 중국 인지 정적 UI 구축

스타터에서 Vite + React + TypeScript를 기본으로 사용하고 Cloudflare Pages의 경우 base: '/' 를 사용합니다. 유지: 한 번에 한 문제 보기, 진행, 뒤로, 재개, 다시 시작, 키보드 지원, 320px 이상의 휴대폰, 공유 링크 미리보기 및 3:4 공유 카드 내보내기. Google Fonts, 원격 이미지 CDN, 타사 스크립트/SDK, 해외 API 및 클라이언트 측 분석에 대한 런타임 종속성을 피하세요. 정적 자산을 번들로 묶고 안전한 시스템 글꼴 대체를 사용하세요. 키를 커밋하거나 API 비밀을 프런트엔드 코드에 넣지 마세요. 결과를 결정론적으로 만드세요. 기본적으로 결제/코드 없음.

4. 기능 및 중국 본토 준비 상태 검증

다음을 실행하고 경로를 조정합니다:

python3 <skill-root>/scripts/validate_quizzes.py <website>/src/data
python3 <skill-root>/scripts/audit_mainland_assets.py <website>
cd <website>
npm install
npm test
npm run build

그런 다음 수동으로 소개, 뒤로 및 앞으로, 새로고침/재개, 여러 결과 경로, 공유 PNG/URL, 모바일 레이아웃 및 대비를 확인합니다. references/qa.md를 참조하세요. 실행하지 않은 검사를 주장하지 마세요. 실제 본토 네트워크에서 테스트하지 않고 본토 접근성을 주장하지 마세요.

5. 온라인 출시 안내 — GitHub에 코드 게시, Cloudflare Pages로 웹사이트 배포

로컬 미리보기 후 GitHub가 코드를 저장하고 Cloudflare Pages가 사이트를 온라인에서 액세스 가능하게 만든다는 것을 평이한 언어로 설명합니다. 도구가 단계를 수행할 수 없을 때 계정 또는 대시보드 단계를 안내합니다. 로컬 전용 요청을 존중하고 이미 부여된 경우 반복 승인을 요청하지 마세요. references/publishing.md를 따르세요. 기본 경로: 생성된 사이트에 대한 별도의 GitHub 저장소 → Cloudflare Pages Git에 연결 → Vite/React npm run build / dist / 프로덕션 main → 배포 → 홍보를 위한 사용자 정의 도메인 설정 → HTTPS / 본토 네트워크 로드 테스트를 거친 후 준비 완료 주장. 스타터의 GitHub Action은 검사만 수행합니다. Cloudflare의 Git 통합이 배포를 처리합니다.

사용자가 스킬 자체를 GitHub에 게시하려면 이 교차 Agent 스킬 저장소를 별도로 게시하세요. 사용자 의도와 사용 가능한 인증 없이 계정을 만들거나, 도메인을 구매하거나, 저장소를 연결하거나, 푸시하거나, 배포하지 마세요. 사용할 수 없는 경우 실행 가능한 명령과 대시보드 단계를 제공하고 가짜 '게시됨' 주장을 하지 마세요. Cloudflare Pages 표준 글로벌 플랜은 중국 본토 도달 가능성을 보장할 수 없습니다. 하드 요구 사항이 테스트에 실패하면 규정을 준수하는 본토 호스팅 옵션/ICP를 적절히 권장합니다. Cloudflare의 엔터프라이즈 차이나 네트워크를 무료 Pages와 혼동하지 마세요.

제품 원칙

AI는 창의성의 가능성을 확장하고, 사용자는 작품의 독창성을 결정하며, AI는 결정을 현실로 만듭니다. 창의적 선택은 위임되지 않는 한 사용자에게 속합니다. 일상적인 기술 실행은 Agent에게 속합니다. "색상은 네가 결정해"와 같은 좁은 위임은 해당 결정에만 적용되며 다른 모든 남은 단계에는 적용되지 않습니다.

핵심 불변 사항

  • 도달 가능하고 구별 가능한 결과를 제공하는 정확한 알고리즘; 요청되지 않는 한 무작위 결과 없음.
  • 가짜 임상적 타당성 없음; 포괄적인 '중국 접근 가능' 약속 없음.
  • 요청되지 않은 백엔드, 로그인, 추적, 결제, 코드 게이트 또는 민감한 수집 없음.
  • 코드 공유는 배포가 아님. 새 퀴즈 웹사이트는 자체 저장소와 도메인이 있어야 함.
  • 프런트엔드 전용 코드 잠금은 안전하지 않음. 액세스 코드 게이팅이 요청되면 서버측 확인 및 비밀 결과 처리를 조언하고 선택 사항으로 유지.
  • 사용자의 기존 브랜딩, 시각 자료, 사실 및 선택을 따릅니다.

호출 예시

  • "quiz-site-builder로 나랑 궁중 생존 테스트를 공동 창작하자. 먼저 몇 가지 아이디어를 줘."

  • "10문제짜리 오리지널 궁중 생존 테스트를 직접 만들어서 로컬 미리보기만 하고 배포는 하지 마." (원클릭 생성)

  • "$quiz-site-builder를 사용하여 국풍 성격 테스트, 육분석, 기물 성격, 모바일 버전을 만들고 Cloudflare Pages에 배포해 줘."

  • "10문제짜리 오리지널 궁중 생존 테스트를 만들고, 분기 결말, 3:4 결과 카드를 포함하여 GitHub에 게시한 후 Cloudflare에서 자동으로 온라인에 올려줘."

  • "테스트 웹사이트를 중국 본토 사용자에게 준비시키고, 해외 글꼴이나 CDN에 의존하지 않도록 하고, 사용자 정의 도메인을 바인딩하고 액세스를 확인하는 방법을 알려줘."

  • "지금은 유료화나 카드 코드가 필요 없어. 나중에 카드 코드를 어떻게 확장할 수 있는지만 알려줘."

교차 에이전트 실행 규칙

  • references/quiz-design.md 및 assets/starter/와 같은 모든 안내 경로는 이 SKILL.md(<skill-root>)가 포함된 폴더를 기준으로 하며, 하드 코딩된 Codex 디렉터리를 기준으로 하지 않습니다.
  • 현재 호스트 Agent가 실제로 제공하는 파일 작업, 셸 및 브라우저 기능을 사용하세요. apply_patch, Codex 도구 또는 특정 MCP 서버가 있다고 가정하지 마세요. 도구가 없으면 이식 가능한 명령어나 수동 단계를 제공하고 완료되지 않은 단계를 명확히 표시하세요.
  • 프로젝트 소스 진실은 skills/quiz-site-builder/입니다. 스킬 로직을 공급자별 복사본으로 복제하거나 포크하지 마세요. 어댑터 설치는 동일한 폴더만 복사합니다.
  • Codex 호출은 $quiz-site-builder를 사용할 수 있습니다. WorkBuddy, Claude Code, CodeBuddy Code 및 기타 Agent는 스킬 선택기 또는 일반 언어를 사용할 수 있습니다. Codex 외부에서 $ 구문을 요구하지 마세요.
  • Agent가 스킬을 가져온다고 해서 기능을 지원한다고 주장하지 마세요. 배포 단계를 실행하기 전에 로컬 파일 액세스, Python, Node/npm, Git 및 인증 기능을 확인하세요.
  • WorkBuddy 가져오기는 quiz-site-builder/SKILL.md 폴더 루트가 있는 zip을 사용합니다. WorkBuddy는 해당 폴더에서 references/, scripts/, assets/를 로드해야 합니다. 호스트 샌드박스가 스크립트 실행을 방지하는 경우 제한 사항을 설명하고 여전히 정적 사이트 코드를 생성합니다.

호스트별 배포 제약 조건

에이전트에 관계없이: GitHub는 소스를 저장하고, Cloudflare Pages는 기본 배포 대상입니다. 사용자가 권한을 부여할 수 있는 Cloudflare Git 통합을 사용하세요. 선택적 카드 코드 아키텍처는 지침일 뿐입니다. 결제, 지불 또는 비밀을 포함하는 프런트엔드 검사를 자동으로 추가하지 마세요. 중국 본토 액세스는 실제 테스트가 필요하며 표준 Cloudflare Pages 또는 사용자 정의 도메인으로 보장할 수 없습니다.

관련 스킬