Amplify 수업자료 도구 모음

작업을 시작하는 Codex와 Claude는 먼저 작업-시작-전-필독.md를 읽어야 합니다.

중학교 수학 Amplify Classroom 수업자료를 만들 때 쓰는 도구들입니다.

운영 주소: https://amplify.betterwithu.kr/

페이지	내용
index.html	홈 — 제작 도구(글자 꾸미기·수식 입력) / AI 스킬 / CL 학습자료 카드
ai-skill.html	AI 스킬 안내 — 스킬이 무엇인지 설명하고 수식 입력 스킬(skill.html)·CL 해석 스킬(interpret.html) 카드로 연결
settings.html	수식 변환 AI 설정
gemini-key.html	Gemini API 키 발급 안내(스크린샷은 img/gemini-key/)
interpret.html	CL 해석 스킬 설치 허브 (웹·앱 / 문장 하나로 설치 / 지침+파일 올리기, 코드 올리는 방법, 무료 여부). ai-skill.html에서 들어옴
interpret-claude.html interpret-chatgpt.html interpret-gemini.html	CL 해석 스킬의 AI별 설치 안내 (화면 그림은 수식 스킬 안내의 것을 재사용)
skill/cl-interpreter/, skill/cl-interpreter.zip	CL 해석 스킬 사이트 복사본과 배포 zip. 원본은 getbetterwithu/amplify-cl-interpreter(v0.3.2). 아래 갱신 절차 참고
text.html	글자 꾸미기 (크기·색·굵게)
math.html	수식 입력 (명령어 30개 + 복사용 기호 24개, 입력 칸을 누르면 복사, 상단에 "웹에서 해보기(convert.html) / 스킬 설치(skill.html)" 두 카드)
skill/amplify-math/	Claude·GPT·Gemini용 Amplify 수식 스킬 (SKILL.md, references/rules.md, instructions.md). 규칙을 고치면 skill/amplify-math.zip도 다시 만듭니다(반드시 파이썬 zipfile로 만들 것. GNU tar의 tar -a는 .zip 이름의 tar 파일을 만들어 업로드가 실패합니다). Claude Code·Antigravity·Codex CLI는 공개 저장소 getbetterwithu/amplify-math 주소로 직접 설치 가능(명령은 skill.html에 있음). 스킬 규칙의 원본을 고칠 때는 이 폴더와 amplify-math 저장소를 함께 맞춥니다
skill.html	스킬 설치 허브 (처음이라면·코딩 에이전트·붙여넣기, 무료 여부와 시험 현황)
skill-claude.html skill-chatgpt.html skill-gemini.html	각 AI별 설치 안내 (화면 그림 포함, img/skill-*/)
convert.html	AI 수식 변환 · 웹에서 먼저 해보기 (체험용, 같은 규칙의 수식 스킬 설치를 권장)
topnav.css	도구 페이지(text·math·convert)용 상단 메뉴 스타일. 나머지 페이지는 site.css의 .topbar 사용
privacy.html	개인정보 및 AI 데이터 처리 안내
terms.html	이용 안내·저작권·비제휴 고지

CL 학습자료는 별도 저장소에서 관리하며 https://cl.betterwithu.kr/로 연결합니다.

Computation Layer 분석 스킬

• 웹 질의응답 해석기는 종료했고, interpret.html은 수식 스킬 안내(skill.html)와 같은 틀의 설치 안내 페이지입니다. 이 페이지들은 AI를 호출하지 않습니다.
• 사이트의 skill/cl-interpreter/는 저장소 skills/cl-interpreter/의 복사본이고(설치 안내 guides/install-*.md는 제외, guides/instructions-short.md는 포함), skill/cl-interpreter.zip은 그중 guides/를 뺀 14개 파일을 cl-interpreter/ 폴더째 압축한 것입니다.
• 저장소의 스킬이 바뀌면 복사본을 다시 받아 같은 규칙으로 zip을 새로 만들고(반드시 파이썬 zipfile), PK 헤더·Windows Expand-Archive·원본과의 해시 비교로 검증한 뒤, 페이지의 버전 표시(v0.3.2)를 고칩니다.
• zip은 ChatGPT 웹(유료 계정)에서 올려 등록되고, 시험 문장에 출처 표시가 붙은 풀이가 나오는 것까지 확인했습니다(2026-11-01). 풀이가 Amplify의 실제 동작과 맞는지는 확인하지 못했고, Claude·Gemini는 올려 확인한 적이 없습니다. 페이지에도 그렇게 적혀 있으니, 확인되면 문구를 고칩니다. 서비스 메뉴는 자주 바뀌므로 페이지는 "확인했을 때는 …"처럼 시점이 드러나는 표현으로 씁니다.

확인 상태와 알려진 제한

서비스 메뉴와 정책이 자주 바뀌므로 안내 페이지는 "확인했을 때는 …"처럼 시점이 드러나는 표현으로 씁니다.

