구글에서 Antigravity CLI 검색하기

차세대 인공지능 에이전트 코딩 연동 도구의 다운로드를 위해 검색을 수행합니다.

• 구글 검색창을 열고 에이전트 설치 페이지를 탐색합니다.
  antigravity cli
• 기존의 서비스 종료된 gemini-cli 대신 신규 CLI 사양으로 설치 환경을 확인하는 단계입니다.

운영체제별 설치 명령어 확인

자신의 PC OS 환경에 적합한 단축 설치 명령어 스크립트를 수집합니다.

• Antigravity CLI 배포 페이지에서 윈도우 파워셸용 설치 명령어를 확인합니다.
• 운영체제 환경마다 커맨드가 다르므로 윈도우용 파워셸 버전을 확인하여 복사해 둡니다.

PowerShell 관리자 권한으로 가동

시스템 수준의 전역 환경 변수를 정상 세팅하기 위해 권한 상승 모드로 터미널을 실행합니다.

• 윈도우 시작 버튼 검색창에 파워셸을 검색합니다.
• 마우스 우클릭 후 '관리자 권한으로 실행'을 선택하여 창을 엽니다.

설치 명령어 스크립트 실행

복사해 두었던 윈도우 전용 설치 원라인 명령어를 파워셸 창에 실행시킵니다.

• 파워셸 입력창에 아래 명령어를 복사하여 입력합니다.
  irm https://antigravity.google/cli/install.ps1 | iex
• 명령어는 클라우드에서 설치 파일을 가져와 PC 로컬에 패키지를 자동 설치해 줍니다.

설치 완결 및 환경 변수 등록 확인

터미널 출력문을 통해 설치가 정상적으로 종료되었는지 확인하고 안내 사항을 읽습니다.

• 설치가 완료되면 환경 변수 등록에 관한 출력 안내 메시지가 나타납니다.
• 환경 변수를 시스템에 갱신 적용하기 위해 열려 있는 파워셸 창을 완전히 닫습니다.

터미널에서 agy 최초 가동

새로 켠 파워셸 창에서 CLI가 정상적으로 인식되는지 명령어 테스트를 진행합니다.

• 파워셸 창에 에이전트 기동 명령어를 입력하고 엔터를 칩니다.
  agy
• 최초 가동 시에는 구글 계정을 연동하기 위해 클라우드 OAuth 브라우저 인증 대기 상태로 진입합니다.

Google Cloud 계정 연동 및 로그인

브라우저에 나타난 구글 로그인 창에서 에이전트 제어용 계정을 선택해 동기화합니다.

• 자동으로 열린 웹 브라우저 화면에서 본인의 구글 계정 정보로 로그인을 수행합니다.
• 로그인이 완료되면 터미널과 계정 간 보안 세션 연동이 체결됩니다.

인증 보안 코드(Auth Code) 발급

보안 터미널 연결을 완성하기 위해 브라우저에서 고유 인증 토큰 코드를 확인합니다.

• 로그인이 끝나면 브라우저 상에 복사용 일회용 인증 코드가 출력됩니다.
• 우측 복사 버튼을 눌러 코드 문자열을 클립보드에 담습니다.

터미널에 인증 코드 입력

파워셸 입력창에 복사한 인증 보안 코드를 붙여넣어 계정 동기화를 최종 체결합니다.

• 대기 중인 파워셸 프롬프트에 마우스 우클릭으로 코드를 복사해 넣고 엔터를 누릅니다.
• 계정 승인이 진행되면서 에이전트 인공지능이 정상 작동할 준비를 마칩니다.

콘솔 컬러 테마(Color Scheme) 설정

사용자 시각 환경에 맞는 터미널 글씨 테마 색상을 대화형 옵션으로 설정합니다.

• 다크 테마, 라이트 테마 등 선호하는 터미널 컬러 스키마를 고릅니다.
• 테마가 설정되면 에이전트의 응답 내용과 코드 편집 내용이 보기 좋게 하이라이팅됩니다.

서비스 약관 및 데이터 규정 동의

에이전트 구동 과정에서 사용되는 데이터 교류 규정 및 약관을 인지하고 수락합니다.

• 터미널 프롬프트에 나타난 데이터 활용 조항 및 보안 규칙을 체크합니다.
• 이용 약관 동의를 눌러 최초 설치 시 필요한 기본 설정을 완료합니다.

로컬 프로젝트 폴더 접근 권한 승인

에이전트가 로컬 파일에 코드를 작성하고 수정할 수 있도록 접근 권한 동의를 체결합니다.

• 폴더 내부 파일 읽기/쓰기가 가능하도록 팝업 알림에서 사용 허가를 클릭합니다.
• 접근 권한이 열려야 에이전트가 단독으로 코딩 파일을 제어할 수 있습니다.

