Communitygithub.com

PhuongDeveloper/landingpage

Supabase가 관리하는 Postgres 모범 사례 가이드로, 어디서든 실행되는 Postgres에 적용할 수 있습니다. 이 스킬은 Postgres 데이터베이스에서 테이블 및 컬럼 생성/수정, 스키마 설계, 마이그레이션, RLS 정책, 인덱스, 트리거, 함수, 큐, pg_cron/pgmq, pgvector, pg_restore 등 데이터베이스 작업을 수행하기 전에 반드시 로드해야 합니다. 또한 느린 쿼리, 높은 CPU, 타임아웃, EXPLAIN 계획, 연결 고갈, 락킹, 블로트, 잘못된 사용자에게 노출된 행 등을 진단할 때도 함께 로드하세요. 성능 가이드일 뿐만 아니라 스키마, 마이그레이션, 보안, SQL 작성 작업에도 필수적인 규칙을 제공합니다.

landingpage란 무엇인가요?

이 스킬은 Supabase가 유지 관리하는 Postgres 데이터베이스 모범 사례 가이드로, Postgres를 사용하는 모든 환경에서 적용할 수 있습니다. 주로 데이터베이스 스키마 설계, 마이그레이션, SQL 쿼리 작성, 인덱스 최적화, 보안(RLS), 연결 관리, 동시성 제어, 성능 진단 등 8가지 우선순위 범주로 나뉘어 규칙을 제공합니다. 이 스킬을 로드하면 자동화된 쿼리 최적화와 스키마 설계를 위한 구체적인 지침을 따를 수 있으며, 각 규칙 파일에는 잘못된 예시와 올바른 예시, EXPLAIN 출력, 성능 메트릭 등이 포함되어 있습니다. Claude Code, Cursor, Codex 등 AI 에이전트와 함께 사용하여 Postgres 관련 작업의 품질과 성능을 향상시킬 수 있습니다.

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

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

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

문서

Supabase Postgres 모범 사례

Postgres를 위한 포괄적인 성능 최적화 가이드로, Supabase가 유지 관리합니다. 자동화된 쿼리 최적화와 스키마 설계를 안내하기 위해 영향도에 따라 우선순위가 매겨진 8개 범주의 규칙을 포함합니다.

적용 시점

다음 상황에서 이 지침을 참조하세요:

  • SQL 쿼리 작성 또는 스키마 설계 시
  • 인덱스 구현 또는 쿼리 최적화 시
  • 데이터베이스 성능 문제 검토 시
  • 연결 풀링 또는 스케일링 구성 시
  • Postgres 특화 기능 최적화 시
  • 행 수준 보안(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 4 individual skills — each has its own dedicated page.

PhuongDeveloper/landingpage

Deploy applications and websites to Vercel. Use when the user requests deployment actions like "deploy my app", "deploy and give me the link", "push this live", or "create a preview deployment".

PhuongDeveloper/landingpage

Use when doing ANY task involving Supabase. Triggers: Supabase products (Database, Auth, Edge Functions, Realtime, Storage, Vectors, Cron, Queues); client libraries and SSR integrations (supabase-js, @supabase/ssr) in Next.js, React, SvelteKit, Astro, Remix; auth issues (login, logout, sessions, JWT, cookies, getSession, getUser, getClaims, RLS); Supabase CLI or MCP server; schema changes, migrations, declarative schemas, security audits, Postgres extensions (pg_graphql, pg_cron, pg_vector); debugging and troubleshooting errors or unexpected behavior on Supabase projects (HTTP errors, Postgres errors, RLS surprises, permission denied, schema cache issues, timeouts, Edge Function crashes, Realtime drops, Storage failures) and reading or querying logs (Logs Explorer, ClickHouse).

PhuongDeveloper/landingpage

Deploy and manage projects on Vercel using token-based authentication. Use when working with Vercel CLI using access tokens rather than interactive login — e.g. "deploy to vercel", "set up vercel", "add environment variables to vercel".

PhuongDeveloper/landingpage

React composition patterns that scale. Use when refactoring components with boolean prop proliferation, building flexible component libraries, or designing reusable APIs. Triggers on tasks involving compound components, render props, context providers, or component architecture. Includes React 19 API changes.

관련 스킬