SuperAPI AI 工具集

golang-pro

编程与开发

查看项目

更新于 10-16 23:14

技能介绍

用途

golang-pro 是一个面向资深 Go 开发者的技能,定位为「精通 Go 1.21+、并发编程与云原生微服务的高级 Go 开发者」。它用于在开发过程中提供惯用模式、性能优化和生产级系统实现方面的指导,帮助完成并发模式实现、微服务设计、性能调优和符合 Go 惯例的代码编写。

主要能力

该技能围绕以下核心工作流展开:

  1. 分析架构 — 审查模块结构、接口与并发模式。
  2. 设计接口 — 创建小而专注的接口,并通过组合构建。
  3. 实现 — 编写惯用 Go 代码,包含正确的错误处理与 context 传播;继续前运行 go vet ./...。
  4. Lint 与校验 — 运行 golangci-lint run 并修复所有报告的问题后再继续。
  5. 优化 — 使用 pprof 进行性能剖析,编写基准测试,消除内存分配。
  6. 测试 — 使用 -race 标志进行表驱动测试、模糊测试,覆盖率 80%+;提交前确认竞态检测通过。

技能附带按上下文加载的参考文档,涵盖:并发(goroutine、channel、select、sync 原语)、接口(接口设计、io.Reader/Writer、组合)、泛型(类型参数、约束、泛型模式)、测试(表驱动测试、基准测试、模糊测试)、项目结构(模块布局、internal 包、go.mod)。

使用方式

技能以工作流和约束清单的形式指导开发。核心模式示例展示了带 context 取消与错误传播的 goroutine 写法:worker 通过 select 监听 ctx.Done() 与 jobs channel,错误经 errCh 返回,调用方负责排空;runPipeline 使用 context.WithTimeout 设置超时,通过 select 等待错误或超时,确保取消时不泄漏 goroutine。

实现 Go 功能时,技能建议输出:接口定义(契约优先)、带正确包结构的实现文件、含表驱动测试的测试文件,以及所用并发模式的简要说明。

约束

必须遵守:对所有代码使用 gofmt 和 golangci-lint;为所有阻塞操作添加 context.Context;显式处理所有错误(不使用裸返回);编写带子测试的表驱动测试;为所有导出函数、类型和包编写文档;泛型使用 X | Y 联合约束(Go 1.18+);用 fmt.Errorf("%w", err) 传播错误;测试时运行竞态检测(-race 标志)。

禁止:忽略错误(避免无理由的 _ 赋值);用 panic 处理常规错误;创建生命周期管理不清晰的 goroutine;跳过 context 取消处理;无性能理由使用反射;粗心混合同步与异步模式;硬编码配置(使用函数式选项或环境变量)。

适用场景

适用于需要编写高质量 Go 代码的场景,包括实现 goroutine 与 channel 并发模式、设计 gRPC 或 REST 微服务、使用 pprof 优化性能、编写符合 Go 惯例的代码,以及构建生产级云原生系统。

限制

该技能的具体收费、价格、平台支持情况暂未提供。其内容基于上游参考文档(Jeffallan 的 claude-skills,MIT 许可)在指定修订版本上引用,技能本身不包含运行时环境或工具安装说明。

引用文档

以下为作者声明的引用来源,保留指定版本、署名和许可。

作者的来源声明