JNU-econovation

새 Spring Boot 서비스를 api-gateway + auth-api 에코시스템에 연결한다. auth-api 클라이언트 등록 → Gateway 라우팅 추가 → 서비스에 econo-passport 연동 → 동작 확인까지 한 번에 처리. 다음 상황에서 반드시 이 스킬을 사용한다: - "새 서비스 Gateway에 연결해줘", "새 서비스 auth 연동" - "서비스 등록해줘", "Gateway 뒤에 붙여줘" - "/register-service" 직접 호출 - 새 Spring Boot 서비스가 추가되고 인증이 필요할 때 ARGUMENTS: 서비스명, 서비스 경로(선택), 업스트림 URL(선택) 예: "EEOS-BE /Users/mando/study/eeos/EEOS-BE/eeos"

이 스킬은 사용자가 "PR 생성해줘", "PR 만들어줘", "pull request 생성", "pr 올려줘", "/git-pr" 등을 요청할 때 호출된다. 현재 브랜치의 커밋을 원격으로 push하고, `.github/PULL_REQUEST_TEMPLATE.md`를 채워 GitHub Pull Request를 생성한다.

신규 기능을 개발할 때 정책 문서 → 코드 → 테스트 순서로 작성한다. ADR은 기술적 결정에만 사용하고, 기능 정책은 docs/features/ 에 작성한다. 다음 상황에서 반드시 이 스킬을 사용한다: - "기능 추가해줘", "기획부터 해봐", "설계해봐" - 새로운 API 엔드포인트 또는 도메인 규칙이 생길 때 - "/new-feature" 직접 호출 ARGUMENTS: 기능 이름 또는 요구사항 (없으면 대화에서 추출)

Architecture Decision Record(ADR)를 작성한다. 기술적 결정사항, 설계 선택, 트레이드오프를 문서화하여 나중에 "왜 이렇게 했지?"를 알 수 있게 한다. 다음 상황에서 반드시 이 스킬을 사용한다: - "ADR 써줘", "결정사항 문서화해줘", "이 결정 기록해줘" - 기술 방향 선택 후 ("A 대신 B 쓰기로 했어") - 설계 논의가 끝났을 때 - 나중에 이 결정이 왜 내려졌는지 설명이 필요할 것 같을 때 - "/adr" 직접 호출 ARGUMENTS: 결정 내용 또는 결정 번호 (없으면 대화에서 추출)

AI 에이전트의 액션 스페이스, 도구 정의, 관측(Observation) 포맷을 설계·최적화해 작업 완수율을 높일 때 사용한다.

로컬 개발, 컨테이너 보안, 네트워킹, 볼륨 전략, 멀티 서비스 오케스트레이션을 위한 Docker 및 Docker Compose 패턴.

브랜치 전략, 커밋 컨벤션, 머지 vs 리베이스, 충돌 해결, 협업 개발 모범 사례를 포함하는 Git 워크플로 패턴. 모든 규모의 팀에 적용 가능하다.

GitHub 저장소 운영·자동화·관리. gh CLI를 활용한 이슈 분류, PR 관리, CI/CD 운영, 릴리스 관리, 보안 모니터링. 단순 git 명령을 넘어 GitHub 이슈·PR·CI 상태·릴리스·기여자·stale 항목 관리 등 GitHub 운영 작업을 수행할 때 사용한다.

작업 내역을 분석해 논리적 단위로 커밋 계획을 세우고 사용자 승인 후 커밋을 실행한다. 커밋할 준비가 됐거나 사용자가 커밋을 요청할 때 사용한다.

사용자가 "이슈 만들어줘", "이슈 생성", "버그 이슈", "기능 이슈", "github issue", "이슈 올려줘" 등 GitHub 이슈 생성을 요청할 때 사용한다. 이슈 유형(버그/기능)을 선택하고, .github/ISSUE_TEMPLATE 템플릿을 기반으로 초안을 작성한 후 사용자 확인을 거쳐 gh CLI로 이슈를 생성한다.

작업 완료 후 코드 포맷 적용, 커밋, 푸시, PR 생성을 순서대로 수행한다.

API 엔드포인트 작성/수정 시 에러 응답 문서화를 강제한다. Swagger @ApiResponses에 에러 코드/메시지 명시, Validation message에 고유 코드 부여, enum 성격 필드에 @Schema allowableValues 추가. Use when writing controllers, DTOs, or Swagger docs. Triggers on "API 만들어줘", "엔드포인트 추가", "Swagger", "에러 코드".

브랜치 생성 시 네이밍 규칙을 강제한다. 형식은 이니셜/타입/설명. Use when creating branches, "브랜치 만들어줘", "branch", "git checkout -b", "git branch".

Java 파일 수정 후 커밋 전에 Spotless 코드 포맷팅을 자동 적용한다. Use when editing Java files, after code changes, before committing. Triggers on Java file edits, "커밋", "commit", "포맷", "format", "spotless".

Maintain eco-knock-be-central code in the repository's established style. Use when modifying, reviewing, refactoring, testing, or organizing project code, especially Spring Boot Kotlin/Java services, controllers, repositories, entities, DTOs, gRPC clients, Flyway migrations, and E2E tests.

Independently review and gate Eco Knock production-code diffs for package structure, Java/Kotlin boundaries, class placement, constructor injection, and consistency with nearby code. Use after any change under src/main and before completion; act as the read-only verifier in the developer → verifier → refactor → verifier workflow.

