SuperAPI AI 工具集

generating-grpc-services

编程与开发

查看项目

更新于 10-15 23:26

技能介绍

用途:从 Protocol Buffer(protobuf)的 .proto 文件生成 gRPC 服务定义、客户端与服务端桩代码及实现,适用于构建高性能 gRPC 服务。

主要能力:可搭建一元、服务端流、客户端流和双向流 RPC 方法;返回规范的 gRPC 状态码(如 OK、NOT_FOUND、INVALID_ARGUMENT、PERMISSION_DENIED);添加认证、日志、指标等拦截器;注册健康检查服务(grpc.health.v1.Health)与反射服务;配置 TLS/mTLS 传输安全;编写使用进程内测试服务器的集成测试;可选生成 REST-to-gRPC 网关。

使用方式:先读取或设计 .proto 服务定义,用 proto3 消息类型(如 google.protobuf.Timestamp、Struct、oneof);用 protoc 配合对应语言插件生成桩代码与客户端库;实现各方法的服务端处理逻辑;加入拦截器与健康检查;最后编写集成测试。前置条件包括 protoc v3.21+、语言对应的 gRPC 插件、buf CLI(推荐)、gRPC 测试工具(grpcurl、evans 或 BloomRPC)以及用于生产传输安全的 TLS 证书。

输出结构:${CLAUDE_SKILL_DIR}/proto/ 存放定义,generated/ 存放生成代码,src/services/ 存放处理实现,src/interceptors/ 存放拦截器,src/health/ 存放健康检查,gateway/ 为可选网关配置,tests/ 为集成测试。

限制:资料未提供该技能的具体收费、价格、支持平台或实测效果;部分细节(如各语言插件的安装命令)未在资料中给出。