开发技能

结构化Git工作流实践。在进行任何代码更改时使用。在提交、分支、解决冲突或需要跨多个并行流组织工作时使用。在发布版本、选择语义版本升级、打标签或编写变更日志时使用。

当用户询问如何编写、解释、自定义、迁移、保护或排查GitHub Actions工作流、工作流语法、触发器、矩阵、运行器、可复用工作流、制品、缓存、密钥、OIDC、部署、自定义操作或Actions Runner Controller时使用，尤其是当用户需要官方GitHub文档、精确链接或基于文档的YAML指导时。

将原始笔记、错误日志、语音转写或截图转换为清晰的GitHub风格Markdown问题报告。当用户粘贴错误信息、错误消息或非正式描述并希望生成结构化GitHub问题时使用。支持图片/GIF作为视觉证据。

Golang基准测试、性能剖析与性能测量。适用于编写、运行或比较Go基准测试，使用pprof对热点路径进行性能剖析，解读CPU/内存/追踪性能分析结果，使用benchstat分析结果，设置CI基准测试回归检测，或通过Prometheus运行时指标调查生产环境性能。当开发者需要对特定性能指标进行深入分析时也可使用——该技能提供测量方法论，同时...

We need to translate the given text from English to Simplified Chinese. The instruction says to preserve product names, protocol names, URLs, numbers, and technical terms. The name "golang-cli" is to be preserved if it appears in the source text, but we should not include it unless it appears. The source text does not contain "golang-cli" as a standalone term; it appears in the context of "Golang CLI application development" but that's not the name itself. The instruction says "Name to preserve: golang-cli" but then says "Do not include the name unless it appears in the source text." The source text has "Golang CLI" but not "golang-cli" exactly. However, "golang-cli" might be considered a technical term? The instruction says "preserve product names, protocol names, URLs, numbers, and technical terms." "golang-cli" could be a technical term. But the instruction also says "Do not include the name unless it appears in the source text." Since "golang-cl

Golang code style conventions — line length and breaking, variable declarations, control flow clarity, when comments help vs hurt. Use when writing or reviewing Go code, asking about style or clarity, or establishing project coding standards. Not for naming conventions (→ See `samber/cc-skills-golang@golang-naming` skill), linter configuration (→ See `samber/cc-skills-golang@golang-lint` skill), or doc comments (→ See `samber/cc-skills-golang@golang-documentation` skill).

Golang 并发模式。在编写或审查涉及 goroutine、channel、select、锁、同步原语、errgroup、singleflight、工作池或扇出/扇入管道的并发 Go 代码时使用。当检测到 goroutine 泄漏、竞态条件、channel 所有权问题，或需要在 channel 和互斥锁之间做出选择时也会触发。

在Golang中符合惯用法的context.Context使用方式——通过API边界传播、取消、超时与截止时间、请求作用域的值、用于超出请求存活的后台工作的context.WithoutCancel。适用于跨层设计上下文传播、调试泄漏或未过期的上下文、在context.Background/TODO/WithoutCancel之间选择、或在上下文中存储值。不适用于仅将ctx作为第一个参数接受的代码。

使用 GitHub Actions 为 Golang 项目配置 CI/CD 流水线 — 包括测试、代码检查、SAST、安全扫描、代码覆盖率、Dependabot、Renovate、GoReleaser、代码审查自动化和发布流水线。适用于设置或改进 Go 项目 CI、配置 GitHub Actions 工作流、添加代码检查工具或安全扫描器、自动化依赖更新或添加质量门禁时使用。

Golang 数据结构 — 切片（内部机制、容量增长、预分配、slices 包）、映射（内部机制、哈希桶、maps 包）、数组、container/list/heap/ring、strings.Builder 与 bytes.Buffer、泛型集合、指针（unsafe.Pointer、weak.Pointer）以及复制语义。适用于选择或优化 Go 数据结构、实现泛型容器、使用 container/ 包、unsafe 或 weak 指针，或对切片/映射内部机制有疑问时。

Go数据库访问全面指南——参数化查询、结构体扫描、可空列、事务、隔离级别、SELECT FOR UPDATE、连接池、批处理、上下文传播及迁移工具。适用于编写、审查或调试与PostgreSQL、MariaDB、MySQL或SQLite交互的Golang代码；数据库测试；或关于database/sql、sqlx或pgx的问题。不生成数据库模式或迁移SQL。

Go语言依赖注入（DI）全面指南。涵盖DI的重要性（可测试性、松耦合、关注点分离、生命周期管理）、手动构造函数注入以及DI库对比（google/wire、uber-go/dig、uber-go/fx、samber/do）。在设计服务架构、设置依赖注入、重构紧耦合代码、管理单例或服务工厂时，或当用户询问控制反转、服务...时使用此技能。

Golang项目的依赖管理策略——go.mod管理、安装/升级包、最小版本选择、漏洞扫描、过时依赖追踪、二进制体积分析、Dependabot/Renovate配置、冲突解决以及go.work工作区。适用于添加、移除或升级Go依赖项、审计漏洞、解决版本冲突或设置自动化依赖更新时使用。

惯用的Go设计模式——函数选项、构造函数、错误流与级联、资源管理与生命周期、优雅关闭、弹性、架构、依赖注入、数据处理、流式处理等。适用于在架构模式间明确选择、实现函数选项、设计构造函数API、设置优雅关闭、应用弹性模式，或询问哪种惯用Go模式适合特定问题时。

