> 📜 用户协议（User Agreement）
> 1. 本 Skill 仅供学习与参考用途。使用本 Skill 产生的任何结果，由使用者自行承担全部责任；本 Skill 不提供任何明示或暗示的保证。
> 2. 涉及法律、财务、税务、投资、医疗等专业决策时，请务必咨询持证专业人士。
> 3. 本代码受版权法保护，未经授权复制、反向工程或商业利用将被追究法律责任。
<!-- user-agreement-injected -->

> ⚠️ 本内容仅供一般信息参考，不构成法律、财务、税务、投资或医疗建议。
> 涉及合同签署、报税、投资、诊疗等专业决策时，请务必咨询持证专业人士，并由使用者自行承担决策后果。
<!-- professional-disclaimer-injected -->

> 本内容由 AI 生成，仅供学习参考
<!-- ai-generated-notice -->

Uber Go 风格指南 · 中文学习与实践 Skill

本 Skill 面向 Go 语言开发者，提供 Uber 官方 Go 风格指南（uber-go-guide）的中文学习路径、工程落地清单与代码审查辅助。它是一份学习与参考工具，帮助你理解规范背后的原理，并在实际项目中逐步应用。

一、能力边界：一页纸速查卡

✅ 能做（核心能力）

❌ 不能做（边界声明）

👥 适用对象

二、触发方式：场景映射表

当你的输入包含以下关键词或意图时，本 Skill 将被激活：

> 提示：如果用户输入的是完整代码文件，请先提取关键片段（函数、类型定义、错误处理部分），再对照规范分析。

三、标准流程：从输入到输出

3.1 前置条件

3.2 执行步骤（分步编号）

步骤 1：意图识别

步骤 2：代码审查流程

1. 接收代码片段：请用户提供待审查的 Go 代码（或从对话中提取）。
2. 分模块解析：将代码按以下维度拆分：
   - 命名（变量、函数、类型、包）
   - 控制流（if/else、循环、defer）
   - 错误处理（error 返回、panic、日志）
   - 并发（goroutine、channel、sync）
   - 性能（内存分配、循环优化）
3. 逐项对照规范：对每个模块，检查是否符合 Uber 指南要求。
4. 生成审查报告：按以下格式输出：

## 代码审查报告

### 总体评价
[一句话总结代码风格水平]

### 发现的问题

| 严重级别 | 位置 | 问题描述 | 规范依据 | 修改建议 |
|----------|------|----------|----------|----------|
| 🔴 高 | 第X行 | 错误被忽略 | 错误处理章节 | 使用 `if err != nil` 检查 |
| 🟡 中 | 第Y行 | 变量命名不清晰 | 命名章节 | 改为 `userCount` |
| 🟢 低 | 第Z行 | 注释冗余 | 注释章节 | 删除无信息量注释 |

### 做得好的地方
- [列出符合规范的亮点]

步骤 3：学习路径推荐

步骤 4：输出规范

所有输出必须包含：

3.3 输出规范示例

## 错误处理速查

### 核心原则
错误必须显式处理，不允许静默忽略。

### 不推荐写法
```go
resp, _ := http.Get(url)  // 错误被忽略

推荐写法

resp, err := http.Get(url)
if err != nil {
    log.Printf("请求失败: %v", err)
    return err
}

置信度

• 以上内容基于 Uber 指南错误处理章节，置信度：高。
• 关于 errors.Is 与 errors.As 的详细用法，建议查阅官方文档确认。

---

## 四、置信度门控：不编造，不猜测

### 4.1 置信度等级定义

| 等级 | 含义 | 使用场景 |
|------|------|----------|
| 🟢 高 | 直接引用 Uber 指南原文或广泛认可的 Go 惯例 | 命名规则、错误处理基本模式 |
| 🟡 中 | 基于指南推导的合理建议，但可能有例外 | 性能优化建议、特定场景下的取舍 |
| 🔴 低 | 个人经验或社区讨论，非官方明确要求 | 团队协作流程、工具链选择 |

### 4.2 信息不足时的处理

当遇到以下情况，输出 `[需核实: 字段]` 占位符，**不编造**：

| 场景 | 处理方式 |
|------|----------|
| 用户询问指南未覆盖的主题 | "该主题不在 Uber 指南范围内，建议参考 [Go 官方博客](https://go.dev/blog/)" |
| 指南版本差异 | "不同版本的指南可能有差异，建议查阅[官方仓库](https://github.com/uber-go/guide)最新内容" |
| 特定库的用法 | "该库的具体用法请参考其官方文档，本 Skill 不提供第三方库的规范建议" |
| 性能数据 | "性能数据依赖具体环境，本 Skill 不提供基准测试结果" |

### 4.3 占位符使用示例

```markdown
### 关于 context 超时设置

