菜单
Operates Room TBA Vercel deploys and Supabase Postgres (DATABASE_URL, env vars, preview/production, migrations). Use when builds fail on Vercel, missing DATABASE_URL, env pull empty strings, staging preview, or applying drizzle migrations before deploy.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Anti-AI-slop design skill for greenfield pages, audits, redesigns, and design extraction from URLs or screenshots. Use when the user asks to build a new app or landing page, wants to redesign something, invokes Hallmark by name, or uses audit/redesign/study. Room TBA: also read references/room-tba.md before map chrome, sidebar, or editor UI work.
Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. Handles UX review, visual hierarchy, information architecture, cognitive load, accessibility, performance, responsive behavior, theming, anti-patterns, typography, fonts, spacing, layout, alignment, color, motion, micro-interactions, UX copy, error states, edge cases, i18n, and reusable design systems or tokens. Also use for bland designs that need to become bolder or more delightful, loud designs that should become quieter, live browser iteration on UI elements, or ambitious visual effects that should feel technically extraordinary. Not for backend-only or non-UI tasks.
Write structured handoff prompts when ending a session or delegating to another agent (Claude, Codex, Cursor). Use when user says handoff, delegate, continue in new chat, or epic spans multiple sessions.
Review diffs for over-engineering only — delete, stdlib, native, yagni, shrink. Use after a fat agent diff, before merge, or when user says ponytail-review, simplify review, what can we delete. Codex/Claude: use @ponytail-review plugin skill when installed.
Louis Rossmann anti-AI-slop rules for prose (README, docs, MDX, PRs, blog). From realrossmanngroup/no_ai_slop_writing_rules. Use when writing or editing any user-facing text. Not for code generation.
Default workflow for smmariquit repositories. Use at the start of any task — read README, match conventions, minimal diffs, no secrets in commits, verify before redoing infra work. Check for stack-specific skills in this repo (.cursor/skills/).
| name | vercel-supabase-ops |
| description | Operates Room TBA Vercel deploys and Supabase Postgres (DATABASE_URL, env vars, preview/production, migrations). Use when builds fail on Vercel, missing DATABASE_URL, env pull empty strings, staging preview, or applying drizzle migrations before deploy. |
Canonical reference: AGENTS.md § Vercel CLI and environment ops. Human setup: docs/developer-guide.md.
stimmie/saan-ang-room (.vercel/project.json)room-tba.uplbtools.me ← main onlystaging.room-tba.uplbtools.me ← staging branchuplbtools/room-tbaUse gh and vercel CLI by default; do not send maintainers to dashboards when CLI works.
| Var | Where | Notes |
|---|---|---|
DATABASE_URL | Production + all Preview | Mandatory for bun run build (SSG prerender) |
NOTIFICATION_GATEWAY_URL | Production + Preview staging | See discord-notifications |
NOTIFICATION_INGRESS_SECRET | Production + Preview staging | Same |
ADMIN_PASSWORD | Dev/local | Editor login |
ISR_BYPASS_TOKEN | Vercel | On-demand SEO revalidation after publish |
Runtime code uses DATABASE_URL only (not NEON_CONNECTION_STRING).
| Symptom | Fix |
|---|---|
vercel env pull shows DATABASE_URL="" | Encrypted omit; copy from Supabase/Vercel UI |
| Var listed but build fails missing DATABASE_URL | Value may be empty string; re-add with --force |
| Preview branch build fails | DATABASE_URL must exist for all preview targets, not only staging |
| Prod deploy from wrong branch | check-production-branch.sh blocks non-main on production builds |
vercel whoami
vercel env ls
vercel env add DATABASE_URL preview staging --value "$DATABASE_URL" --yes --force
vercel env pull .env.vercel --environment=preview --yes
vercel ls
vercel redeploy <latest-production-deployment-url>
gh pr checks <n> --repo uplbtools/room-tba
Never vercel deploy --prod except from main matching origin/main. Ship prod via staging → main release PR.
drizzle/; apply before deploy that depends on new columns.psql "$DATABASE_URL" -f drizzle/NNNN_name.sql or Supabase SQL editor.bun run check:migrations (CI uses E2E DB).# Prefer session pooler (*.pooler.supabase.com)
cp .env.example .env.local
vercel env pull .env.vercel --environment=development --yes
# Merge DATABASE_URL into .env.local
bun dev
PGlite in browser is offline cache only, not a server DB fallback.
scripts/check-vercel-env.sh — fails missing DATABASE_URLscripts/check-production-branch.sh — prod builds only on mainbun run check:vercel-env
bun run check:prod-branch # set VERCEL_ENV=production to test branch guard
bun run build # local pre-merge gate
| Branch | Target |
|---|---|
main | Production |
staging | Staging preview |
| feature | Ephemeral preview |
After env fix on Vercel: redeploy; failed deploys are not auto-retried.