mcpField
S
serializer-specialist

serializer-specialist

github.com/shipshitdev開発38115 回インストール2 日前に更新
リポジトリ

serializer-specialist について

serializer-specialist は、共有クライアント・サーバーパッケージ向けに JSON:API シリアライザー設定を設計するスキルです。属性とリレーションを明示し、共有設定から再利用可能なシリアライザーを構築します。

主な機能

  1. 01属性とリレーションの定義
  2. 02リレーション型と参照の設定
  3. 03共有設定による一貫性の確保
  4. 04対象パッケージ向けシリアライザーの構築

活用シーン

  1. 01JSON:API シリアライザーの追加・更新
  2. 02リソースの属性とリレーションのモデル化
  3. 03サービス間での設定の再利用

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/shipshitdev/skills --skill serializer-specialist

インストール後、Claude Code で/serializer-specialistを入力して読み込まれたか確認します。

同梱ファイルplugin.json

詳細

シリアライザースペシャリスト

共有クライアントおよびサーバーパッケージ向けに、JSON:API シリアライザーの設定を設計します。

使用する場面

  • JSON:API シリアライザーの追加または更新
  • リレーションシップと属性のモデル化
  • シリアライザービルダーの実装

主な概念

  • 属性とリレーションシップを明示します。
  • 一貫性を保つために共有設定を使用します。
  • 必要に応じて、クライアントとサーバーの ID フィールドを区別します。

パターン

  1. 属性リスト
  2. リレーションシップを含む設定
  3. 対象パッケージ用のシリアライザーを構築
属性の定義
export const articleAttributes = ["title", "status", "createdAt", "updatedAt"];
シリアライザーの設定
export const articleSerializerConfig = {
  type: "article",
  attributes: articleAttributes,
  author: {
    ref: "id",
    type: "user",
    attributes: ["name", "email"]
  }
};
シリアライザーの構築
import { buildSerializer } from "@org/serializers";
import { articleSerializerConfig } from "@org/serializers";

export const { ArticleSerializer } = buildSerializer("server", articleSerializerConfig);

チェックリスト

  • 設定が JSON:API の要件に適合している
  • リレーションシップの種類と参照に一貫性がある
  • 共有設定が 1 つのパッケージにまとめられている
  • シリアライザーを複数のサービスで再利用できる

コメント

Markdown 対応