PowerShell 재실행 및 단축어 설정 준비

별칭 설정 작업을 위해 파워셸 창을 새롭게 관리자 지위로 확보합니다.

• 실행할 때마다 명령어 명칭을 길게 치지 않도록 별칭 매핑 함수(Alias) 세팅을 준비합니다.
• 파워셸 검색창에서 우클릭을 클릭해 관리자 권한을 가동해 줍니다.

파워셸 프로필($PROFILE) 파일 강제 생성

터미널 실행 시마다 단축키들이 항시 자동 탑재되도록 프로필 환경 설정 파일을 만듭니다.

• 터미널에 아래 명령어를 실행하여 파일이 없더라도 강제 생성한 뒤 메모장을 엽니다:
  New-Item -Type File -Path $PROFILE -Force notepad $PROFILE

에이전트 조작용 함수 및 별칭 스크립팅

메모장 파일 내부에 단축 명칭과 승인 스킵 매개변수를 자동으로 이식해 둡니다.

• 프로필 설정 메모장 안에 다음 단축 코드를 정확히 복사해 기재하고 저장합니다:
  function ag { agy $args } function agd { agy --dangerously-skip-permissions $args } function agr { agy --continue --dangerously-skip-permissions $args }

파워셸 스크립트 실행 권한 차단 보안 에러

단축 프로필을 로드할 때 보안 제한 정책(Execution Policies) 때문에 발생하는 경고 현상입니다.

• 윈도우의 기본 파워셸 설정은 외부 파일 실행을 차단하므로 에러가 출력됩니다.
• 아래 경로에서 실행 권한을 우회하기 위해 다음 권한 해제 코드를 적용합니다.
  C:\Users\...Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1

파워셸 스크립트 실행 정책 우회 명령 수행

로컬에 저장된 사용자 프로필 스크립트 실행을 허가하기 위해 보안 환경을 조정합니다.

• 파워셸 창에 아래 명령을 타이핑하고 엔터를 칩니다:
  Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
• 이 명령은 내 PC에서 내가 서명하고 보존한 코드 파일 실행을 해제해 줍니다.

실행 정책 변경 최종 확인 서명

환경 변경 사항의 보안 경고문을 자세히 읽고 영구 활성화를 선언합니다.

• 콘솔창에 최종 변경 질문이 제시되면 'Y'(예) 또는 'A'(모두 예)를 입력하고 확인을 마칩니다.
• 이제부터 파워셸 실행 시 `ag` 단축어를 통해 에이전트를 즉각 구동하여 개발을 진행할 수 있습니다.

교육과정 PDF 폴더 경로 복사

가상 실험 교구 기획의 토대가 되는 성취기준 PDF 파일이 위치한 파일 디렉토리 주소를 복사합니다.

• 윈도우 탐색기 주소창을 클릭하여 교육과정 문서가 존재하는 절대 경로를 획득해 둡니다.
• 터미널에서 에이전트(agy)를 가동한 뒤 이 경로를 전달할 준비 단계를 마칩니다.

교육과정 PDF 데이터 텍스트 추출 지시

에이전트에게 PDF 전체 텍스트에서 학년군별 생물 성취기준 구절을 파싱하도록 명령을 보냅니다.

• 에이전트 창에 복사한 주소를 전달하며 교육과정 본문을 마크다운 텍스트로 분리해 달라고 지시합니다.
• 에이전트가 내부적으로 스크립트를 가동해 수백 페이지의 PDF 중 과학과 핵심 구절을 마크다운으로 추출합니다.

분리 생성된 교육과정 마크다운 파일 검토

에이전트가 완성해 둔 텍스트 추출본 파일 구조를 에디터 상에서 살펴봅니다.

• 추출 완료된 마크다운 결과 문서를 엽니다.
• 해설서 속의 중학교 과학 생명과학 분야 성취기준 조항이 텍스트 형태로 저장된 모습을 확인합니다.

작업 워크플로우를 신규 에이전트 스킬로 등록

향후에도 동일한 분석 단계를 재사용할 수 있도록 스킬 등록 명령어를 실행합니다.

• 에이전트에게 "지금 진행한 PDF 교육과정 분리 분석 과정을 재사용 가능한 스킬로 생성해줘"라고 지시합니다.
• 스킬 크리에이터가 작동하여 현재 대화와 코딩 흔적을 정식 스킬로 빌드하기 시작합니다.

자동 생성된 스킬 명세서 검사

에이전트 전용 커스텀 스킬 폴더 하위에 생성 완료된 지침을 조회합니다.

• `.agents/skills/` 폴더 밑에 생성된 SKILL.md 파일을 열어 동작 메커니즘을 점검합니다.
• 명세된 요건대로 과학과 교육과정 분해 스킬 구조가 정상 기입되었는지 확인합니다.