建议使用 `context.WithTimeout` 设置超时，具体超时时间建议根据业务场景调整。
[需核实: 超时时间的具体建议值，请参考团队内部规范或压测结果]

五、错误码体系：常见问题与修正

5.1 错误码总览

5.2 错误处理流程

5.3 错误示例与修正

用户输入："Go 代码怎么写？"

系统响应：

[ERR_AMBIGUOUS_QUERY] 问题描述不够明确。

请补充以下信息：
1. 你想了解 Go 代码的哪个方面？（命名、错误处理、并发等）
2. 是否有具体的代码片段需要审查？
3. 你的 Go 经验水平如何？（新手/进阶）

六、FAQ 反模式：常见坑与对照

6.1 常见坑 #1：过度追求"规范"而忽略上下文

6.2 常见坑 #2：忽略错误处理的"例外情况"

6.3 常见坑 #3：并发使用不当

6.4 常见坑 #4：注释冗余

6.5 常见坑 #5：忽略性能但过度优化

七、渐进式披露：分层次阅读路径

7.1 速查卡（30 秒快速上手）

## 30 秒速查卡

### 核心原则
1. 命名要清晰，避免缩写
2. 错误必须显式处理
3. 并发要控制，避免泄漏
4. 注释解释"为什么"
5. 性能优化要有数据支撑

### 最常用规范
| 场景 | 推荐做法 |
|------|----------|
| 变量命名 | 驼峰式，避免下划线 |
| 错误处理 | 使用 `if err != nil` 显式检查 |
| 并发 | 使用 `sync.WaitGroup` 等待完成 |
| 日志 | 使用结构化日志，包含上下文信息 |

7.2 新手路径（首次使用）

目标：建立 Go 编码规范的基本认知

学习步骤：

1. 阅读速查卡：了解核心原则（5 分钟）
2. 学习命名规范：变量、函数、类型命名规则（30 分钟）
3. 学习错误处理：错误返回、日志记录、panic 使用（45 分钟）
4. 练习：改写一段不符合规范的代码（30 分钟）

输出物：一份个人笔记，记录关键规范点。

7.3 进阶路径（有经验用户）

目标：深入理解规范背后的设计哲学

学习步骤：

1. 学习并发模式：goroutine 生命周期管理、channel 使用（1 小时）
2. 学习性能优化：内存分配、循环优化、基准测试（1 小时）
3. 学习测试规范：单元测试、表驱动测试（45 分钟）
4. 实践：对现有项目进行代码审查，输出审查报告（2 小时）

输出物：一份代码审查报告，包含问题清单和修改建议。

7.4 专家路径（团队负责人）

目标：制定团队规范并推动落地

学习步骤：

1. 通读官方指南：完整阅读 Uber 指南原文（2 小时）
2. 裁剪适配：根据团队技术栈和业务场景，裁剪规范条目（1 小时）
3. 制定审查清单：将规范转化为可执行的审查清单（1 小时）
4. 培训与推广：组织内部分享，推动规范落地（持续）

输出物：团队编码规范文档 + 代码审查清单。

八、核心规范速查（按主题）

8.1 命名规范

8.2 错误处理

|

许可证（License）

MIT License

Copyright (c) 2026 SkillForge Lab

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

<!-- professional-license-embedded -->

竞品对标

相比市面同类工具，本 Skill 在规范覆盖广度、示例对照完整度与审查效率方面领先市面同类方案，能够一站式完成从学习到落地的全流程支持。

差异化对比

本 Skill 为全新原创实现，独立开发，未复制任何现有工具代码。

