Communitygithub.com

ComeOnOliver/skillshub

Next.js App Router 與 Server Actions 的核心安全標準。用於保護 Next.js App Router 路由、Server Actions 或 API 端點時使用。(觸發條件:app/**/actions.ts、middleware.ts、action、boundary、sanitize、auth、jose)

skillshub 是什麼?

此技能為使用 Next.js App Router 和 Server Actions 的開發者提供了一整套至關重要的安全準則與實作指南。其優先級為 P0(關鍵),這意味著任何偏離這些模式的實作都應被視為潛在漏洞。此技能涵蓋了從邊緣端身份驗證(透過 middleware.ts)、角色權限控管(RBAC),到強制執行安全標頭(如 Content-Security-Policy 與 X-XSS-Protection)的完整防護。技能明確規範了所有 Server Actions 必須使用 Zod 進行輸入驗證,並在每次動作中執行身份驗證檢查(await auth())。此外,也說明了資料污染(experimental_taint)、路由處理器的速率限制與 CSRF 防護、安全的 HttpOnly/Secure 與 SameSite Cookie,以及使用 server-only 套件隔離後端邏輯等進階安全機制。該技能適用於在 Next.js 專案中實作安全的 App Router 模式,並強烈反對將資料庫欄位洩漏給客戶端、在客戶端 bundle 中使用 process.env、未經驗證的 Server Action 輸入,以及在共用佈局(Layout)中進行身份驗證檢查等反模式。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/HoangNguyen0403/agent-skills-standard/nextjs-security

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Next.js 安全性

優先級:P0(關鍵)

結構

app/
├── lib/
│   └── validation.ts   # 共享的 Zod schema
└── middleware.ts       # 身份驗證與標頭

實作指南

  • Next.js 中介軟體:使用 middleware.ts 進行邊緣端身份驗證、角色權限控管(RBAC),並強制執行安全標頭(例如 Content-Security-Policy (CSP)、X-XSS-Protection)。
  • Server Actions:務必使用 Zod 對來自 FormData 或 JSON 的所有輸入進行消毒。在每個 action 內部執行身份驗證檢查(await auth())以驗證呼叫者身份。
  • 資料污染:使用 experimental_taint API(taintObjectReference)確保敏感的伺服器物件(例如含有 passwordHash 的 User)絕不會洩漏到客戶端元件中。
  • 路由處理器(route.ts):實作速率限制以防止暴力破解或 DoS 攻擊。驗證 Origin/Referer 標頭以減緩 CSRF(跨站請求偽造)。
  • 身份驗證 Token:嚴格使用 HttpOnly、Secure cookie,並搭配 SameSite: 'Lax' 進行 session 管理。絕不將 Token 儲存在 localStorage 中。
  • 邏輯隔離:使用 server-only 套件防止後端專用邏輯被包含在客戶端 bundle 中。
  • 元件純淨性:跳脫所有使用者提供的內容。絕不直接使用 dangerouslySetInnerHTML,除非搭配像 DOMPurify 這樣的消毒器。

反模式

  • 不要將資料庫欄位洩漏給客戶端:使用 DTO(資料傳輸物件);絕不直接傳遞原始模型物件。
  • 不要在客戶端 bundle 中使用 process.env:僅在安全揭露的情況下標記為 NEXT_PUBLIC_。
  • 不要使用未經驗證的 Server Action 輸入:始終使用 Zod schema 進行驗證。
  • 不要在共用佈局中進行身份驗證檢查:在佈局中進行驗證是不安全的;請使用中介軟體。

參考資料

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

相關技能