• ChatGPT: GPT 만들기는 종료되었거나 종료 예정으로 안내됩니다(2026-10-31 화면 기준). 유료 계정의 웹에서는 zip 스킬 업로드가 되지만, 앱에는 업로드 메뉴가 없을 수 있습니다. 무료 계정은 스킬 메뉴가 열리지 않을 수 있습니다. 채팅이나 Work에 GitHub 주소를 주고 설치를 시켜도 스킬 목록에 등록되지 않습니다.
• CL 해석 스킬 zip: ChatGPT 웹(Plus)에서만 확인했습니다. 줄 번호가 보이는 캡처 입력, Claude·Gemini 업로드, 풀이가 Amplify 실제 동작과 맞는지는 확인하지 못했습니다.
• 대체 방법 미확인: Claude "프로젝트로 쓰기", Gemini "Gem으로 쓰기". Gems는 2026-11-17부터 스킬로 바뀌므로 그 뒤에 다시 점검합니다.
• CL 저장소(amplify-cl-interpreter) 정리 대기: 설치 안내 파일(guides/install-gpt.md, install-gemini.md)의 지식 파일 목록에 reference/unverified.md가 빠져 있고, SKILL.md 제목이 v0.3.1로 남아 있습니다(VERSION.md·plugin.json은 0.3.2). 사이트 안내는 unverified.md를 포함한 reference 3개로 적었습니다.

페이지를 추가하려면

index.html의 제작 도구 섹션(hub-grid)에 tool-card 한 개를 추가합니다. 상단 메뉴는 모든 페이지가 제작 도구 · AI 스킬 · CL 학습자료 세 개로 같아야 하므로, 메뉴를 바꾸면 전체 HTML을 함께 고칩니다.

{ icon:"📊", title:"새 도구", url:"new.html", color:"#0f4c81",
  desc:"무엇을 하는 도구인지 한두 문장." },

AI 도구 공통 설정

settings.html에서 한 번 설정하면 수식 변환이 그 설정을 사용합니다. 개인 키는 그 사람의 브라우저에만 저장되고, 공유용 키는 Vercel 환경변수에만 둡니다.

현재 공통 설정은 Google Gemini를 사용합니다. 모델 이름은 설정 화면에서 바꿀 수 있습니다.

키 발급 안내: gemini-key.html

공유 키 (선택) — Vercel 프록시

암호를 아는 사람이 관리자 키로 쓰게 하는 기능입니다. 키가 브라우저에 노출되지 않도록 서버(Vercel)를 거칩니다.

1. Vercel에 레포 연결

vercel.com/new → GitHub 계정 연결 → amplify-betterwithu Import → 설정은 건드리지 말고 Deploy. (프레임워크 자동 감지 = Other 로 두면 됩니다.)

2. 환경변수 등록

Settings → Environment Variables 에서 아래 값을 넣습니다.

이름	값
GEMINI_API_KEY	공유용 Gemini 키 — 주력 키 말고 새로 발급하세요
GEMINI_API_KEYS	(선택·권장) 공유용 키 여러 개를 쉼표 또는 줄바꿈으로 입력
SHARE_PASSWORD	연수마다 새로 정해 전달할 공유 암호 — README나 코드에는 실제 값을 쓰지 않습니다
GEMINI_MODEL	(선택) 기본값 gemini-3.5-flash

넣은 뒤 Deployments → 최신 배포 → Redeploy 해야 반영됩니다.

3. 주소를 페이지에 알려주기

배포가 끝나면 https://<프로젝트>.vercel.app 주소가 나옵니다. shared-config.example.js 를 복사해 shared-config.js 를 만들고 주소를 넣습니다.

window.AI_ENDPOINT = "https://<프로젝트>.vercel.app/api/ai";

이 파일에는 공개 중계 주소만 들어가므로 저장소에 포함해도 됩니다. API 키와 공유 암호는 절대 이 파일에 넣지 않습니다.

공유 키에는 Google Cloud 콘솔에서 일일 사용량 상한을 걸어두시길 권합니다. 암호가 퍼져도 한도까지만 나갑니다.

공통 프록시가 하는 일 (api/ai.js)

• 암호가 맞을 때만 관리자 키로 Gemini 를 부릅니다 (키는 응답에 담기지 않습니다)
• 허용된 사이트 출처와 convert 작업만 받습니다
• 이미지 크기를 제한하고, 한 키가 사용 한도에 닿으면 등록된 다음 키를 시도합니다

수식 미리보기

Amplify는 수식을 MathQuill로 그립니다 (KaTeX 아님). lib/에 그 라이브러리를 두고 같은 엔진으로 렌더하므로, 미리보기 화면이 Amplify에서 보일 모양과 같습니다.

⚠️ GitHub Pages는 밑줄로 시작하는 폴더를 제외하므로 _mq/가 아니라 lib/입니다.

---

2026 서울대학교사범대학부설중학교 허철호