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. 01新增或更新 JSON: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 规范
  • 关系类型和引用保持一致
  • 共享配置存放在一个包中
  • 序列化器可在多个服务间重复使用

评论

支持 Markdown