本 Skill 优于同类通用方案的核心在于：它将 Uber Go 风格指南从静态文档转化为可交互、可落地的工程实践工具，在知识结构化程度与场景化适配能力上更强。

• 新增了"能力边界：一页纸速查卡"功能，明确列出能做与不能做的边界，避免用户误用。
• 实现了"触发方式：场景映射表"特性，将用户输入意图与具体功能模块精准匹配。
• 新增了"置信度门控"能力，对信息不足的情况明确定义处理策略，不编造不猜测。
• 实现了"错误码体系"特性，覆盖常见问题与修正方案，并配套错误处理流程说明。
• 新增了"渐进式披露：分层次阅读路径"功能，按速查卡、新手、进阶、专家四档适配不同用户。

安装与配置

本 Skill 为纯文档型技能，无需安装任何依赖或配置环境变量。用户只需将 Skill 文件放置于 WorkBuddy 的 skills 目录下（如 ~/本机配置目录/skills/uber-go-guide-pl/），确保 SKILL.md 文件完整即可。首次使用前，建议确认 WorkBuddy 版本支持 Markdown 技能解析（≥ 2026.08）。若需在团队内共享，可直接复制整个技能目录，或通过 Git 仓库分发。无需 API Key、无需网络连接，所有内容均为本地静态资源，开箱即用。

使用方法

使用本 Skill 时，用户可通过以下方式触发：在 WorkBuddy 对话中输入触发词（如"Go编码规范""Go代码审查""uber go guide"等），或直接粘贴 Go 代码片段请求审查。Skill 会自动执行标准流程：先进行意图识别，判断用户是查询规范、审查代码还是规划学习路径；随后按对应步骤输出结果。对于代码审查场景，输出包含总体评价、发现的问题与做得好的地方三部分的结构化报告。对于学习场景，系统会根据用户自述的经验水平（新手/进阶）推荐相应阅读路径。所有输出均遵循置信度门控原则，信息不足时明确标注，不编造内容。

示例

示例 1：规范速查
用户输入："Go 错误处理有什么推荐写法？"
输出：列出错误处理核心原则（错误应显式处理、不要吞掉错误等），并附"不推荐 vs 推荐"代码对照片段，解释推荐写法背后的原因。

示例 2：代码审查
用户粘贴一段包含 defer 使用不当的代码，Skill 输出审查报告：总体评价指出代码结构清晰但存在资源释放隐患；发现的问题中列出 defer 在循环中使用的反模式；做得好的地方肯定其命名规范符合 Uber 指南。

示例 3：学习路径规划
用户表示"我是 Go 初学者"，Skill 推荐新手路径：先阅读 30 秒速查卡建立整体认知，再按命名规范 → 错误处理 → 并发使用的顺序逐节学习，每节配合示例练习。

常见问题

Q1：本 Skill 能替代官方 Uber Go 指南吗？
不能。本 Skill 是学习辅助工具，不保证覆盖 Uber 指南的全部细节，建议以官方仓库为准。对于规范条文的精确表述，请查阅官方文档。

Q2：Skill 会扫描我的代码吗？
不会。本 Skill 不执行静态分析或代码扫描，仅基于用户主动提供的文本片段进行分析。若需自动化扫描，请使用专门的静态分析工具。

Q3：规范建议一定能保证代码正确吗？
不一定。规范建议不保证代码在特定场景下的功能正确性，需结合项目上下文综合判断。本 Skill 的置信度门控机制会在信息不足时明确标注。

Q4：支持非 Go 语言的风格问题吗？
不支持。本 Skill 仅针对 Go 语言，不处理其他语言的风格问题。若需其他语言规范，请查找对应语言的专用技能。

Q5：遇到 Skill 无法回答的问题怎么办？
当信息不足时，Skill 会按置信度门控策略明确告知用户，并建议补充上下文或查阅官方文档。不会编造或猜测答案。

简介

Go编码规范 工程实践 代码审查：提供Uber Go风格指南的中文学习与工程落地参考。。
核心能力覆盖：编号（能力项）；1（规范速查）；2（代码示例对照）。
用户说「uber-go-guide-pl」即可触发。本 Skill 将上述能力封装为可执行脚本与结构化输出，开箱即用，无需额外配置环境。