---
name: coding-style-golang
description: Use when 编写、生成、修改、编辑、重构或评审任何 Go 代码——涵盖实现功能、修 bug、写测试、性能优化、代码迁移、重命名、加减参数或函数、修改函数签名、定义 struct、处理函数间数据流、JSON 反序列化、code review / PR review。任何会产出或改动 Go 代码的任务（write / edit / refactor / review Go code）都要先加载本 skill，即使用户没有提到风格、规范或最佳实践。只读调查不加载：单纯 debug、定位代码、定位问题、读代码理解逻辑等不改代码的任务不需要加载。
---

# Go 编码风格

**REQUIRED BACKGROUND：先加载 `coding-style`（shared）**——语言无关的原则与"为什么"在那里，章节序号与本文件对应；本文件只放 Go 侧的具体写法。

> 状态：骨架，细则待补充。计划覆盖（与 shared 章节对应）：
>
> 1. 函数边界容器：struct（构造函数 `NewXxx`、值 vs 指针接收者对数据流的影响、不用 `map[string]any` / `any` 穿函数边界）。
> 2. 边界校验与"构造即合法"：构造时返回 error、枚举用自定义类型 + 受限常量集合（`type Side string` + `SideBuy`/`SideSell`）。
> 3. JSON 反序列化分两层：`encoding/json` 的原始 struct（tag 忠实镜像外部形状）→ 内部 struct 转换，或第三方校验库选型。
> 4. 公共 API："accept interfaces, return structs"——参数收小接口，返回具体 struct。