Anthropic Claudeソフトウェア開発⭐ リポ 0品質スコア 50/100

zod

Name: zod
Author: pproenca

Zodを使ったスキーマバリデーションのベストプラクティスを提供します。`z.object`スキーマの定義、`z.string`バリデーション、`safeParse`、`z.infer`による型安全な解析やエラーハンドリングを実装する際に使用してください。なお、React Hook Formとの統合パターンは`react-hook-form`スキル、OpenAPIクライアント生成は`orval`スキルを参照してください。

description の原文を見る

Zod schema validation best practices for type safety, parsing, and error handling. This skill should be used when defining z.object schemas, using z.string validations, safeParse, or z.infer. This skill does NOT cover React Hook Form integration patterns (use react-hook-form skill) or OpenAPI client generation (use orval skill).

SKILL.md 本文

Zod ベストプラクティス

TypeScript アプリケーション向けの Zod スキーマ検証に関する包括的なガイド。自動リファクタリングとコード生成の指針となるよう、8 つのカテゴリにわたる 43 のルールが含まれています。

適用時期

以下の場合にこれらのガイドラインを参照してください：

新しい Zod スキーマを書く場合
parse() と safeParse() のどちらを選ぶか判断する場合
z.infer を使った型推論を実装する場合
ユーザーへのフィードバックのための検証エラーを処理する場合
複雑なオブジェクトスキーマを構成する場合
refinements および transforms を使用する場合
バンドルサイズと検証パフォーマンスを最適化する場合
Zod コードのベストプラクティスをレビューする場合

ルールカテゴリ（優先度順）

優先度	カテゴリ	影響度	プレフィックス
1	スキーマ定義	CRITICAL	`schema-`
2	パースと検証	CRITICAL	`parse-`
3	型推論	HIGH	`type-`
4	エラーハンドリング	HIGH	`error-`
5	オブジェクトスキーマ	MEDIUM-HIGH	`object-`
6	スキーマ構成	MEDIUM	`compose-`
7	Refinements と Transforms	MEDIUM	`refine-`
8	パフォーマンスとバンドル	LOW-MEDIUM	`perf-`

クイックリファレンス

1. スキーマ定義（CRITICAL）

schema-use-primitives-correctly - 各タイプに正しいプリミティブスキーマを使用する
schema-use-unknown-not-any - 型安全性のために z.any() の代わりに z.unknown() を使用する
schema-avoid-optional-abuse - オプショナルフィールドの過度な使用を避ける
schema-string-validations - スキーマ定義時に文字列検証を適用する
schema-use-enums - 固定文字列値に列挙型を使用する
schema-coercion-for-form-data - フォームおよびクエリデータに強制型変換を使用する

2. パースと検証（CRITICAL）

parse-use-safeparse - ユーザー入力に safeParse() を使用する
parse-async-for-async-refinements - 非同期 refinements に parseAsync を使用する
parse-handle-all-issues - 最初のエラーだけでなくすべての検証エラーを処理する
parse-validate-early - システム境界で検証を行う
parse-avoid-double-validation - 同じデータの二重検証を避ける
parse-never-trust-json - JSON.parse の出力を決して信頼しない

3. 型推論（HIGH）

type-use-z-infer - 手動の型の代わりに z.infer を使用する
type-input-vs-output - transforms に z.input と z.infer を区別する
type-export-schemas-and-types - スキーマと推論された型の両方をエクスポートする
type-branded-types - ドメイン安全性のためにブランド型を使用する
type-enable-strict-mode - TypeScript 厳密モードを有効にする

4. エラーハンドリング（HIGH）

error-custom-messages - カスタムエラーメッセージを提供する
error-use-flatten - フォームエラー表示に flatten() を使用する
error-path-for-nested - ネストされたエラーの位置に issue.path を使用する
error-i18n - 国際化エラーメッセージを実装する
error-avoid-throwing-in-refine - refine で例外をスローする代わりに false を返す

5. オブジェクトスキーマ（MEDIUM-HIGH）

object-strict-vs-strip - 未知のキーに対して strict() と strip() を選択する
object-partial-for-updates - 更新スキーマに partial() を使用する
object-pick-omit - スキーマバリアントに pick() と omit() を使用する
object-extend-for-composition - フィールド追加に extend() を使用する
object-optional-vs-nullable - optional() と nullable() を区別する
object-discriminated-unions - 型絞り込みに判別された共用体を使用する

6. スキーマ構成（MEDIUM）

compose-shared-schemas - 共有スキーマを再利用可能なモジュールに抽出する
compose-intersection - 型の組み合わせに intersection() を使用する
compose-lazy-recursive - 再帰的スキーマに z.lazy() を使用する
compose-preprocess - データ正規化に preprocess() を使用する
compose-pipe - 多段階検証に pipe() を使用する

7. Refinements と Transforms（MEDIUM）

refine-vs-superrefine - refine() と superRefine() を正しく選択する
refine-transform-coerce - transform() を refine() および coerce() と区別する
refine-add-path - refinement エラーにパスを追加する
refine-defaults - デフォルト値を持つオプショナルフィールドに default() を使用する
refine-catch - フォールトトレランスパースに catch() を使用する

8. パフォーマンスとバンドル（LOW-MEDIUM）

perf-cache-schemas - スキーマインスタンスをキャッシュする
perf-zod-mini - バンドルサイズに敏感なアプリケーションに Zod Mini を使用する
perf-avoid-dynamic-creation - ホットパスでの動的スキーマ生成を避ける
perf-lazy-loading - 大規模スキーマを遅延ロードする
perf-arrays - 大規模配列検証を最適化する

使用方法

詳細な説明とコード例については、個別のリファレンスファイルをお読みください：

セクション定義 - カテゴリ構造と影響レベル
ルールテンプレート - 新しいルール追加用テンプレート
個別ルール：references/{prefix}-{slug}.md

完全なコンパイル済みドキュメント

すべてのルールが展開された完全なガイド：AGENTS.md

情報源

ライセンス: MIT(寛容ライセンスのため全文を引用しています) · 原本リポジトリ

詳細情報

作者: pproenca
リポジトリ: pproenca/dot-skills
ライセンス: MIT
最終更新: 不明

GitHubで原本を見る →フィードバックを送る

Source: https://github.com/pproenca/dot-skills / ライセンス: MIT

zod