koreanssam.kr 접속

• 인터넷 브라우저 주소창에 아래 주소를 입력하거나 클릭하여 이동합니다.
  🌐 koreanssam.kr 접속하기 

공유 스킬 모음(GAS skills) 링크 확인

수업 시뮬레이터 설계 및 PRD 생성을 자동화해 주는 전용 스킬 다운로드 영역을 찾아갑니다.

• 아래 공유 사이트 메뉴 내의 GAS skills 안내 부문으로 바로 들어갑니다.
  📂 koreanssam.kr/sharing 바로가기
• 이 스킬은 에이전트에 장착하면 기획서 구성을 대화형으로 빌드해 주는 특화 지침서입니다.

스킬셋 깃허브 오픈소스 URL 주소 복사

내 PC 로컬 환경에 스킬셋을 그대로 긁어오기 위한 깃허브 주소를 획득합니다.

• 배포용 GitHub 웹 저장소 화면에서 HTTPS 복사 버튼을 눌러 레포지토리 주소를 획득합니다.
• 이 주소 공유를 통해 터미널 명령어 한 줄로 연동을 진행할 수 있습니다.

에이전트에 외부 공유 스킬 등록 수행

에이전트 대화창에 복사한 주소를 넘겨주며 원격 스킬들을 자동으로 내려받도록 지시합니다.

• 파워셸의 agy 대화 창에 아래와 같이 입력하여 스킬 파일들을 다운로드하고 탑재합니다.
• 에이전트가 로컬 `.agents/skills/` 하위에 해당 지침을 이식하고 작동 검증을 완료합니다.

gas-prd-assistant 스킬을 이용해 기획 요청

내려받은 기획 스킬을 작동시켜 성취기준 기반의 교구 기획 설계서 구성을 명령합니다.

• 에이전트에게 `gas-prd-assistant` 스킬을 사용하여 시뮬레이션 웹 기획안을 빌드하라고 지시합니다.
• 에이전트가 해당 스킬을 인식해 기획서 작성을 위한 양방향 질문 모드로 대화를 변경합니다.

기획 설계 요건 질의응답 (1단계)

에이전트 비서가 요구하는 성취기준 종류와 사용 모델 레벨 질문에 답을 구상합니다.

• 에이전트가 PRD 작성을 위해 필요한 첫 번째 타겟 성취기준 및 활동 중심 형태를 물어옵니다.
• 이에 대해 원하는 시뮬레이터 조작 범위를 대화식으로 기재해 나가면서 설계 방향성을 조율합니다.

추가 기능 요구사항 구체화

작동 제어 옵션(재생/정지, 퀴즈, 차트 등) 중 필수 탑재할 사양을 최종 조율합니다.

• 추가적인 조작 매개변수 종류와 대시보드 퀴즈 모드 탑재 유무에 대해 정보를 제공합니다.
• 답변이 완료되면 에이전트가 이를 모아 프로젝트 요구사항 정의서(PRD.md)를 완성해 줍니다.

구글 스프레드시트 신규 파일 생성

앱스 스크립트 웹 앱을 배포하기 위한 환경 조성을 위해 구글 스프레드시트 창을 호출합니다.

• 인터넷 주소창에 아래 도메인을 쳐서 새로운 구글 스프레드시트를 생성합니다.
  sheets.new
• 구글 클라우드에서 교안 프로그램을 즉각 배포하여 학생들이 접속하게 만들기 위한 첫 단계입니다.

구글 앱스 스크립트(Apps Script) 편집기 진입

시뮬레이터를 웹 주소로 서빙해 줄 클라우드 코드 편집 공간을 기동합니다.

• 구글 시트 메뉴 창에서 '확장 프로그램' 클릭 후 'Apps Script' 메뉴를 클릭합니다.
• 자바스크립트 및 HTML을 입력하고 컴파일할 수 있는 웹 기반 에디터 개발 창이 나타납니다.

백엔드 Code.gs 파일 제어 코드 입력

웹 브라우저의 최초 접속 요청(GET)을 받아 화면을 로드해 주는 백엔드 구조를 선언합니다.

• 기본으로 열려 있는 `Code.gs` 소스 창의 텍스트 내용을 지웁니다.
• 에이전트가 완성해 준 서버 측 진입 포인트(doGet 함수 등) 코드를 붙여넣습니다.

새로운 프론트엔드 리소스 파일 추가

사용자가 마주할 웹 인터페이스 화면을 코딩하기 위해 리소스를 만듭니다.

• 앱스 스크립트 파일 목록 패널 좌측의 '+' 아이콘 단추를 클릭합니다.
• 어떤 파일 형식을 추가할지 묻는 옵션 툴팁이 노출됩니다.

리소스 파일 유형을 HTML로 설정

