Antigravity Awesome Skills 실무 활용 가이드 (Top 20 + 예시)

Antigravity Awesome Skills 실무 활용 가이드 (Top 20 + 예시)

스킬은 GEMINI.md의 프로젝트 규칙과 자동 결합됩니다.
아래 모든 예시는 UnivEsGWSolution 기술 스택 기준으로 작성되었습니다.

---

🛠️ SECTION 1. 개발 및 설계

---

1. @squirrel — 풀사이클 자율 에이전트

계획 → 구현 → 테스트 → 린트 → 문서화까지 8단계를 자율 수행. 기능 전체를 통째로 위임할 때 사용.

💬 실무 예시:

@squirrel 을 실행해줘.
목표: '직원 연차 관리' 신규 피처를 처음부터 끝까지 만들어줘.
- 10단계 구현 프로세스를 준수할 것
- Domain Entity: VacationRequest (직원ID, 시작일, 종료일, 승인상태)
- Repository: IVacationRequestRepository (Dapper 기반, BaseRepository 상속)
- CQRS: CreateVacationRequestCommand → ValueTask<Unit> 반환
- Controller: POST /api/vacation/request
- View: Vue 3 CDN IIFE 패턴 적용, v-text/v-on:click 사용 ({{ }} 금지)

---

2. @api-endpoint-builder — API 엔드포인트 자동화

백엔드 엔드포인트를 CQRS+Dapper+Mapperly 규격에 맞게 뼈대부터 완성까지 작성.

💬 실무 예시:

@api-endpoint-builder 를 사용해서 부서 코드별 직원 목록 조회 엔드포인트를 만들어줘.
- CQRS Nested 구조 (실제 프로젝트 패턴):
    public static class GetEmployeeListByDept {
        public class Query : IQuery<IEnumerable<EmployeeDto>> { ... }
        public class Handler : IQueryHandler<Query, IEnumerable<EmployeeDto>> {
            public ValueTask<IEnumerable<EmployeeDto>> Handle(Query q, CancellationToken ct) { ... }
        }
    }
- Repository: FindByDeptCodeAsync(string deptCode, IDbTransaction? trans = null)
  (BaseRepository<Employee, int, IEmployeeRepository> 상속)
- SQL: GWProjects/DatabaseScripts/SqlQueries/Employee/GetEmployeeListByDept.sql 외부화
  → ISqlQueryCacheService로 캐시 조회
- Mapperly: GW.Application/Features/HumanResource/{SubFeature}/EmployeeMappings.cs
  (파일명 패턴: {Domain}Mappings.cs, static partial class에 [Mapper] 어트리뷰트)
- Controller: GET /api/employees?deptCode=xxx (Presentation → Application 계층만 참조)

---

3. @tdd — 테스트 주도 개발

Red → Green → Refactor 사이클로 코드를 안전하게 개발.

💬 실무 예시:

@tdd 를 시작해줘.
기능: VacationRequestRepository의 FindPendingByEmployeeAsync 메서드
1. [Red] 아직 없는 메서드에 대해 실패하는 테스트 먼저 작성
   - Dapper QueryAsync<T>(CommandDefinition) 오버로딩 사용
   - IDbTransaction? trans 파라미터 포함 검증 (Pattern H)
   - 반환: ValueTask<IEnumerable<VacationRequest>>
2. [Green] 최소 코드로 테스트 통과
3. [Refactor] BaseRepository<VacationRequest, int, IVacationRequestRepository> 상속 패턴에 맞게 정리

---

4. @prototype — 빠른 프로토타이핑

아이디어를 검증하기 위한 UI/로직의 빠른 초안 생성.

💬 실무 예시:

@prototype 으로 '협업 문의 등록' 폼 UI 초안을 빠르게 만들어줘.
- Razor View(.cshtml) 기반
- Vue 3 IIFE 패턴, window.*Init으로 서버 데이터 수신
- 필드: 제목(text), 카테고리(Select2), 내용(TUI Editor), 첨부파일(FilePond)
- axios POST 요청으로 /api/coop/inquiry 호출
완성도보다 전체 흐름 파악에 집중해줘.

---

5. @improve-codebase-architecture — 아키텍처 점진적 개선

레거시 코드를 최신 룰(ValueTask, Mapperly, Scrutor)에 맞게 안전하게 리팩토링.

💬 실무 예시:

