前言¶

Go 项目的代码风格问题通常分两层。一层是 gofmt、go vet 这类工具能直接管住的，另一层是工具管不住的：错误处理的返回顺序、接口返回值的语义、map 并发读写、context 传递、命名长度等。这些需要一份统一的、成文的规范，再靠 review 时逐条对照。

麻烦在于，规范本身不容易统一。团队里常见的做法是贴一篇英文风格指南在 wiki 里，实际执行时靠各人记忆，评审标准随人而异。另一种做法是直接照抄某家公司的规范，但原文面向其内部项目结构，落到自己的仓库里会出现”写了也做不到”的条款。

下面介绍的这个 Skill，就是把 Uber Go 风格指南整理成中文学习与工程落地参考，用于在代码评审环节给出一致的修改意见。

这是什么¶

一句话定位：面向 Go 项目的编码规范知识库，内容以 Uber Go 风格指南的中文整理为核心，用于人工或在 Agent 协作中做代码评审时的规范依据。

• 名称：Go 编码规范 工程实践 代码审查
• 坐标：@user_a10ab3ad/uber-go-guide-pl
• 分类：dev-programming
• 来源：community（社区发布，非平台官方出品）
• 发布者：user_a10ab3ad
• 版本：1.0.1
• 是否需要 API Key：不需要（requires_api_key=false）
• 官方地址：https://api.skillhub.cn/user_a10ab3ad/uber-go-guide-pl

它解决的不是”把代码格式化”这件事（那是 gofmt/goimports 的范畴），而是”这段代码为什么不符合团队规范、应该怎么改”的判定与表达问题。

核心能力¶

根据官方页面给出的简介，这个 Skill 提供的能力是：

1. Uber Go 风格指南的中文表述。原文为英文，直接在评审意见里引用英文条款，团队成员的理解成本较高；整理成中文后，意见可以贴具体的规范条目而不是笼统地说”这里不太好”。
2. 工程落地参考。即把指南中的条款对应到实际代码写法上，而不是只讲原则。
3. 代码审查场景。Skill 名称中的”代码审查”指明了主要使用场景：在 review 过程中产出结构化的修改建议。

需要注意的是，官方页面对能力的说明只到这一层，没有列出更细的功能清单（例如是否包含 lint 配置、是否提供修改补丁、是否覆盖并发/错误处理等具体章节）。这部分内容无法从现有资料核实，本文不做推断。

安装与启用¶

官方资料中没有提供一行式的安装命令（如 npx、curl 或 npm 包名），只有 SkillHub 上的坐标与页面地址。因此可用的启用方式是：在支持通用 SKILL.md 格式的 Agent 环境中，把该 Skill 从 SkillHub 加载/添加后启用。

坐标：@user_a10ab3ad/uber-go-guide-pl
版本：1.0.1
来源：community
分类：dev-programming

关于不同编辑器的差异：现有资料没有分别给出 Cursor、Codex CLI、Claude Code 的安装路径。这类 Skill 基于通用 SKILL.md 格式，但各环境的 Skill 加载机制并不完全一致（有的是在项目根目录放 SKILL.md，有的是通过命令行添加），具体做法请以你所用环境的官方文档为准，本文不做未经核实的配置说明。

另外，requires_api_key=false 说明该 Skill 的运行不依赖外部付费模型 API Key，可以直接使用。

典型用法¶

官方资料中没有给出可直接复现的调用示例（例如具体 prompt 写法或输入输出样例），因此本节不给虚构示例，只说明它在流程里的位置：

1. 评审前：把待评审的 Go 文件作为上下文，说明”按 Uber Go 风格指南检查”。
2. 评审中：Skill 依据规范条目逐条给出意见，指向具体行或写法。
3. 评审后：作者按意见修改，再复核。

上面是使用方式的一般描述，不是官方提供的样例。若要确认具体调用形式，建议直接打开官方页面查看其说明。

适用场景与注意¶

适合的场景：

• 使用 Go 的团队，希望在代码评审中统一风格判定标准。
• 新成员上手时，需要一个可查阅的中文规范条目来源，而不是散落在聊天记录里的口头约定。
• 在 Agent 协作的评审流程里，需要一个有明确出处的规范依据，便于作者追溯和反驳。

需要注意的限制：

• 它不是 linter。 能用 gofmt、goimports、staticcheck、go vet 自动检查的部分，仍应由工具完成；这个 Skill 的价值在于工具覆盖不到的那部分规范判断。
• 条款需结合自身项目裁剪。 Uber 的规范服务于其代码规模与组织方式，某些条款（例如大量接口返回值约定、context 传递细节）在小体量项目里可能过重，照抄会带来不必要的成本。
• 资料未覆盖的部分不要假定存在。 官方页面没有列出章节目录、没有给安装命令、没有给使用样例，也没有说明是否随附配置文件。

结尾¶

这个 Skill 的价值在于把 Uber Go 风格指南变成中文的、可引用的评审依据，而不是替代工具链。它适合作为团队 Go 规范的落地层，配合 gofmt 等工具一起使用。

官方地址：https://api.skillhub.cn/user_a10ab3ad/uber-go-guide-pl