본문으로 건너뛰기
cccskills
무료GitHub에 공개

nextjs-server-actions

Use this skill when implementing form submissions, data mutations, or any 'use server' function in Next.js 16. Trigger words: フォーム送信, mutation, 更新処理, 保存, Server Action, use server, useActionState, revalidatePath, データ更新.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

설치 방법 보기

포함된 파일(1)

  • SKILL.md2.5 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Next.js Server Actions

いつ使うか

  • フォーム送信やデータの作成・更新・削除(mutation)を実装するとき。
  • クライアントから直接サーバー関数を呼びたいとき(API ルートを増やさずに)。

やること

  • mutation 関数の先頭に 'use server' を付ける。
  • 受け取った FormData / 引数を必ず Zod で検証してから処理する。
  • 認可チェック(誰がこの操作をしてよいか)を関数内で行う。
  • 成功後に revalidatePath / revalidateTag でキャッシュを無効化する。
  • クライアント側は useActionState でローディング・エラーを扱う。

守るルール

  • ✅ 'use server' + 入力 Zod 検証 + 認可チェックを必ずセットにする。
  • ✅ 返り値は判別可能な型({ ok: true } | { ok: false, error })にする。
  • ✅ 成功時は適切な粒度で再検証(全体ではなく対象パス/タグ)。
  • ❌ 検証前の生データを DB クエリへ渡さない。
  • ❌ Server Action 内でシークレットをクライアントに返さない。

典型例(コード片)

// app/users/actions.ts
'use server';
import { z } from 'zod';
import { revalidatePath } from 'next/cache';
import { requireUser } from '@/lib/auth';
import { UserModel } from '@/models/user';

const UpdateName = z.object({ id: z.string().length(24), name: z.string().min(1).max(80) });

export async function updateName(_: unknown, formData: FormData) {
  const session = await requireUser();
  const parsed = UpdateName.safeParse(Object.fromEntries(formData));
  if (!parsed.success) return { ok: false as const, error: '入力が不正です' };

  const { id, name } = parsed.data;
  if (session.userId !== id) return { ok: false as const, error: '権限がありません' };

  await UserModel.updateOne({ _id: id }, { $set: { name } });
  revalidatePath(`/users/${id}`);
  return { ok: true as const };
}

アンチパターン

  • Object.fromEntries(formData) をそのまま DB へ(検証なし)。
  • 認可チェックを忘れて他人のデータを更新できてしまう。
  • revalidatePath('/') で広く無効化し、無関係なページまで再生成する。

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

Use this skill when creating or reviewing Next.js Route Handlers (app/api), adding rate limiting, input validation, or auth to API endpoints. Trigger words: API ルート, Route Handler, app/api, エンドポイント, レート制限, 入力検証, CORS, ヘッダー, 認証付き API, hardening.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

Akira-Papa/claude-code-nextjs-mongo-template-162026년 5월 24일 업데이트

Use this skill when implementing full-text search, autocomplete, or vector/semantic search and RAG with MongoDB Atlas. Trigger words: 全文検索, あいまい検索, オートコンプリート, ベクトル検索, セマンティック検索, 類似検索, Atlas Search, $search, $vectorSearch, RAG, embedding.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

Akira-Papa/claude-code-nextjs-mongo-template-162026년 5월 24일 업데이트

Use this skill when implementing sign-in, sessions, authorization checks, or protecting routes and Server Actions. Trigger words: 認証, ログイン, サインイン, セッション, 認可, 権限チェック, Better Auth, Auth.js, 保護, ミドルウェア, getSession.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

Akira-Papa/claude-code-nextjs-mongo-template-162026년 5월 24일 업데이트

bootstrap

무료

Use this skill when starting a new session, opening this project for the first time, or when you need to recall the project's tech stack, hard rules, and which other skills exist. Trigger words: セッション開始, このプロジェクト, 全体像, どのスキル, 何から, getting started, overview.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

Akira-Papa/claude-code-nextjs-mongo-template-162026년 5월 24일 업데이트

Use this skill when setting up or modifying CI pipelines, GitHub Actions workflows, or automated checks (lint, typecheck, test, build) for this project. Trigger words: CI, GitHub Actions, ワークフロー, パイプライン, 自動テスト, lint チェック, typecheck, ビルド検証, .github/workflows.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

Akira-Papa/claude-code-nextjs-mongo-template-162026년 5월 24일 업데이트

Use this skill when writing end-to-end tests, browser automation, or verifying user flows in a real browser. Trigger words: E2E, Playwright, ブラウザテスト, ユーザーフロー, 結合テスト, シナリオテスト, ログインテスト, getByRole, expect.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

Akira-Papa/claude-code-nextjs-mongo-template-162026년 5월 24일 업데이트

Akira-Papa의 스킬 모두 보기

이 스킬의 문제 신고