@improve-codebase-architecture 로 아래 파일을 리팩토링해줘.
파일: GWProjects/GW.Infrastructure/Repositories/Board/OldNoticeRepository.cs
현재 문제:
  - Task<T> 반환 → ValueTask<T>로 전환
  - AutoMapper 사용 중 → Application/Features/Board/ 하위 Mapperly static partial class로 교체
  - DI를 직접 new 키워드로 생성
    → Scrutor 자동 스캔 대상으로 전환 (Name 접미사 "Repository" 조건 충족 시 자동 등록)
    → 단, SqlQueryCacheService처럼 Singleton이 필요한 경우엔 DependencyInjection.cs 수동 등록
레이어 의존성 방향: Infrastructure → Domain + Application 참조 (Application만 참조 아님)

---

🐛 SECTION 2. 디버깅 및 품질 관리

---

6. @bug-hunter — 체계적인 버그 추적

증상 → 재현 → 근본 원인 → 최소 픽스 → 재발 방지 테스트 순서로 접근.

💬 실무 예시:

@bug-hunter 를 실행해줘.
증상: 전자결재 문서번호 클릭 시 CommonDocumentDetailPopup이
      가끔 빈 화면으로 열림 (재현율 약 30%)
의심 구간:
  - gwApi.get('/api/document/{documentNumber}') 응답 타이밍
  - Vue의 v-if 조건과 데이터 로딩 순서 충돌
재현 환경: Chrome 최신, 세션 로그인 상태 유지 중

---

7. @diagnosing-bugs — 전 레이어 장애 진단

프론트엔드 axios 호출부터 DB 프로시저까지 전체 스택을 흐름 추적.

💬 실무 예시:

@diagnosing-bugs 를 시작해줘.
증상: PMS 복합 입력 폼 저장 시 500 Internal Server Error 발생
흐름:
  1. Vue → axios POST /api/pms/save (payload: 대형 XML 문자열)
  2. Controller → CreatePmsCommand dispatch
  3. Handler → IDistributedTransactionService 수동 트랜잭션 시작
  4. ERP Repository → 프로시저 EXEC [__ERP_DATABASE__].dbo.SP_PMS_SAVE
각 단계별로 실패 가능 지점을 진단하고 확인 체크리스트를 만들어줘.

---

8. @performance-optimizer — 성능 병목 최적화

성능을 측정하고 Before/After를 비교하며 코드 최적화.

💬 실무 예시:

@performance-optimizer 를 실행해줘.
문제: 매출 현황 화면에서 RealGrid 3개 인스턴스(연간/월간/일간)가
      동시에 초기화될 때 첫 렌더링이 3~4초 소요됨.
측정 대상:
  - 백엔드: 다중 DB 조인 쿼리 (ISqlQueryCacheService 캐시 적중률 확인)
  - 프론트엔드: Vue mounted() 훅에서 3개 gwApi 동시 호출 vs 순차 호출
  - RealGrid: setDataSource 호출 타이밍과 컬럼 렌더링 순서

---

9. @logic-lens — 논리 기반 딥 코드 리뷰

아키텍처 결함, 상태 관리 오류, 보안 취약점을 논리적으로 심층 분석.

💬 실무 예시:

@logic-lens 로 아래 핸들러를 리뷰해줘.
파일: GWProjects/GW.Application/Features/Coop/Inquiry/CreateInquiry.cs
  (실제 패턴: static class CreateInquiry { public class Command; public class Handler })
집중 검토 항목:
  - Handler 생성자에서 인스턴스 필드로 상태를 저장하지 않는지
    (의존성 주입 필드는 허용, 업무 상태 저장은 금지)
  - GW.Domain.Entities.Coop 모델이 Controller/View로 직접 반환되지 않는지
    (InquiryMappings.cs를 통해 DTO 변환 후 반환해야 함)
  - IDistributedTransactionService trans 파라미터가 모든 Repository 호출에 전파되는지
  - ValueTask<long> 또는 ValueTask<Unit> 반환 시 올바른 반환값 사용 여부
  - Handler가 Scoped로 등록되어 Singleton 의존성을 캡처하지 않는지

---

10. @brooks-lint — 클래식 소프트웨어 공학 리뷰

과도한 결합도, 설계 악취, 단일 책임 원칙 위반 등을 명저 원칙으로 진단.

💬 실무 예시:

@brooks-lint 로 아래 파일의 설계를 검토해줘.
파일: GWProjects/GW.Infrastructure/Repositories/Finance/ErpSalesRepository.cs
  (ErpBaseRepository<TEntity, TKey, TLogger> 상속 클래스)
이 파일이:
  - 단일 책임 원칙(SRP)을 위반하진 않는지
  - ERP 다중 DB 처리를 위해 [__ERP_DATABASE__] 플레이스홀더를
    .sql 파일 안에서만 사용하고 있는지 (인라인 SQL에서 직접 쓰는 것은 금지)
  - 너무 많은 메서드가 한 파일에 집중되어 God Class 문제가 있진 않은지

