IROVEN 백엔드 API 설계 및 패키지 구조 규칙. Use when creating REST APIs, DTOs, controllers, or organizing backend code structure.
IROVEN 데이터베이스 설계, Flyway 마이그레이션, JPA Entity, QueryDSL 규칙. Use when creating JPA entities, writing QueryDSL queries, adding @Transactional annotations, or creating Flyway migration scripts.
IROVEN 백엔드 에러 핸들링 및 예외 처리 표준. Use when handling errors, creating custom exceptions, implementing GlobalExceptionHandler, or writing logging code.
IROVEN 백엔드 테스트 작성 표준. Use when writing test code, choosing test strategies, generating test data, or verifying test coverage.
IROVEN 팀의 AI 코딩 도구용 Skills 모음입니다. 코딩 표준과 Best Practice를 공유합니다.
지원 도구:
/plugin 명령어 (권장)# Git URL로 설치
/plugin install https://github.com/seonhyeokjun/pg-ai-skills.git
# 또는 로컬 경로
/plugin install ~/pg-ai-skills/backend-plugin
/plugin install ~/pg-ai-skills/common-plugin
설치 후 /skills 명령어로 확인할 수 있습니다.
# 1. clone
cd ~
git clone https://github.com/seonhyeokjun/pg-ai-skills.git
# 2. Personal Skills로 복사
mkdir -p ~/.claude/skills
cp -r ~/pg-ai-skills/*/skills/* ~/.claude/skills/
pg-ai-skills/
├── backend-plugin/
│ ├── .claude-plugin/
│ │ └── plugin.json
│ ├── skills/
│ │ ├── api-design/SKILL.md # API 설계, DTO, 패키지 구조
│ │ ├── error-handling/SKILL.md # 예외 처리, StatusCode, 로깅
│ │ ├── database-schema/SKILL.md # Flyway, JPA Entity, QueryDSL
│ │ └── test-writing/SKILL.md # 테스트 전략, Mockito, AssertJ
│ └── hooks/
│ ├── hooks.json
│ └── security-dispatcher.js # 보안/멘토링 훅
├── common-plugin/
│ ├── .claude-plugin/
│ │ └── plugin.json
│ └── skills/
│ ├── code-review/SKILL.md # 코드 리뷰 체크리스트
│ └── git-conventions/SKILL.md # Git 커밋, 브랜치, PR 규칙
└── .claude-plugin/
└── marketplace.json
| Skill | 설명 | 자동 적용 시점 |
|---|---|---|
| api-design | API 설계, DTO 네이밍, 패키지 구조, ResponseData | API/Controller/DTO 생성 시 |
| error-handling | 예외 처리, GlobalExceptionHandler, StatusCode, 로깅 | 예외 클래스 생성, 에러 핸들링 시 |
| database-schema | Flyway, JPA Entity, QueryDSL, @Transactional | DB 스키마/Entity/Repository 작성 시 |
| test-writing | 테스트 전략, Given-When-Then, Mockito, AssertJ | 테스트 코드 작성 시 |
| Skill | 설명 | 자동 적용 시점 |
|---|---|---|
| code-review | PR 코드 리뷰 체크리스트 | 코드 리뷰, self-review 시 |
| git-conventions | Git 커밋 메시지, 브랜치 전략, PR 규칙 | 커밋, 브랜치 생성, PR 시 |
| Hook | 트리거 | 동작 |
|---|---|---|
| security-dispatcher | Edit/Write 시 | 프로덕션 설정 수정 차단, .env 수정 차단, Controller/Entity/Service 수정 시 멘토링, Flyway 네이밍 검사 |
| 항목 | 규칙 |
|---|---|
| Java | 21 |
| Spring Boot | 3.4+ (4.x 호환) |
| Request DTO | class + @Builder(access = PRIVATE) + of() |
| Response DTO | record + @Builder(access = PRIVATE) + of() |
| Entity | @NoArgsConstructor(PROTECTED) + @Builder(PRIVATE) + 정적 팩토리 |
| 응답 래퍼 | ResponseData<T> (status, message, data) |
| 예외 | ex/{domain}/ + StatusCode enum + GlobalExceptionHandler |
| Flyway | V{YYYYMMDD}_{순번}__{설명}.sql + MySQL COMMENT 필수 |
| Audit | created_date, modified_date (DATETIME(6), ON UPDATE) |
| 트랜잭션 | 조회: readOnly = true, 변경: @Transactional |
| QueryDSL | *RepositoryCustom + *RepositoryImpl + BooleanExpression 헬퍼 |
| 테스트 | H2 인메모리, Flyway OFF, Given-When-Then, @ActiveProfiles("test") |
| Lombok | @Slf4j, @Getter, @RequiredArgsConstructor, @Builder |
feature/add-{skill-name}-skillBuilt for AI-powered development at IROVEN
Modifies files
Hook triggers on file write and edit operations
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
npx claudepluginhub seonhyeokjun/pg-ai-skills --plugin pg-backend-skillsIROVEN 전체 팀 공통 Skills - 코드 리뷰, Git 커밋 규칙
Collection of backend development skills including Kysely SQL query conversion
Use this agent when designing APIs, building server-side logic, implementing databases, or architecting scalable backend systems. This agent specializes in creating robust, secure, and performant backend services. Examples:\n\n<example>\nContext: Designing a new API\nuser: "We need an API for our social sharing feature"\nassistant: "I'll design a RESTful API with proper authentication and rate limiting. Let me use the backend-architect agent to create a scalable backend architecture."\n<commentary>\nAPI design requires careful consideration of security, scalability, and maintainability.\n</commentary>\n</example>\n\n<example>\nContext: Database design and optimization\nuser: "Our queries are getting slow as we scale"\nassistant: "Database performance is critical at scale. I'll use the backend-architect agent to optimize queries and implement proper indexing strategies."\n<commentary>\nDatabase optimization requires deep understanding of query patterns and indexing strategies.\n</commentary>\n</example>\n\n<example>\nContext: Implementing authentication system\nuser: "Add OAuth2 login with Google and GitHub"\nassistant: "I'll implement secure OAuth2 authentication. Let me use the backend-architect agent to ensure proper token handling and security measures."\n<commentary>\nAuthentication systems require careful security considerations and proper implementation.\n</commentary>\n</example>
Commands for database schema design, migrations, and optimization
Drizzle ORM を使ったデータベーススキーマの管理とマイグレーションガイド
Schema design, query optimization, migrations, indexing, transactions, data integrity, and connection pooling.
Manage database migrations with version control, rollback capabilities, and automated schema evolution tracking