Update this repository's README so it matches the current implemented scope. Use when the user asks to create, rewrite, or refresh README content, document new features, update setup or deployment instructions, or keep the README in sync with current code, configuration, Docker deployment, Raspberry Pi behavior, or project limitations.

Keep this Spring Boot project's Scalar/OpenAPI documentation accurate when REST or SSE endpoints, controller annotations, request/response DTOs, status codes, ErrorCode entries, auth/security exposure, or API examples are added or changed. Use when adding a new endpoint, changing an existing endpoint contract, reviewing API docs, fixing Scalar or /v3/api-docs output, or updating OpenAPI annotations.

Inspect the repository state, recent git history, and both staged and unstaged diffs, then draft or create small Korean commits that match the local convention. Use when the user asks to write a commit message, make a git commit, summarize changes into commits, redo a mistaken commit, keep commit messages in Korean, or split a mixed diff into very small logical commits aligned with recent repository history.

Deploy this repository to a Raspberry Pi with Docker and verify runtime readiness for sensors, GHCR images, and exposed ports. Use when the user asks to deploy or redeploy the embedded server to a Raspberry Pi, prepare Docker-based Raspberry Pi execution, verify `.env.deploy` or the selected app env file, run `deploy/prod/deploy.ps1`, `deploy/prod/deploy.sh`, `scripts/deploy-pi.ps1`, or `scripts/deploy-pi.sh`, or diagnose Raspberry Pi issues around GHCR auth, Docker compose, allocated ports, `/dev/i2c-1`, `i2cdetect`, BME680, or VEML7700 detection.

Update this repository's README so it matches the current implemented scope. Use when the user asks to create, rewrite, or refresh README content, document new features, update setup or deployment instructions, or keep the README in sync with current code, configuration, Docker deployment, Raspberry Pi behavior, or project limitations.

Inspect the repository state, recent git history, and both staged and unstaged diffs, then draft or create small Korean commits that match the local convention. Use when the user asks to write a commit message, make a git commit, summarize changes into commits, redo a mistaken commit, keep commit messages in Korean, or split a mixed diff into very small logical commits aligned with recent repository history.

Maintain this repository while preserving its current architecture, naming, and layering. Use when adding features, refactoring packages, reorganizing directories, wiring gRPC or config code, or checking whether a change fits this repository's established style.

해당 프로젝트의 도메인 지식에 대한 정리 파일입니다. 이 서비스의 도메인에 대한 개념이 필요한 경우 이 스킬을 사용하세요.

이 문서는 react의 커스텀 훅을 만들 때 지켜야하는 패턴을 정의합니다. 커스텀 훅을 새롭게 만들어야 하거나, 기존의 훅을 리팩토링해야할 때, 그리고 코드리뷰를 진행할 때 이 스킬을 사용하세요.

이 문서는 react의 컴포넌트를 만들 때 지켜야하는 폴더/index.tsx 방식의 colocation 패턴을 정의합니다. 컴포넌트를 새롭게 만들어야 하거나, 기존의 컴포넌트를 리팩토링해야할 때, 그리고 코드리뷰를 진행할 때 이 스킬을 사용하세요.

이 문서는 react의 컴포넌트를 만들 때 지켜야하는 추상화 레벨을 정의합니다. 컴포넌트를 새롭게 만들어야 하거나, 기존의 컴포넌트를 리팩토링해야할 때, 그리고 코드리뷰를 진행할 때 이 스킬을 사용하세요.

Implement or refactor React + Vite frontend features in this repository using its established responsibility boundaries and naming conventions. Use for new pages, feature components, interaction state, hooks, pure data transformations, feature constants, component CSS, SVG controls, backend-provided media fields, or refactors that decide what belongs in pages, features, shared, components, hooks, utils, constants, and assets.

Create or update this React + Vite frontend repository's README so it matches the current implemented scope. Use when the user asks to create, rewrite, refresh, or validate README content, document setup or run commands, summarize the current frontend structure, or keep README content aligned with the actual code and configuration.

Maintain the ISEKAI-BE backend repository. Use when Codex needs to implement or review backend changes, fix bugs, update configuration, adjust WebSocket or Gemini flows, modify character/chat/member/storage/security domains, run repository validation, or explain this Kotlin/Spring Boot codebase.

Update this repository's README so it matches the current implemented scope. Use when the user asks to create, rewrite, or refresh README content, document new features, update setup or deployment instructions, or keep the README in sync with current code, configuration, Docker deployment, Raspberry Pi behavior, or project limitations.

econo-passport(com.github.JNU-econovation:econo-passport)를 현재 Spring Boot MVC 서비스에 통합한다. 의존성 추가 → PassportArgumentResolver 설정 → @PassportAuth 사용 예시 → 테스트 헬퍼까지 한 번에 처리. 다음 상황에서 반드시 이 스킬을 사용한다: - "passport 연동해줘", "econo-passport 추가해줘", "@PassportAuth 쓰고 싶어" - "X-User-Passport 헤더 처리", "Gateway 인증 연동", "멤버 정보 받고 싶어" - "이름/기수 받고 싶어", "Passport 주입 안 돼" - "/use-passport" 직접 호출

기술 문서(튜토리얼, How-to 가이드, 트러블슈팅, API 참조, 개념·도메인 설명 등)를 새로 작성하거나 기존 문서를 개선·리뷰할 때 이 스킬을 사용하세요. 토스 테크니컬 라이팅 가이드 기반의 3단계 워크플로우(문서 유형 → 정보 구조 → 문장 다듬기)로 전문 에이전트를 호출해 문서 품질을 끌어올립니다. apps/docs 등 .md 문서 작성·검토 시 활성화하세요.