---

11. @codebase-audit-pre-push — 커밋 전 안전 검사

변경 파일을 줄 단위로 검사하여 잘못된 코드가 운영 환경에 배포되는 것을 방지.

💬 실무 예시:

@codebase-audit-pre-push 를 실행해줘.
오늘 변경된 파일 목록 대상으로:
  ✅ Razor .cshtml에서 {{ }}, @click 사용 금지 → v-text, v-on:click 으로 교체 여부
  ✅ :key 사용 금지 → v-bind:key 로 교체 여부 (Razor @ 충돌 방지)
  ✅ fetch()/XHR 사용 금지 → axios/gwApi (timeout:30000, withCredentials:true) 사용 여부
  ✅ console.log, 디버그용 TODO, 임시 하드코딩된 접속 정보 검사
  ✅ new 키워드로 Repository/Handler 직접 생성하는 코드 (Scrutor 위반) 검사
  ✅ using EFCore / MediatR / AutoMapper namespace 사용 여부
  ✅ dayjs import 구문 사용 금지 → dayjs 전역 변수로만 사용 여부

---

⚡ SECTION 3. 생산성 및 컨텍스트 최적화

---

12. @cavecrew — 서브 에이전트 분업화

간단한 1~2개 파일 작업이나 위치 탐색을 서브 에이전트에게 위임하여 메인 컨텍스트를 아낌.

💬 실무 예시:

cavecrew investigator에게 위임:
"GWProjects/GW.Infrastructure/Repositories/ 하위에서
 IDistributedTransactionService를 주입받아 사용하는 Repository를
 전부 찾아서 파일명과 메서드명 목록만 반환해줘."

cavecrew builder에게 위임:
"GWProjects/GW.Domain/Entities/Notice.cs 파일에
 IsDeleted(bool, 기본값 false) 속성 하나만 추가해줘.
 [Table] 어트리뷰트와 Korean XML doc 주석도 기존 스타일에 맞게 달아줘."

---

13. @caveman-review — 초압축 코드 리뷰

PR 리뷰를 장황한 설명 없이 [파일:줄] - [문제] - [해결] 한 줄로 압축 피드백.

💬 실무 예시:

@caveman-review 로 아래 diff를 리뷰해줘.
[Git diff 또는 파일 경로 첨부]

기대 출력 예:
CreateCoopHandler.cs:42 - trans 미전파 → FindAsync(id, trans) 로 수정
NoticeRepository.cs:87 - Task<T> 반환 → ValueTask<T> 로 변경
Index.cshtml:34 - {{ title }} 사용 금지 → v-text="title" 로 교체

---

14. @caveman-commit — 초압축 커밋 메시지

Conventional Commits 준수, 잡음 제거, 50자 이내 핵심만 담은 커밋 메시지 생성.

💬 실무 예시:

@caveman-commit 으로 오늘 작업에 대한 커밋 메시지를 만들어줘.
작업 내용:
  - VacationRequestRepository 신규 추가 (Dapper, BaseRepository 상속)
  - CreateVacationRequestCommand 핸들러 구현 (ValueTask<Unit> 반환)
  - 연차 신청 View 추가 (Vue 3 CDN IIFE 패턴)

기대 출력 예:
feat(vacation): add vacation request CQRS and repository layer

---

📂 SECTION 4. 추적, 관리 및 문서화

---

15. @technical-change-tracker — 작업 내역 JSON 트래킹

세션 종료 전, 작업 이력을 JSON으로 기록하여 다음 세션이 끊김 없이 이어짐.

💬 실무 예시:

@technical-change-tracker 를 호출해서 오늘 세션을 닫기 전에
변경 사항을 추적 레코드에 저장해줘.
요약:
  - 신규 파일:
      GWProjects/GW.Domain/Entities/VacationRequest.cs
      GWProjects/GW.Infrastructure/Repositories/Worklife/VacationRequestRepository.cs
      GWProjects/GW.Application/Features/Worklife/Commands/CreateVacationRequestCommandHandler.cs
  - 수정 파일:
      GWProjects/GW.Infrastructure/DependencyInjection.cs
      (Scrutor 자동 스캔으로 처리됨 / SqlQueryCacheService는 Singleton 수동 등록 유지)
  - 미완성: Vacation 승인 핸들러 (다음 세션에서 이어서 작업 예정)
  - 의존성 주의: IDistributedTransactionService trans 파라미터 Repository 전파 미완

---

16. @triage — 이슈 및 버그 우선순위 분류

여러 오류나 작업 항목을 심각도별로 빠르게 분류하고 대응 순서를 정함.

💬 실무 예시:

