菜单
Wires and debugs Room TBA NotificationEvent delivery to uplbtools/discord-bot (proposal.submitted, proposal.reviewed, CI E2E, test inventory). Use when Discord notifications fail, NOTIFICATION_* env vars, Heroku bot deploy, or cross-repo changes with discord-bot.
用 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 | discord-notifications |
| description | Wires and debugs Room TBA NotificationEvent delivery to uplbtools/discord-bot (proposal.submitted, proposal.reviewed, CI E2E, test inventory). Use when Discord notifications fail, NOTIFICATION_* env vars, Heroku bot deploy, or cross-repo changes with discord-bot. |
Contract: docs/notifications.md. Bot repo: uplbtools/discord-bot (Heroku). Handoff: docs/e2e-discord-handoff.md.
| Repo | Role |
|---|---|
| room-tba | Producer — emits JSON via NotificationAdapter |
| discord-bot | Consumer — POST /notifications → Discord channels |
Always check both when notifications are silent.
getNotificationAdapter()
→ HttpNotificationAdapter if NOTIFICATION_GATEWAY_URL + NOTIFICATION_INGRESS_SECRET set
→ NoOpNotificationAdapter otherwise (silent!)
| Event | Emitted from |
|---|---|
proposal.submitted | src/pages/api/proposals/index.ts |
proposal.reviewed | `src/pages/api/admin/proposals/[id]/approve |
ci.e2e.* | GitHub Actions → scripts/ci-notify-discord-e2e.sh (not Astro runtime) |
ci.test_inventory.updated | .github/workflows/discord-test-inventory.yml |
Shared helpers: src/lib/notifications/proposal-events.ts.
POST https://uplbtools-discord-bot-*.herokuapp.com/notificationsx-notification-secret: NOTIFICATION_INGRESS_SECRETsrc/notifications/delivery/discord.ts| Event | Channel |
|---|---|
proposal.submitted, proposal.reviewed | #contributors (CHANNEL_CONTRIBUTORS_ID) |
ci.e2e.failed, blocking E2E | #development |
ci.staging-smoke.failed | #deploys |
ci.test_inventory.updated | #test-suite |
Required on Production and Preview (staging) at minimum:
NOTIFICATION_GATEWAY_URL=https://uplbtools-discord-bot-5eb468fac572.herokuapp.com/notifications
NOTIFICATION_INGRESS_SECRET=<same as Heroku NOTIFICATION_INGRESS_SECRET>
Pitfall: vars can exist but be empty strings — app no-ops silently. vercel env pull often omits encrypted values; verify with a successful notify or Vercel UI.
vercel env ls | rg NOTIFICATION
vercel env add NOTIFICATION_GATEWAY_URL production --value "$GATEWAY" --yes --force
Redeploy after env fix; existing deployments do not pick up new vars.
heroku config:get NOTIFICATION_INGRESS_SECRET -a uplbtools-discord-bot
git push heroku main # from discord-bot checkout on main
SECRET=$(heroku config:get NOTIFICATION_INGRESS_SECRET -a uplbtools-discord-bot)
curl -sS -X POST "https://uplbtools-discord-bot-5eb468fac572.herokuapp.com/notifications" \
-H "Content-Type: application/json" \
-H "x-notification-secret: $SECRET" \
-d '{"schemaVersion":1,"type":"proposal.reviewed","source":"room-tba","occurredAt":"'$(date -Iseconds)'","idempotencyKey":"test:manual","payload":{"proposalId":1,"outcome":"approved","entityType":"room","entityId":1,"entityLabel":"Test","submitterName":"Test","reviewedBy":"Editor","adminNote":null}}'
Expect {"ok":true} and embed in #contributors.
Comment on both issues when shipping cross-repo work.