菜单
Runs and debugs Room TBA Playwright E2E, integration tests in CI, workflow gating, E2E database, and staging smoke. Use when e2e fails in GitHub Actions, EMAXCONNSESSION pool errors, run/e2e label, e2e-reusable.yml, or test:integration:live locally.
用 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 | playwright-e2e-ci |
| description | Runs and debugs Room TBA Playwright E2E, integration tests in CI, workflow gating, E2E database, and staging smoke. Use when e2e fails in GitHub Actions, EMAXCONNSESSION pool errors, run/e2e label, e2e-reusable.yml, or test:integration:live locally. |
Full doc: docs/testing.md. Handoff: docs/e2e-discord-handoff.md.
| Command | Use |
|---|---|
bun run test:integration:live | Local CI parity: build:e2e → preview → integration + HTTP |
bun run e2e:reset-db | Truncate + seed E2E Supabase |
bun run e2e | Playwright blocking (~16 min local) |
bun run e2e:advisory | Non-blocking suite |
bun run e2e:staging | Live staging smoke (read-only) |
SKIP_E2E_BUILD=1 bun run e2e | Re-run after first build:e2e |
test:integration without preview runs service tests only; HTTP suites fail fast.
| DB | Automation |
|---|---|
E2E (yhzinxlakcewqjaqbbaj) | CI integration + Playwright; mutating |
| Staging | e2e:staging smoke; read-only |
| Production | Never automated writes |
Env: E2E_DATABASE_URL, E2E_ADMIN_PASSWORD, E2E_ADMIN_SESSION_SECRET in GitHub Actions secrets.
| Trigger | Runs |
|---|---|
| Every push (incl. draft) | verify + migrations only (~6–9 min) |
| Ready for review | Blocking E2E (integration + Playwright) + advisory + bundle |
run/e2e label | Re-run heavy stack after fixes |
Push to staging | Full blocking E2E + staging-smoke (non-blocking) |
gh pr ready <number>
gh pr edit <number> --add-label run/e2e
gh pr checks <number> --repo uplbtools/room-tba
Ordinary pushes after ready do not re-trigger E2E; add label again.
bun run e2e:reset-dbbun run build:e2ebun run preview:e2e)bun run test:integration (with PREVIEW_BASE_URL)bun run e2e (PLAYWRIGHT_SKIP_WEBSERVER=1)Wall clock ~28–35 min in CI.
| File | Name |
|---|---|
.github/workflows/ci.yml | verify, migrations |
.github/workflows/e2e.yml | E2E (PR blocking) |
.github/workflows/e2e-advisory.yml | E2E advisory |
.github/workflows/e2e-staging.yml | E2E staging + nightly |
.github/workflows/staging-smoke.yml | Live staging smoke |
| Error | Likely cause | Mitigation |
|---|---|---|
EMAXCONNSESSION max clients reached | Too many parallel PG connections in integration job | CI sets PLAYWRIGHT_WORKERS=1 and DATABASE_POOL_MAX=4; integration runs with --concurrency 1 |
| Preview failed to start | build:e2e or port conflict | Read job log before Playwright step |
staging-smoke /admin redirect | Staging deploy lag vs test expectation | Wait for Vercel staging deploy; check live URL |
| Integration pass locally, fail CI | Missing preview or wrong PREVIEW_BASE_URL | Use test:integration:live |
bun run lint && bun test src
bun run test:integration:live # API/service changes
bun run e2e # UI/map/proposal flows
bun run build # substantive changes
e2e/smoke/, e2e/browse/, e2e/admin/staging → main runs E2E + staging-smoke. If only notification/API changes, verify + migrations may suffice for feature PR; release PR still hits full stack. Admin merge only when failures are known infra flakes, not regressions.