Elvis Li
Back to all posts
Engineering

규율 있는 AI: Antigravity에 Google의 에이전트 기술(Agent Skills) 주입하기

#ai#software-engineering#antigravity#github

솔직해집시다. AI가 생성한 코드는 빠르지만 유지 관리의 악몽인 경우가 많습니다. Mac에서 Antigravity와 같은 도구를 사용해 본 적이 있다면 속도는 빠르지만 대개 규율이 없다는 것을 알 것입니다.

이 문제를 해결하기 위해 Google의 엔지니어링 리더십은 Agent Skills를 출시했습니다. 이는 AI가 내부 소프트웨어 엔지니어링 표준을 따르도록 강제하는 20개의 원자적 기술과 7개의 명령 세트입니다. 이러한 표준을 로컬 MacBook 환경에 적용하는 방법은 다음과 같습니다.

핵심 가치: 반합리화 (Anti-Rationalization)

AI는 테스트 작성을 피하기 위해 "환각"을 일으키거나 "너무 간단하다"는 이유로 문서화 단계를 건너뛰는 경향이 있습니다.

Agent Skills 프레임워크는 반합리화를 도입합니다. AI가 단계를 건너뛰려고 하면 시스템이 이를 밀어냅니다. 이는 비욘세 규칙(Beyoncé Rule)("좋아했다면 테스트를 거쳤어야 했다")을 적용하고 첫 번째 코드가 작성되기 전에 모든 코드 줄이 사양(Spec)에 의해 뒷받침되도록 합니다.

1. Mac M3 설정

우리는 Apple Silicon을 사용하고 있으므로 도구를 기본으로 유지하고 경로를 깨끗하게 유지하려고 합니다. Homebrew 및 GitHub CLI(gh)부터 시작합니다.

1.1 도구 설치 및 인증

터미널을 열고 다음을 실행하여 환경이 준비되었는지 확인하십시오.

# Homebrew 설치
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Brew가 경로에 있는지 확인
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
eval "$(/opt/homebrew/bin/brew shellenv)"

# GitHub CLI 설치 및 로그인
brew install gh
gh auth login

gh auth login을 실행한 후. 지침을 정확히 따르십시오: GitHub.com 선택 -> HTTPS -> Yes (인증) -> Login with a web browser.

전문가 팁: 터미널에 8자 코드(예: 1234-ABCD)가 출력됩니다. Enter 키를 눌러 브라우저에서 GitHub를 열고 해당 코드를 상자에 붙여넣은 다음 녹색 승인(Authorize) 버튼을 클릭하여 계정을 연결합니다.

1.2 Antigravity에 기술 주입

Antigravity는 새로운 동작을 "학습"하기 위해 특정 디렉토리 구조를 찾습니다. Google의 엔지니어링 표준을 프로젝트의 숨겨진 에이전트 폴더에 직접 복제할 것입니다.

# 프로젝트 루트로 이동
cd ~/your-project-path

# AI 기술을 위한 표준 디렉토리 생성
mkdir -p .agent/skills

# Google Agent Skills 리포지토리 복제
gh repo clone addyosmani/agent-skills .agent/skills/engineering-standards

# 자체 리포지토리에서 추적할 수 있도록 중첩된 git 데이터 정리
rm -rf .agent/skills/engineering-standards/.git

1.3 "두뇌" 활성화

이제 기술이 제자리에 있으므로 이를 깨워야 합니다. Antigravity를 다시 시작하거나 콘솔에서 다음을 실행하기만 하면 됩니다.

/reload-skills

설정 테스트: 이것을 Antigravity 채팅에 드롭하십시오.

"새로운 기능을 시작하고 싶습니다. /spec 기술을 사용하여 요구 사항을 정의하도록 도와주세요."

AI가 단순히 코드를 작성하는 대신 목표, 사용자 시나리오 및 비기능적 요구 사항에 대해 묻기 시작했다면 로컬 환경에 Google의 표준을 성공적으로 주입한 것입니다.

2. Git 모범 사례

팀에서 이와 동일한 기술을 사용하기를 원하지만 AI의 "사고 로그" 또는 세션 데이터로 리포지토리를 오염시키고 싶지는 않을 것입니다. .gitignore에 다음을 추가하십시오.

# --- AI Agent Config ---
# 두뇌의 런타임 데이터 무시
.agent/workspaces/
.agent/logs/
.agent/cache/
.agent/sessions/

# 기술 유지
!.agent/skills/

2.1 심층 분석: Git 전략이 중요한 이유

.gitignore에 대해 왜 그렇게 까다로운지 궁금할 수 있습니다. 이유는 다음과 같습니다.

2.1.1 .agent/skills를 무시해서는 안 되는 이유

agent-skills 폴더는 본질적으로 AI의 "표준 운영 절차"입니다.

일관성: 이 폴더를 커밋하지 않으면 팀원(또는 다른 컴퓨터의 사용자)은 "일반적인" AI만 얻게 됩니다. /spec 또는 /review와 같은 고급 기술에 대한 액세스 권한을 잃게 됩니다.

버전 관리: SKILL.md를 수정하는 경우(예: 필요한 테스트 커버리지를 80%에서 90%로 늘림) 해당 논리는 소스 코드와 함께 유지되고 발전해야 합니다.

2.1.2 다른 하위 디렉토리를 무시해야 하는 이유

개인 정보 및 보안: .agent/sessions 또는 워크스페이스와 같은 폴더에는 원시 대화 기록, 민감한 중간 데이터 또는 작업 프로세스의 스니펫이 포함될 수 있습니다. 그것이 서버에 푸시되는 것을 절대 원하지 않을 것입니다.

유용성 없음: 로그 및 캐시는 로컬에서 생성되며 해당 시스템에만 적용됩니다. 이를 커밋하면 리포지토리가 부풀어 오르고 불필요한 병합 충돌이 발생할 뿐입니다.

3. "챗봇"에서 "엔지니어"로

Antigravity를 다시 시작하면 AI는 더 이상 단순한 챗봇이 아닙니다. "로그인 페이지 만들어줘"라고 말하는 대신 슬래시 명령을 활용하기 시작합니다.

  1. /spec: AI가 기술 사양을 먼저 작성하도록 강제합니다.
  2. /plan: 해당 사양을 작업 목록으로 나눕니다.
  3. /review: "클린 코드" 표준에 대해 작업을 감사합니다.

/spec을 실행하는 데 60초가 더 걸리지만 나중에 기술 부채를 디버깅하는 3시간을 절약할 수 있습니다. M3 Mac을 실행 중이라면 마력이 있습니다. 이제 표준이 있습니다.