cc-serverpod
Serverpod 백엔드 — 모델/엔드포인트 생성, 마이그레이션 + 심화 패턴(아키텍처, 인증, 캐싱, DB, IAP, 테스트; 구 cc-backend 통합)
Serverpod 백엔드 — 모델/엔드포인트 생성, 마이그레이션 + 심화 패턴(아키텍처, 인증, 캐싱, DB, IAP, 테스트; 구 cc-backend 통합)
Serverpod backend plugin (Model, Endpoint, Migrations)
Skills#
| 이름 | 설명 |
|---|---|
| database-design | Serverpod의 데이터 저장 구조를 설계할 때 사용합니다. 모델별 테이블, 데이터 관계와 조회에 필요한 인덱스를 정합니다. |
| serverpod | Serverpod 기능 모듈의 모델·엔드포인트와 데이터베이스 변경을 구현할 때 사용합니다. .spy.yaml 작성, 모듈·호스트 코드 생성과 마이그레이션을 진행합니다. |
| serverpod-api-design | Serverpod 백엔드의 API 계약을 설계할 때 사용합니다. 엔드포인트, 요청·응답 DTO와 버전 관리 기준을 정리합니다. |
| serverpod-architecture | Serverpod 기능을 독립 패키지로 나누거나 호스트에 조립할 때 사용합니다. 모델·서비스·세션의 의존 방향과 스키마 소유권을 정하고 순환 의존과 배포 경계를 검토합니다. |
| serverpod-auth-identifier-domains | Serverpod에서 사용자 ID 컬럼이나 사용자 간 조인을 작성할 때 사용합니다. User·UserInfo·AuthUser 식별자를 구분하고 실제 저장 위치를 확인해 잘못된 사용 |
| serverpod-auth-patterns | Serverpod에서 로그인·세션 확인·접근 권한을 구현할 때 사용합니다. serverpod_auth_server와 현재 사용자 조회를 활용해 인증과 범위 기반 권한 검사를 구성합 |
| serverpod-auth-rules | Serverpod 3.x에서 AuthenticationInfo로 인증을 처리할 때 사용합니다. 해당 버전의 인증 정보와 사용자 확인 API를 사용하는 규칙을 안내합니다. |
| serverpod-caching-patterns | Serverpod 프로젝트의 캐시 정책과 데이터 일관성을 정할 때 사용합니다. 캐시 키, 유효 기간과 무효화 조건을 설계하고 여러 서버에서 갱신 결과가 맞는지 확인합니다. |
| serverpod-database-patterns | Serverpod에서 복잡한 조회·데이터 관계·트랜잭션을 구현할 때 사용합니다. ORM 쿼리 패턴과 데이터베이스 스키마 변경 절차를 안내합니다. |
| serverpod-iap | Serverpod 앱에 인앱 결제를 연결하거나 구매 오류를 조사할 때 사용합니다. 스토어 상품 등록, StoreKit·in_app_purchase 연동과 서버 영수증 검증을 함께 |
| serverpod-local-fullstack | Serverpod 4.x의 서버와 Flutter 앱을 로컬에서 함께 실행할 때 사용합니다. serverpod start로 내장 PostgreSQL과 앱을 기동하고 전체 기능의 개발 |
| serverpod-logging-rules | Serverpod 프로젝트의 API·서버 로그 정책을 적용할 때 사용합니다. 요청·응답 기록, 개인정보 마스킹과 서버 로그 수준·보관 기간을 설정합니다. |
| serverpod-mcp-guide | Serverpod 4 로컬 개발 환경에 MCP를 연결할 때 사용합니다. serverpod mcp-server로 마이그레이션, 서버·앱 로그와 재시작을 다루고 Flutter 측 MC |
| serverpod-migration-rules | Serverpod 데이터베이스 변경을 생성·배포·복구할 때 사용합니다. CLI 버전과 적용 순서를 맞추고 실제 스키마와의 차이, 복구용 마이그레이션과 인덱스 변경을 점검합니다. |
| serverpod-session-revocation | 동시 로그인 기기 수를 제한하거나 강제 로그아웃 오류를 고칠 때 사용합니다. 인증 방식별 세션 집계·해제·만료 처리를 구성하고 알림 뒤 서버의 실제 인증 상태를 재확인합니다. |
| serverpod-soft-delete | 데이터를 남겨두고 삭제 상태로 관리하는 기능을 추가할 때 사용합니다. deletedAt을 기준으로 활성 데이터 조회와 이력 조회의 포함 범위를 구분합니다. |
| serverpod-testing-patterns | Serverpod 서비스의 테스트를 설계하거나 TDD로 구현할 때 사용합니다. 단위 테스트와 엔드포인트 통합 테스트의 역할을 나누고 프로젝트에 맞는 검증 패턴을 적용합니다. |
| serverpod-transaction-rules | Serverpod 3.x에서 트랜잭션이나 직접 작성한 SQL을 다룰 때 사용합니다. 여러 호출의 트랜잭션 전달과 SQL 입력 처리 규칙을 확인합니다. |
| serverpod-worktree-parallel | 여러 Git worktree에서 Serverpod 4 풀스택 개발 환경을 동시에 실행할 때 사용합니다. 작업별 데이터베이스·포트·MCP 연결을 분리하고 내장 PostgreSQL과 |
| 업무별 독립 feature 패키지 | 사용자가 모든 업무의 기능별 독립 패키지를 요청하면, 각 업무의 endpoint·서비스·모델을 |
Commands#
| 이름 | 설명 |
|---|---|
| /cc-serverpod:endpoint — 서버 API 창구 자동 생성기 | Serverpod endpoint 및 service 클래스 생성 |
| /cc-serverpod:merge-migrations — 흩어진 DB 변경 기록을 하나로 합치기 | 여러 migration을 하나로 병합합니다 (프로덕션 배포 전 정리) |
| /cc-serverpod:model — 백엔드 데이터 설계도 만들기 |
Serverpod 데이터 설계도(
.spy.yaml
)를 만듭니다 — 본체 entity, 생성/수정 요청 DTO, 목록 응답 DTO, enum 을 한국어 설명·생성일시·인덱스까지
|
Agents#
| 이름 | 설명 |
|---|---|
| backend-architect | Serverpod backend architecture design expert. Use for API design, service decomposition, and Clean A |
| serverpod | Serverpod backend expert. Use for model, endpoint, and migration tasks |
| serverpod-endpoint-agent | Serverpod Endpoint 전문가. endpoint 및 service 클래스 생성에 사용합니다. |
| serverpod-exception-agent | Serverpod exception, validation, constants 클래스 생성 전문가. 오류 처리 패턴을 구현할 때 사용합니다. |
| serverpod-model-agent | Serverpod Model 전문가. .spy.yaml 모델 정의, 필드 타입, 인덱스 작업에 사용합니다. |
| serverpod-test-agent | Serverpod 테스트 전문가. Integration/Unit 테스트 생성에 사용합니다. |
| tdd-orchestrator | Serverpod TDD Red-Green-Refactor orchestrator. Use for test-driven backend development |
Rules#
| 이름 | 설명 |
|---|---|
| Backend Test Patterns | Patterns applied when writing Serverpod backend integration tests. |
| backend-conventions | Serverpod backend coding conventions |
관련 플러그인#
| 플러그인 | 설명 |
|---|---|
| cc-bricks | cob(co-bricks) 기반 브릭 생성 가이드. kobic Clean Architecture feature 모듈 11종 + 그린필드 프로젝트 초기 세팅(project-init |
| cc-clickhouse | ClickHouse 기반 BI 분석 |
| cc-compass | 코코드 스킬 저장소 나침반 — 작업 유형(워크플로우/도구/규칙/레퍼런스)에 따라 알맞은 플러그인·커맨드·스킬로 안내 |
| cc-dev | 개발 사이클 자동화 (이슈 사이클, 버그 사이클, 세션, ZenHub, Agent Teams) |
| cc-e2e | flutter-skill 탐색 → Gherkin 초안 → Patrol 박제로 이어지는 E2E 시나리오 저작 파이프라인 |
| cc-flutter | Flutter 개발 핵심 (UI 패턴, Feature 생성, BLoC, 테스트) |
| cc-pixel-loop | Figma + Marionette + Dart MCP를 활용한 픽셀 퍼펙트 Flutter UI 에이전틱 루프 (Read → Write → Reload → Capture → Comp |
| cc-security | 보안 통합 — API/앱 보안, 보안 감사, CI 시크릿, 결제/IAP 엔드포인트 보안, 도서 PDF DRM (구 cc-uiux-security 확장) |
| cc-serverpod-docs | Serverpod 상세 레퍼런스 스킬 모음 (공식 문서 기반, 19개 스킬) |
| cc-spec | Jev 판정 게이트 — Seed spec 을 쓰고 TypeSafe Jev(판정 전용 모델)로 모호성·3관점 패널·드리프트를 보정 확률로 판정해 잠금 |
설치#
curl -fsSL https://skills.cocode.im/install.sh | bash -s -- --plugin cc-serverpod