菜单
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 스킬 사용)
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
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" 등을 요청할 때
Swagger 스냅샷(api-docs.json)과 코드베이스를 기반으로 Notion API 맵핑 DB에 API 문서를 등록하고 상세 페이지를 작성하는 스킬입니다. 이 스킬은 다음 상황에서 사용됩니다: - 특정 API를 Notion에 문서화할 때 - API 맵핑 DB에 API를 등록하고 상세 페이지를 채울 때 - 사용자가 "API 노션에 등록", "노션 API 문서화", "api-to-notion" 등을 요청할 때
| name | e2e-test-dev |
| description | 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 스킬 사용) |
로컬에서 빌드한 main 코드를 dev DB + dev Keycloak(jh_kim 계정) 으로 E2E 검증한다. 2026-06-12 #2327 검증에서 실증된 절차 그대로다.
| 상황 | 스킬 |
|---|---|
| 로컬 Docker Keycloak 시드 계정(admin)으로 충분 | e2e-test |
| jh_kim 실계정·dev 실데이터 필요 / dev API에 미배포된 main 코드 검증 | 이 스킬 |
| 항목 | 값 |
|---|---|
| dev 서버 | AI_server (ssh alias, <DEV_SERVER_IP>) |
| dev Keycloak | http://auth.invigoworks.co.kr:9090 (로컬 직접 미도달 → --connect-to 필수) |
| 계정 | <DEV_USER> / <DEV_PASSWORD> / bitda-liquor-app |
| org_id | <ORG_ID> |
| 토큰 수명 | 1800s — 만료 시 401, 재로그인 |
| DB 계정 | bitda_api (dev 컨테이너 env에서 추출. jh_kim 개인 DB계정 금지 — 신규 테이블 grant 누락으로 500) |
ssh AI_server "docker exec bitda-api sh -c 'unzip -p /app/app.jar BOOT-INF/classes/git.properties' | grep -E 'commit.id.abbrev|branch'"
git log origin/main --oneline -1
https://auth.invigoworks.co.kr/realms/bitda 여야 함 — 4단계 참고)# 8080 점유 확인 — OrbStack Helper의 CLOSED 소켓은 무시 (LISTEN만 확인)
lsof -nP -iTCP:8080 -sTCP:LISTEN
nohup bash .claude/skills/e2e-test-dev/scripts/start-api-devdb.sh > /tmp/api_server.log 2>&1 &
# 준비 대기 (actuator 8081)
until curl -s -m 2 http://localhost:8081/actuator/health | grep -q '"status":"UP"'; do sleep 3; done
스크립트가 처리하는 함정 (수동 기동 시에도 동일 적용):
spring.flyway.enabled=false — local 프로파일 seed가 dev DB 오염 방지bitda_api (비번은 ssh AI_server docker exec bitda-api env 에서 자동 추출)--no-daemon — orphan JVM = 500 유령 방지bash .claude/skills/e2e-test-dev/scripts/dev-login.sh
# → /tmp/bitda-e2e/access_token.txt
내장 함정 처리 (스크립트가 모두 처리하나, 디버깅 시 인지 필요):
grant_type=password 는 unauthorized_client. PKCE auth-code flow만 가능--connect-to "auth.invigoworks.co.kr:9090:<DEV_SERVER_IP>:9090" (zsh에서 배열로 전달 — unquoted 변수는 분할 안 됨)T=$(cat /tmp/bitda-e2e/access_token.txt)
curl -s -H "Authorization: Bearer $T" "http://localhost:8080/api/v1/..."
Idempotency-Key: $(uuidgen) 헤더 필수http://auth.invigoworks.co.kr:9090/realms/bitda.
dev API 직접 호출 시엔 INVALID_ISSUER (dev API는 https://... 무포트 기대) —
dev API 직접 테스트면 https://auth.invigoworks.co.kr (443, 공개 도달 가능)로 토큰 발급e2e-test 스킬과 동일: 케이스 표로 정리 → dev DB 실데이터 쓰기 발생 명시 → 사용자 승인 후 실행.
status='CONFIRMED', 용도별 purpose). 쓰기경로 검증은 DB row만으로 충분
ssh AI_server "docker exec bitda-postgres psql -U bitda_api -d bitda -t -A -c \"INSERT ... RETURNING id;\""
docs/e2e-test/{test-name}/README.md + responses/ (e2e-test 스킬 형식)PATCH work-status {"barrelLots": []} 전체삭제는 422 INVALID_REFERENCE → DB DELETE로 정리pkill -f bootRun; pkill -f BitdaApiApplication| 증상 | 원인 / 해법 |
|---|---|
| 로그인 step3 무한 hang | auth.invigoworks.co.kr 미도달 — --connect-to 누락 |
| 로그인 400 Bad Request | 쿠키 호스트 불일치 — 플로우 전체를 auth 호스트로 통일 |
unauthorized_client | direct grant 시도 — PKCE로 |
API 500 ...테이블에 대한 접근 권한 없음 | DB 계정이 jh_kim 개인계정 — bitda_api로 |
API 401 INVALID_ISSUER | 토큰 iss와 서버 issuer-uri 불일치 — 2단계 override 확인 |
| 갑자기 전부 401 | 토큰 만료(1800s) — 3단계 재실행 |
user_not_found | 로컬 Keycloak에 jh_kim 시도 — jh_kim은 dev 전용 |