메뉴
AI_server(원격 개발 서버)에서 Bitda API를 기동하여 Swagger(/v3/api-docs) JSON을 수집하고 로컬로 가져오는 스킬입니다. 로컬 Docker가 없거나 느릴 때 사용합니다. 이 스킬은 다음 상황에서 사용됩니다: - 로컬 Docker 인프라가 없을 때 - AI_server의 원격 DB를 기준으로 Swagger 스냅샷이 필요할 때 - 사용자가 "원격 swagger 스냅샷", "AI_server swagger" 등을 요청할 때
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | swagger-snapshot-remote |
| description | AI_server(원격 개발 서버)에서 Bitda API를 기동하여 Swagger(/v3/api-docs) JSON을 수집하고 로컬로 가져오는 스킬입니다. 로컬 Docker가 없거나 느릴 때 사용합니다. 이 스킬은 다음 상황에서 사용됩니다: - 로컬 Docker 인프라가 없을 때 - AI_server의 원격 DB를 기준으로 Swagger 스냅샷이 필요할 때 - 사용자가 "원격 swagger 스냅샷", "AI_server swagger" 등을 요청할 때 |
AI_server에서 Bitda API를 기동하여 Swagger JSON을 수집하고 로컬로 가져오는 스킬.
로컬 swagger-snapshot 스킬의 원격 실행 버전.
| 상황 | 사용할 스킬 |
|---|---|
| 로컬 Docker 가동 중 | swagger-snapshot |
| 로컬 Docker 없음 / 원격 DB 사용 | swagger-snapshot-remote (이 스킬) |
배경: AI_server는 PostgreSQL·Keycloak 컨테이너 상시 가동 중. Notion MCP는 로컬에서만 동작하므로 스냅샷만 원격에서 수집 후 로컬로 복사.
ssh AI_server 접속 가능bitda-postgres, bitda-keycloak)1. [local] 코드 동기화 (tar over ssh) — rsync 금지 (한글 파일명 NFD/NFC 문제)
2. [remote] git init (generateGitProperties 태스크 필요)
3. [remote] swagger-snapshot.sh 실행 (LC_ALL=en_US.UTF-8 필수)
4. [local] scp로 api-docs.json 가져오기
5. [local] /api-to-notion 실행
# 1. 코드 동기화 (tar over ssh)
ISSUE=1710 # 이슈 번호 또는 작업명
ssh AI_server "rm -rf ~/bitda-work-${ISSUE} && mkdir ~/bitda-work-${ISSUE}"
cd /path/to/local/worktree
tar --exclude='.gradle' --exclude='build' --exclude='.idea' --exclude='.git' -cf - . \
| ssh AI_server "cd ~/bitda-work-${ISSUE} && tar -xf -"
# 2. Git 초기화 (Spring Boot generateGitProperties 태스크 요구)
ssh AI_server "cd ~/bitda-work-${ISSUE} && git init -q && git add -A && git commit -q -m 'snapshot'"
# 3. 원격 스냅샷 수집
# ⚠️ LC_ALL=en_US.UTF-8 필수 — AI_server의 native.encoding이 ASCII여서
# 한글 파일명이 ?로 변환됨. LC_ALL이 sun.jnu.encoding을 UTF-8로 강제.
ssh AI_server "export LANG=en_US.UTF-8 LC_ALL=en_US.UTF-8 && cd ~/bitda-work-${ISSUE} && bash .claude/skills/swagger-snapshot/scripts/swagger-snapshot.sh"
# 출력 마지막 줄: SNAPSHOT_DIR=/tmp/bitda-swagger-snapshot/{ts}
# 4. 로컬로 복사 (ts는 위 출력값)
TS=20260527_063000 # 위에서 확인한 timestamp
mkdir -p /tmp/bitda-swagger-snapshot/${TS}
scp "AI_server:/tmp/bitda-swagger-snapshot/${TS}/api-docs.json" \
"/tmp/bitda-swagger-snapshot/${TS}/api-docs.json"
# 5. /api-to-notion 실행 (로컬에서)
tar 사용 (NFD 바이트 그대로 보존)주류반출명세서.xlsx 등) 인코딩 보호native.encoding이 ASCII?로 변환되어 processResources 태스크 MD5 해시 실패LC_ALL=en_US.UTF-8 설정으로 sun.jnu.encoding을 UTF-8로 강제generateGitProperties 태스크가 git 메타데이터 요구.git 제외했으므로 원격에서 빈 init + 1 commit 생성swagger-snapshot: 로컬 실행용 (스크립트는 공유)api-to-notion: 이 스킬로 수집한 스냅샷을 Notion에 업로드docs/standards/remote-testing-policy.md §3: AI_server 원격 작업 정책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" 등을 요청할 때