화면의 레이아웃, 조작 패널, 연동 차트가 구현될 HTML 템플릿 종류를 선택합니다.

• 옵션 목록에서 'HTML' 버튼을 클릭하여 소스 파일을 생성합니다.
• 이 파일이 웹 브라우저에서 실행되어 가상실험실 화면을 그려내게 됩니다.

HTML 파일명을 index로 지정

DoGet 진입 서버 코드와 일관되도록 프론트엔드 진입 파일 이름을 규정합니다.

• 생성된 HTML 리소스의 이름을 타이핑하여 아래와 같이 확정합니다.
  index
• 파일명 지정을 마치면 백엔드와 연결하여 가동할 기본 틀이 완료됩니다.

에이전트가 빌드한 index.html 전체 코드 붙여넣기

에이전트가 최종 완성하여 건네준 고기능 프론트엔드 전체 코드를 본문에 대치합니다.

• 생성된 index.html 창의 기존 마크업을 모두 소거합니다.
• 에이전트와 대화하며 기획 완성해 두었던 가상실험 UI 및 애니메이션 논리 코드를 복사하여 넣습니다.

앱스 스크립트 프로젝트 전체 저장

작성된 Code.gs 백엔드와 index.html 프론트엔드의 세부 내용을 세션 메모리에 영구 저장합니다.

• 에디터 상단 컨트롤 툴바 메뉴에서 '저장 프로젝트' 아이콘을 클릭합니다.
• 코드가 온전히 저장되어야만 배포 완료 시 정상적으로 최신 내용이 웹 화면에 반영됩니다.

배포 관리 메뉴 호출

가상실험 코드를 퍼블릭 망에 게시하여 고유 접속 URL 주소를 얻기 위한 배포 절차에 진입합니다.

• 에디터 우측 상단의 파란색 '배포' 단추를 누르고 '새 배포' 링크를 클릭합니다.

새 배포(New Deployment) 생성

프로젝트 소스를 새로운 실행 상태의 웹 링크로 퍼블리싱하는 새 배포 절차를 시작합니다.

• 배포 설정 모달 창 왼쪽의 기어 모양 설정 아이콘을 누르고 '새 배포' 메뉴를 기동합니다.

배포 유형을 '웹앱'(Web App)으로 지정

외부 브라우저에서 다이렉트로 접속하여 기동할 수 있는 단독 웹앱 호스팅 형태로 배포 방식을 타겟팅합니다.

• 배포 유형 종류 중 '웹앱' 옵션을 설정하여 빌드 매핑을 진행합니다.

웹앱 접속 권한을 '모든 사용자'로 변경

학생들이 로그인 없이 즉각 접속해서 실습을 가동할 수 있도록 공개 범위 권한을 해제합니다.

• 액세스 권한 설정 란에서 '모든 사용자'로 공개 정책 범위를 변경합니다.

새로운 배포 생성 실행

작성된 코드 내용과 액세스 공개 정책을 묶어 구글 클라우드 인프라에 업로드를 선언합니다.

• 하단에 활성화된 파란색 '배포' 버튼을 클릭하여 최종 퍼블리싱을 단행합니다.

스프레드시트 연동 액세스 권한 승인

웹앱 구동 시 내부 스프레드시트 데이터베이스 제어 승인을 구글 세션에 요청합니다.

• 중앙의 '액세스 승인' 팝업을 클릭하여 계정 사용 권한 체결 단계에 돌입합니다.

구글 미확인 앱 보안 경고 대응

개발자 미등록 커스텀 스크립트이기 때문에 뜨는 보호 경고문을 우회 처리합니다.

• 'Google hasn't verified this app' 안전 경고 화면 좌측의 'Advanced' 텍스트를 클릭합니다.

프로젝트 강제 진입(unsafe) 선택

경고 우회 조치 단계로, 프로젝트 내부 코드를 안전하게 계속 로드할 것을 지시합니다.

• 설명 영역 하단의 'Go to 제목 없는 프로젝트 (unsafe)' 버튼을 클릭해 진행합니다.

구글 계정 사용 권한 최종 승인(Allow)

스크립트가 내 계정의 스프레드시트에 접근하고 구동될 수 있도록 최종 인가를 허용합니다.

• 보안 요건 설명 페이지 하단의 'Allow' 또는 'Continue' 버튼을 클릭해 연동을 마칩니다.

배포 완료된 라이브 웹앱 주소 실행

성공적으로 발급된 URL 고유 호스팅 경로 링크를 클릭해 교사용 라이브 시뮬레이터를 켭니다.

• 성공 완료창에 발급된 웹앱 URL을 마우스 클릭하여 구동을 테스트합니다.
• 스마트폰이나 태블릿 등 모바일 접속 주소로 이 링크를 공유해 주면 실습이 종료됩니다.