Communitygithub.com

Supabase Postgres 모범 사례

Supabase가 관리하는 Postgres 모범 사례 가이드로, 어디서든 실행되는 Postgres에 적용됩니다. 스키마 설계, 마이그레이션, RLS 정책, 인덱스, 트리거, 데이터베이스 함수, 성능 최적화 등 Postgres 데이터베이스 작업 전에 이 스킬을 로드하세요.

Supabase Postgres 모범 사례란 무엇인가요?

이 스킬은 Supabase가 유지 관리하는 Postgres 데이터베이스 모범 사례 가이드입니다. SQL 쿼리 작성, 스키마 설계, 인덱스 구현, 마이그레이션, Row-Level Security(RLS) 정책, 연결 풀링, 성능 튜닝 등 다양한 작업에 적용 가능한 규칙을 8개 우선순위 카테고리로 제공합니다. 각 규칙은 'query-', 'conn-', 'security-', 'schema-', 'lock-', 'data-', 'monitor-', 'advanced-' 접두사로 구분되며, 왜 중요한지, 잘못된 예시와 올바른 예시, EXPLAIN 출력이나 메트릭, 추가 컨텍스트, Supabase 관련 참고 사항을 포함합니다. 이 스킬은 단순한 성능 가이드가 아니라, 한 컬럼 변경이나 단일 쿼리에도 적용해야 하는 포괄적인 데이터베이스 규칙 모음입니다. Cursor, Claude Code, Codex 등 AI 에이전트와 함께 사용하여 Postgres 관련 코드 생성 및 리뷰 시 일관된 모범 사례를 따르도록 합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Futurists2023/tiktok/tree/HEAD/.agents/skills/supabase-postgres-best-practices

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Supabase Postgres 모범 사례은(는) 무엇을 하나요?

Supabase가 유지 관리하는 Postgres 종합 성능 최적화 가이드입니다. 8개 카테고리에 걸쳐 영향도 우선순위로 정렬된 규칙을 제공하며, 자동 쿼리 최적화 및 스키마 설계를 안내합니다.

적용 시점

다음 상황에서 이 가이드라인을 참조하세요:

  • SQL 쿼리 작성 또는 스키마 설계
  • 인덱스 구현 또는 쿼리 최적화
  • 데이터베이스 성능 문제 검토
  • 연결 풀링 또는 확장 구성
  • Postgres 특화 기능 최적화
  • Row-Level Security(RLS) 작업

우선순위별 규칙 카테고리

우선순위카테고리영향도접두사
1쿼리 성능치명적query-
2연결 관리치명적conn-
3보안 및 RLS치명적security-
4스키마 설계높음schema-
5동시성 및 잠금중간-높음lock-
6데이터 접근 패턴중간data-
7모니터링 및 진단낮음-중간monitor-
8고급 기능낮음advanced-

사용 방법

자세한 설명과 SQL 예제는 개별 규칙 파일을 참조하세요:

references/query-missing-indexes.md
references/query-partial-indexes.md
references/_sections.md

각 규칙 파일에는 다음 내용이 포함됩니다:

  • 왜 중요한지에 대한 간략한 설명
  • 잘못된 SQL 예제와 설명
  • 올바른 SQL 예제와 설명
  • 선택적 EXPLAIN 출력 또는 메트릭
  • 추가 컨텍스트 및 참고 자료
  • Supabase 관련 참고 사항(해당 시)

참고 자료

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