메뉴
Bitda API 서버를 임시 포트로 기동하여 Swagger(/v3/api-docs) JSON을 수집하고 임시 폴더에 저장하는 스킬입니다. 수집된 스냅샷은 후속 스킬의 입력 데이터로 활용됩니다. 이 스킬은 다음 상황에서 사용됩니다: - Swagger JSON 스냅샷이 필요할 때 - API 문서 동기화 전 최신 API 명세를 수집할 때 - 사용자가 "swagger 스냅샷", "API 스냅샷", "api-docs 수집" 등을 요청할 때
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
jh_kim dev 계정(dev Keycloak)으로 E2E API 테스트를 수행하는 스킬입니다. 로컬 main 빌드 API + dev DB + dev Keycloak PKCE 토큰 조합으로, dev API 서버에 아직 배포되지 않은 머지 코드를 실데이터 환경에서 검증할 때 사용합니다. "/e2e-test-dev", "dev 계정으로 E2E", "jh_kim으로 API 테스트", "dev DB로 E2E 테스트" 등을 요청할 때 사용됩니다. (로컬 Docker Keycloak 기반 테스트는 e2e-test 스킬 사용)
plan-master(기획용 FE 코드 + docs/specs 기획서)와 bitda-back(구현된 BE 코드) 사이의 갭을 분석하여 누락된 기능·API·정책을 GitHub 이슈로 자동 생성하는 스킬입니다. 기획서→이슈 전달 과정에서 발생하는 누락을 방지하기 위해 FE 코드를 1차 소스로 사용합니다. "/gap-analyze", "/gap-analyze BOM", "/gap-analyze production" 등을 요청할 때 사용됩니다.
plan-master FE 코드만을 유일한 1차 소스로(기획서 .md 배제) 멀티팀 에이전트가 BE가 보장해야 할 비즈니스 로직과 FE 작업에 필요한 API 항목을 도출하고, 총괄 에이전트가 bitda-back BE 구현과 실측 대조하여 누락 갭을 발굴, 직렬 verifier로 확정한 뒤 GitHub 이슈로 생성하는 스킬입니다. gap-analyze의 변종으로, 기획서가 구현완료를 선언해 갭을 가리는 오염을 제거하기 위해 기획서를 의도적으로 보지 않습니다. /gap-fe-code 생산현황, 기획서 빼고 FE 코드로 갭 분석, FE 코드만 보고 누락 API 이슈 만들어 등을 요청할 때 사용됩니다.
실제 API 서버(8080 포트)를 실행하고 Keycloak OAuth 인증을 통해 E2E API 테스트를 수행하는 스킬입니다. 테스트 결과와 요청/응답을 docs/e2e-test/{test}/ 디렉토리에 markdown 형식으로 기록합니다. 이 스킬은 다음 상황에서 사용됩니다: - 특정 API의 실제 동작을 테스트하고 싶을 때 - API 변경 후 실제 환경에서 검증이 필요할 때 - 사용자가 "E2E 테스트", "API 테스트", "/e2e-test" 등을 요청할 때
Creates phase-based feature plans with quality gates and incremental delivery structure. Use when planning features, organizing work, breaking down tasks, creating roadmaps, or structuring development strategy. Keywords: plan, planning, phases, breakdown, strategy, roadmap, organize, structure, outline.
Swagger 스냅샷(api-docs.json)과 코드베이스를 기반으로 Notion API 맵핑 DB에 API 문서를 등록하고 상세 페이지를 작성하는 스킬입니다. (notion-api.py REST wrapper 사용 버전) 이 스킬은 다음 상황에서 사용됩니다: - 특정 API를 Notion에 문서화할 때 (MCP 비활성화 환경) - mcp__notion__* 도구 deprecated/불안정한 경우 - 사용자가 "api 노션 등록 (api 모드)", "/api-to-notion-api" 등을 요청할 때
| name | swagger-snapshot |
| description | Bitda API 서버를 임시 포트로 기동하여 Swagger(/v3/api-docs) JSON을 수집하고 임시 폴더에 저장하는 스킬입니다. 수집된 스냅샷은 후속 스킬의 입력 데이터로 활용됩니다. 이 스킬은 다음 상황에서 사용됩니다: - Swagger JSON 스냅샷이 필요할 때 - API 문서 동기화 전 최신 API 명세를 수집할 때 - 사용자가 "swagger 스냅샷", "API 스냅샷", "api-docs 수집" 등을 요청할 때 |
Bitda API 서버를 사용하지 않는 임시 포트로 기동하여 /v3/api-docs Swagger JSON을 수집하고, 타임스탬프 기반 임시 폴더에 저장하는 스킬.
./docker/start.sh)scripts/swagger-snapshot.sh 스크립트를 실행하여 자동으로 처리:
bash .claude/skills/swagger-snapshot/scripts/swagger-snapshot.sh
스크립트가 수행하는 작업:
local 프로필로 Spring Boot 앱을 백그라운드 기동http://localhost:{port}/v3/api-docs 에서 Swagger JSON 수집/tmp/bitda-swagger-snapshot/{YYYYMMDD_HHMMSS}/ 에 저장스크립트 종료 후 마지막 줄에 SNAPSHOT_DIR=... 형태로 경로가 출력됨.
출력 디렉토리 구조:
/tmp/bitda-swagger-snapshot/{timestamp}/
├── api-docs.json ← Swagger JSON (핵심 파일)
├── snapshot-meta.json ← 메타 정보 (포트, 프로필, 타임스탬프)
└── boot.log ← Spring Boot 기동 로그 (문제 발생 시 디버깅용)
수집된 api-docs.json 경로를 후속 스킬에 전달하여 입력 데이터로 활용.
스크립트에 기본값이 내장되어 있어 별도 설정 없이 실행 가능. 필요 시 환경 변수로 오버라이드:
| 변수 | 기본값 |
|---|---|
JWT_ALLOWED_AUDIENCES | bitda-api-server,bitda-admin-app,bitda-liquor-app,bitda-tax-app,bitda-manufact-app |
KEYCLOAK_API_SERVER_CLIENT_ID | bitda-api-server |
KEYCLOAK_API_SERVER_CLIENT_SECRET | bitda-api-server-secret-12345 |
POSTGRES_USER | bitda_api |
POSTGRES_PASSWORD | .env.jenkins의 POSTGRES_PASSWORD 값 (하드코딩 금지) |
🔐 크리덴셜:
POSTGRES_PASSWORD등 비밀값은 저장소 루트.env.jenkins(git-ignored)에서 로드한다. 실행 전set -a; . /Users/gimjinhyeog/Desktop/coding/bitda-back/.env.jenkins; set +a.
docker ps → PostgreSQL, Keycloak 컨테이너 확인boot.log 확인: cat /tmp/bitda-swagger-snapshot/{timestamp}/boot.log | tail -100boot.log에서 마이그레이션 진행 상태 확인/tmp/bitda-swagger-snapshot/ 하위에 타임스탬프별로 저장되므로 이전 스냅샷도 보존됨