⚡

GoSDK开发专家Skill go-sdk-specialist

Go SDK开发专家技能专注于使用地道的Go语言模式和最佳实践，为企业级应用构建高效、可靠且易于维护的软件开发工具包。核心能力包括：模块化架构设计、上下文管理、错误处理、并发安全、版本控制以及自动化测试。适用于需要为API、云服务或内部系统提供高质量Go语言客户端的开发团队。关键词：Go SDK开发，Go语言编程，软件开发工具包，API客户端，模块化设计，错误处理，并发编程，版本控制，自动化测试。

后端开发 0 次安装 8 次浏览 更新于 2/25/2026

name: go-sdk-specialist description: 使用地道模式进行Go SDK开发 allowed-tools:

  • Read
  • Write
  • Edit
  • Glob
  • Grep
  • Bash

Go SDK专家技能

概述

此技能专注于使用正确的模块版本控制、基于上下文的取消机制和Go风格错误处理模式来开发地道的Go SDK。

能力

  • 使用正确的模块结构设计Go SDK架构
  • 实现基于上下文的取消和超时控制
  • 应用带有错误包装的Go错误处理模式
  • 遵循语义化版本控制（semver）配置go.mod版本管理
  • 为配置设计函数式选项模式
  • 实现基于接口的设计以提高可测试性
  • 配置具有结构化输出的适当日志记录
  • 安全地支持并发操作

目标流程

  • 多语言SDK策略
  • SDK架构设计
  • SDK测试策略

集成点

  • Go模块（go.mod）
  • 使用testify进行go test
  • 使用golangci-lint确保代码质量
  • 使用pkg.go.dev生成文档
  • 使用goreleaser进行发布

输入要求

输出产物

  • Go模块源代码
  • go.mod和go.sum文件
  • 测试文件（*_test.go）
  • 位于examples/目录下的示例
  • 包含安装说明的README文件
  • 兼容GoDoc的文档

使用示例

skill:
  name: go-sdk-specialist
  context:
    apiSpec: ./openapi.yaml
    modulePath: github.com/myorg/sdk-go
    goVersion: "1.21"
    useGenerics: true
    errorWrapping: true
    functionalOptions: true

最佳实践

  1. 使用函数式选项进行配置
  2. 接受接口，返回结构体
  3. 使零值有用
  4. 使用包装显式处理错误
  5. 使用context.Context进行取消操作
  6. 保持包专注且小巧