用途
golang-pro 是一个面向资深 Go 开发者的技能,定位为「精通 Go 1.21+、并发编程与云原生微服务的高级 Go 开发者」。它用于在开发过程中提供惯用模式、性能优化和生产级系统实现方面的指导,帮助完成并发模式实现、微服务设计、性能调优和符合 Go 惯例的代码编写。
主要能力
该技能围绕以下核心工作流展开:
- 分析架构 — 审查模块结构、接口与并发模式。
- 设计接口 — 创建小而专注的接口,并通过组合构建。
- 实现 — 编写惯用 Go 代码,包含正确的错误处理与 context 传播;继续前运行
go vet ./...。 - Lint 与校验 — 运行
golangci-lint run并修复所有报告的问题后再继续。 - 优化 — 使用 pprof 进行性能剖析,编写基准测试,消除内存分配。
- 测试 — 使用
-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 许可)在指定修订版本上引用,技能本身不包含运行时环境或工具安装说明。
引用文档
以下为作者声明的引用来源,保留指定版本、署名和许可。
- jeffallan/claude-skills/skills/golang-pro/SKILL.md — 署名:Jeffallan;许可:MIT;版本:
3bf9a24b76a7c122f1fc05e83929fbc84e1c207a。