菜单
Use when changing this template's object storage backend, reviewing storage env setup, switching between `s3`, `s3-compatible`, and `gcs`, or adding a new provider such as R2, MinIO, Spaces, Azure Blob, or GCS.
用 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 | storage-provider-extension |
| description | Use when changing this template's object storage backend, reviewing storage env setup, switching between `s3`, `s3-compatible`, and `gcs`, or adding a new provider such as R2, MinIO, Spaces, Azure Blob, or GCS. |
Read docs/guides/storage-provider.md first.
s3, s3-compatible, gcsSTORAGE_PROVIDERSYSTEM_AWS_*S3Provider; do not add a dedicated provider unless the API is actually non-S3s3Use:
STORAGE_PROVIDER=s3SYSTEM_AWS_S3_REGIONSYSTEM_AWS_ACCESS_KEY_IDSYSTEM_AWS_SECRET_ACCESS_KEYSYSTEM_AWS_S3_BUCKETUSE_LOCALSTACKLOCALSTACK_ENDPOINTLOCALSTACK_PUBLIC_ENDPOINTs3-compatibleUse:
STORAGE_PROVIDER=s3-compatibleSYSTEM_AWS_S3_REGIONSYSTEM_AWS_ACCESS_KEY_IDSYSTEM_AWS_SECRET_ACCESS_KEYSYSTEM_AWS_S3_BUCKETS3_COMPATIBLE_ENDPOINTS3_COMPATIBLE_PUBLIC_ENDPOINTS3_COMPATIBLE_FORCE_PATH_STYLEgcsUse:
STORAGE_PROVIDER=gcsGCS_PROJECT_IDGCS_BUCKETGCS_CLIENT_EMAILGCS_PRIVATE_KEYGCS_REGIONnext/image, remote host allowlists, CSP)src/libraries/storage.ts and keep StorageProvider / StorageService contracts intact unless there is a concrete reason to change them.S3Provider before adding a new class.createStorageServiceInstance().env.exampleREADME.mddocs/guides/storage-provider.md.cursor/rules/storage-provider.mdc when guidance changed__tests__/libraries/storage.test.tsUserRepositoryUploadResult.url semantics explicit; do not blur public URL, CDN URL, and signed URL.S3_COMPATIBLE_FORCE_PATH_STYLE must preserve both true and false; there is a regression test for this.EXTRA_REMOTE_IMAGE_URLS and src/libraries/security-headers.ts separately when URLs must load in the browser.SYSTEM_AWS_* names consistently in code, docs, and examples.src/libraries/storage.ts__tests__/libraries/storage.test.ts__tests__/repositories/user_repository.storage-provider.test.ts.env.exampleREADME.mddocs/guides/storage-provider.md.cursor/rules/storage-provider.mdcs3-compatible firstEXTRA_REMOTE_IMAGE_URLS and CSP, not storage.ts