代码审查技能

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"要保留，但通常技术术语在中文中可能保留英文或翻译。为了保险，我们保留英文原样，因为它是函数名或

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

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

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

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

Monadic types for Golang using samber/mo — Option, Result, Either, Future, IO, Task, and State types for type-safe nullable values, error handling, and functional composition with pipeline sub-packages. Apply when using or adopting samber/mo, when the codebase imports `github.com/samber/mo`, or when considering functional programming patterns as a safety design for Golang.

Golang的安全最佳实践与漏洞防护，涵盖注入（SQL、命令、XSS）、密码学、文件系统安全、网络安全、Cookie、密钥管理、内存安全及日志记录。适用于编写、审查或审计Go代码的安全性，或处理涉及加密、I/O、密钥管理、用户输入处理或身份验证的高风险代码。包含安全工具的配置。

We need to translate the given text from English to Simplified Chinese. The text describes a Golang configuration library using spf13/viper. We must preserve the name "golang-spf13-viper" but it's not in the text, so we don't include it. We also preserve technical terms like spf13/viper, BindPFlag, etc. The translation should be accurate and natural in Chinese. The text ends with "For CLI command..." which seems incomplete, but we translate as is. Let's translate: "Golang configuration library using spf13/viper — layered precedence (flag > env > file > KV > default), BindPFlag/BindPFlags, SetEnvPrefix + SetEnvKeyReplacer + AutomaticEnv, ReadInConfig + ConfigFileNotFoundError, Unmarshal + mapstructure struct tags, Sub for sub-trees, WatchConfig + OnConfigChange for hot reload, viper.New() for test isolation, and remote KV integration. Apply when using or adopting spf13/viper, or when

全面指南，涵盖stretchr/testify在Golang测试中的使用，深入介绍assert、require、mock和suite包。适用于使用testify编写测试、创建mock、设置测试套件或选择assert与require时。涵盖testify断言、mock期望、参数匹配器、调用验证、套件生命周期以及Eventually、JSONEq和自定义匹配器等高级模式。当代码库导入github.com/stretchr/testify时适用。

Golang 结构体与接口设计模式 — 组合、嵌入、类型断言、类型开关、接口隔离、通过接口实现依赖注入、结构体字段标签、指针接收者与值接收者。在设计 Go 类型、定义或实现接口、嵌入结构体或接口、编写类型断言或类型开关、为 JSON/YAML/数据库序列化添加结构体字段标签、或选择指针接收者与值接收者时使用此技能。当用户...

We need to translate the given text from English to Simplified Chinese. The instruction says: preserve product names, protocol names, URLs, numbers, and technical terms. Do not add claims, explanations, Markdown, bullets, links, labels, prefixes, or extra commentary. Also, do not include the name "golang-testing" unless it appears in the source text. The source text does not include the name, so we don't add it. The text is a description of a skill for Go testing. It lists various testing techniques and tools. We need to translate the entire text inside <text> tags. Let's break it down: "Production-ready Golang tests — table-driven tests, testify suites and mocks, parallel tests, fuzzing, fixtures, goroutine leak detection with goleak, snapshot testing, code coverage, integration tests, idiomatic test naming." Translation: "生产就绪的 Golang 测试 — 表格驱动测试、testify 套件和模拟、并行测试、模糊测试、夹具、使用 goleak 进行 goroutine

当用户想要“编写智能体代码”、“使用ADK构建智能体”、“添加工具”、“创建回调”、“定义智能体”、“使用状态管理”，或需要ADK（智能体开发工具包）Python API模式和代码示例时，应使用此技能。属于Google ADK技能套件的一部分。它提供智能体类型、工具定义、编排模式、回调和状态管理的快速参考。请勿用于创建新项目（应使用google-agents-cli-scaffold）或部署...

使用Graphite（gt）处理堆叠式PR——创建、导航和管理PR堆栈。

运行一项预算感知的代理辅助工程健康审计，检查指令/配置漂移、hooks/MCP、验证器表面及AI可维护性。当用户询问检查claude/检查codex/检查pi/配置检查/健康度，或报告代理忽略指令、缺少验证、代码难以维护时使用。不用于调试代码或审查PR。

在应用修复之前，先找出错误、崩溃、回归、测试失败、行为异常以及截图报告的缺陷的根本原因。当用户询问排查/报错/崩溃/不工作/回归/判断为什么报错，或表示之前能用现在却失败时使用。不适用于代码审查或新功能。

安装并将注册表块和组件接入HyperFrames组合中。在运行hyperframes add、安装块或组件、将已安装项接入index.html或处理hyperframes.json时使用。涵盖add命令、安装位置、块子组合接入、组件片段合并、注册表发现，以及编写新块或组件以向上游贡献（构思→脚手架→验证→PR）。

根据PRD或一组问题实现一项工作。

实现PRODUCT.md和TECH.md中已批准的功能，在同一个PR中随着实现进展保持规格与代码对齐。在产品和技术规格获批、下一步是构建功能时使用。

以高级顾问身份审查任意代码库，生成优先级明确、独立可执行的实施计划，供其他模型/代理执行。严格只读源代码——绝不自行实现、修复或重构任何内容。适用于被要求审计代码库、发现改进机会（漏洞、安全、性能、测试覆盖率、技术债务、迁移、开发者体验）、建议功能或项目下一步方向（路线图、产品规划），或为其他代理生成交接方案时使用。

在代码库中发现深层优化机会，依据CONTEXT.md中的领域语言和docs/adr/中的决策。适用于用户希望改进架构、寻找重构机会、整合紧耦合模块，或使代码库更易于测试和AI导航时使用。

将React项目和组件从Radix UI迁移到Base UI。当被要求从radix迁移、迁移到base-ui、转换radix原语或切换shadcn项目的基础库时使用。处理单个组件（如"迁移accordion"）和整个项目。

Migrate test files from `as` type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace `as` in tests, or needs partial test data.