@triage 를 실행해줘.
현재 미처리 이슈 목록:
  A. CommonDocumentDetailPopup 간헐적 빈 화면 (사용자 민원 접수)
  B. RealGrid 개인화 설정이 일부 사용자에서 저장 안 됨
  C. ERP 매출 쿼리 응답 시간 6초 초과
  D. VacationRequest 기능 개발 미완
  E. 코드 리뷰 미반영 피드백 3건
심각도, 영향 범위, 처리 순서 기준으로 분류해줘.

---

17. @agenttrace-session-audit — AI 세션 감사 및 비용 분석

과거 AI 코딩 세션의 토큰 비용 누수, 툴 실패, 비정상 지연을 분석.

💬 실무 예시:

@agenttrace-session-audit 을 실행해줘.
오늘 세션에서:
  - 토큰 사용량이 많았던 툴 호출이 무엇인지
  - 불필요하게 반복 실행된 파일 읽기가 있었는지
  - 실패하거나 타임아웃된 MCP 툴 호출이 있었는지
  - 전체 세션 비용 및 효율성 리포트를 만들어줘.

---

18. @ax-extract-workflow — 과거 워크플로우 역추적

과거에 AI가 특정 코드를 어떤 맥락과 단계로 작성했는지 역추적하여 문서로 복원.

💬 실무 예시:

@ax-extract-workflow 를 사용해줘.
지난 세션에서 구현된 gw-dalpha-integration 배치 서비스를
어떤 순서로 설계하고 코딩했는지 워크플로우를 역추적해서
팀 내 온보딩 문서로 재구성해줘.

---

🌐 SECTION 5. 확장 및 생태계

---

19. @global-chat-agent-discovery — 외부 MCP & 에이전트 검색

18,000개 이상의 외부 MCP 서버/AI 에이전트 레지스트리에서 필요한 도구를 검색.

💬 실무 예시:

@global-chat-agent-discovery 로 아래 기능을 해주는 MCP 서버를 찾아줘:
  - AWS SES 이메일 발송 상태를 실시간 모니터링하는 도구
  - SQL Server의 실행 계획(Execution Plan)을 AI가 해석해주는 도구
  - SFTP 파일 수집 배치의 헬스체크를 자동화하는 도구
각 도구의 신뢰도 점수와 설치 방법을 함께 알려줘.

---

20. @skill-check — 커스텀 스킬 무결성 검증

직접 작성한 SKILL.md 파일이 agentskills 스펙을 올바르게 준수하는지 배포 전에 검증.

💬 실무 예시:

@skill-check 로 내가 새로 만든 스킬 파일을 검증해줘.
파일: d:\UnivEsGWSolution\.agents\skills\gw-new-feature\SKILL.md
확인 항목:
  - YAML frontmatter에 name, description 필드가 있는지
  - 트리거 키워드가 명확하게 정의되어 있는지
  - 지침이 500줄 이내인지 (초과 시 references/ 분리 권고)
  - 구조적 누락 항목이나 네이밍 문제가 없는지

---

📌 빠른 참조 요약 (Quick Reference)

#	스킬	언제 사용?
1	@squirrel	기능 전체를 처음부터 끝까지 위임
2	@api-endpoint-builder	CQRS + Dapper 엔드포인트 신규 생성
3	@tdd	테스트 먼저 쓰고 코드 개발
4	@prototype	빠른 UI/로직 초안 검증
5	@improve-codebase-architecture	레거시 코드 현대화
6	@bug-hunter	체계적인 버그 추적 및 픽스
7	@diagnosing-bugs	전 레이어 장애 흐름 진단
8	@performance-optimizer	쿼리/렌더링 병목 최적화
9	@logic-lens	아키텍처 결함 딥 리뷰
10	@brooks-lint	설계 악취 및 결합도 진단
11	@codebase-audit-pre-push	커밋 전 안전성 검사
12	@cavecrew	서브 에이전트에 작업 위임
13	@caveman-review	초압축 PR 코드 리뷰
14	@caveman-commit	Conventional Commits 자동 생성
15	@technical-change-tracker	세션 종료 전 작업 이력 저장
16	@triage	이슈 심각도 분류 및 우선순위
17	@agenttrace-session-audit	AI 세션 비용 및 효율 분석
18	@ax-extract-workflow	과거 워크플로우 역추적 및 문서화
19	@global-chat-agent-discovery	외부 MCP/에이전트 검색
20	@skill-check	커스텀 스킬 파일 검증

 

 

 

https://github.com/sickn33/antigravity-awesome-skills

GitHub - sickn33/antigravity-awesome-skills: Installable GitHub library of 1,600+ agentic skills for Claude Code, Cursor, Codex