菜单
Use when changing this template's mail delivery backend, reviewing email env setup, switching between `ses` and `smtp`, or adding a new provider such as Resend, SendGrid, Postmark, or Mailgun.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when creating pages under src/app/(site)/(authorized)/admin/. Covers list/detail/edit/create page patterns with DataTable/DataView/DataForm, repositories under src/repositories/, request schemas under src/requests/admin/, and AdminPageHeader breadcrumbs.
Use when modifying Better Auth + Prisma authentication: src/libraries/auth.ts, src/libraries/auth-client.ts, src/proxy.ts, src/services/auth_service.ts, auth-related actions.ts, or prisma/schema.prisma auth models (User/Session/Account/Verification). Covers session helpers, URL/secret env resolution, DB TLS, and PUBLIC_PATHS.
Use when creating or modifying files under src/repositories/, src/models/, or src/requests/. Covers BaseRepository inheritance (Prisma/API/Local/Airtable/Dify), Zod schema placement, and separation between repository and schema files.
Use when changing this template's mail delivery backend, reviewing email env setup, switching between `ses` and `smtp`, or adding a new provider such as Resend, SendGrid, Postmark, or Mailgun. Covers EMAIL_PROVIDER routing, EMAIL_FROM priority, dynamic import for Node-only SDKs, and test coverage for both email.test.ts and Better Auth callback smoke.
Use when adding or changing translations in messages/ja.json or messages/en.json, using getTranslations/useTranslations, or updating next-intl configuration under src/i18n/. Covers message key hierarchy, Server/Client Component APIs, dynamic and rich-text patterns, and JSON duplicate-key pitfalls.
Use when adding or modifying pages under src/app, or components under src/components (atoms/molecules/organisms) in this Next.js App Router project. Covers Server/Client Component boundary, Atomic Design placement, Server Actions in actions.ts, URL-based state management, sidebar active-state, and shadcn-only atoms rule.
| name | email-provider-extension |
| description | Use when changing this template's mail delivery backend, reviewing email env setup, switching between `ses` and `smtp`, or adding a new provider such as Resend, SendGrid, Postmark, or Mailgun. |
Read docs/guides/email-provider.md first.
ses, smtpEMAIL_PROVIDEREMAIL_FROMSES_FROM_EMAIL with deprecation warningSYSTEM_AWS_*sesUse:
EMAIL_PROVIDER=sesSYSTEM_AWS_SES_REGIONSYSTEM_AWS_ACCESS_KEY_IDSYSTEM_AWS_SECRET_ACCESS_KEYLOCALSTACK_ENDPOINTEMAIL_FROMsmtpUse:
EMAIL_PROVIDER=smtpSMTP_HOSTSMTP_PORTSMTP_SECURESMTP_USERSMTP_PASSEMAIL_FROMsrc/libraries/email.ts first. Keep EmailProvider / EmailService contracts stable unless there is a concrete reason to change them.createEmailServiceInstance()EMAIL_FROM; do not introduce a new provider-specific sender env unless there is an unavoidable external API reason..env.exampleREADME.mddocs/guides/email-provider.md.cursor/rules/add-email-provider.mdc when guidance changed__tests__/libraries/email.test.ts__tests__/libraries/auth.test.ts for Better Auth callback smoke coverageEMAIL_PROVIDER typos should throw; do not silently fallback.await import() when practical.EMAIL_FROM is the primary sender env. SES_FROM_EMAIL is legacy compatibility only.html-email as well if available.src/libraries/email.tssrc/libraries/auth.ts when consumer wiring changes__tests__/libraries/email.test.ts__tests__/libraries/auth.test.ts.env.exampleREADME.mddocs/guides/email-provider.md.cursor/rules/add-email-provider.mdcEMAIL_PROVIDER=ses and point SES traffic at LOCALSTACK_ENDPOINTEMAIL_PROVIDER=smtp