Golang 项目综合文档指南，涵盖 godoc 注释、README、CONTRIBUTING、CHANGELOG、Go Playground、示例测试、API 文档和 llms.txt。适用于编写或审查文档注释、文档、添加代码示例、搭建文档站点或讨论文档最佳实践。同时适用于库和应用程序/CLI 的触发场景。

Idiomatic Golang error handling — creation, wrapping with %w, errors.Is/As, errors.Join, custom error types, sentinel errors, panic/recover, the single handling rule, structured logging with slog, HTTP request logging middleware, and samber/oops for production errors. Built to make logs usable at scale with log aggregation 3rd-party tools. Apply when creating, wrapping, inspecting, or logging errors in Go code. For samber/oops specifics → See `samber/cc-skills-golang@golang-samber-oops`...

我们要求翻译一段文本，目标语言是简体中文。文本内容是关于Golang中使用google/wire进行编译时依赖注入的描述。需要保留产品名、协议名、URL、数字和技术术语。不要添加任何额外内容。文本中提到了多个wire相关的函数和概念，如wire.NewSet, wire.Build等。需要准确翻译这些技术术语，但保留英文原名？指令说"Preserve product names, protocol names, URLs, numbers, and technical terms." 所以技术术语如wire.NewSet应该保留原样。但中文翻译中可能需要适当解释？指令说"Translate only the text inside <text>." 并且"Preserve ... technical terms." 所以应该保留这些术语的英文形式，不翻译。但有些术语如"cleanup functions"可能需要翻译？"cleanup functions"是技术术语，但可以翻译为"清理函数"？指令说"technical terms"要保留，但通常技术术语在中文中可能保留英文或翻译。为了保险，我们保留英文原样，因为它是函数名或

Implements GraphQL APIs in Golang using gqlgen or graphql-go. Apply when building GraphQL servers, designing schemas, writing resolvers, handling subscriptions, or integrating GraphQL with existing Go HTTP services. Also apply when the codebase imports `github.com/99designs/gqlgen` or `github.com/graph-gophers/graphql-go`.

提供gRPC使用指南、protobuf组织方式以及适用于Golang微服务的生产级模式。在实现、审查或调试gRPC服务端/客户端、编写proto文件、设置拦截器、使用状态码处理gRPC错误、配置TLS/mTLS、使用bufconn进行测试或处理流式RPC时使用。

Golang技能编排器——在任何Golang编码、审查、调试或设置任务中始终处于激活状态。它会读取任务上下文，并从samber/cc-skills-golang中加载最相关的技能，通常同时加载多个：编写gRPC服务时加载golang-grpc + golang-testing + golang-error-handling；调试panic时加载golang-troubleshooting + golang-safety；审计安全性时加载golang-security + golang-lint + golang-safety。此外：当两个技能看似重叠时，会消除竞争集群的歧义……

Golang项目的lint最佳实践与golangci-lint配置——运行linter、配置.golangci.yml、使用nolint指令抑制警告、解读lint输出以及选择linter。适用于配置golangci-lint、询问lint警告或nolint抑制、设置代码质量工具或选择linter时使用。当用户提及golangci-lint、go vet、staticcheck或revive时也可使用。

golang-linter — 一个可供AI代理安装的技能。

将Golang代码现代化，使用最新的语言特性、标准库改进和惯用模式。在编写或审查Go代码时检测到旧式模式，或遇到弃用警告时主动触发。当用户明确要求现代化、Go版本升级或CI/工具链刷新时也使用。

Go（Golang）命名规范——涵盖包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数选项、缩写、测试函数及子测试命名。在编写新Go代码、审查或重构代码、选择命名方案（如New与NewTypeName、isConnected与connected、ErrNotFound与NotFoundError、iota为0时StatusReady与StatusUnknown）、讨论Go包命名（utils/helpers反模式）等场景下使用此技能。

Golang日常可观测性——生产环境中始终开启的信号。涵盖使用slog的结构化日志、Prometheus指标、OpenTelemetry分布式追踪、基于pprof/Pyroscope的持续性能分析、服务端RUM事件追踪、告警以及Grafana仪表板。适用于为生产监控对Go服务进行埋点、配置指标或告警、添加OpenTelemetry追踪、关联日志与追踪、将遗留日志器（zap/logrus/zerolog）迁移至slog、添加...

Golang性能优化模式与方法论——若存在X瓶颈，则应用Y方案。涵盖分配减少、CPU效率、内存布局、GC调优、池化、缓存及热路径优化。适用于性能分析或基准测试已识别瓶颈时，需采用正确优化模式进行修复。亦适用于执行性能代码审查时，提出改进建议或可帮助快速识别性能增益的基准测试。不适用于测量方法论（→...

推荐生产可用的Golang库和框架。当用户明确请求库建议、想要比较替代方案、需要为特定任务选择库，或项目中正在添加新依赖时使用。

提供关于设置Golang项目布局和工作空间的指南。适用于启动新Go项目、组织现有代码库、搭建包含多个包的单仓库、创建含多个主包的CLI工具、在cmd/internal/pkg目录约定间做选择，或讨论包重构、包拆分、模块拆分等场景。

防御性Golang编码，防止恐慌、静默数据损坏和微妙的运行时错误。在遇到nil恐慌、追加别名、映射并发访问、浮点数比较陷阱或零值设计问题时使用。也用于审查代码中的nil安全性、数值转换溢出、资源生命周期问题（循环中的defer）或切片和映射的防御性复制。

使用samber/do在Golang中实现依赖注入——服务容器、生命周期管理、作用域、健康检查、优雅关闭及模块组织。适用于使用或采用samber/do时，代码库导入github.com/samber/do或github.com/samber/do/v2时，或将手动构造函数注入重构为DI容器时。