用途:该技能针对 Google Go 风格指南中的“Decisions(决策)”部分提供专家级指导,关注为保证大型 Go 代码库一致性、可读性和可维护性所做的具体选择与权衡。
主要能力:核心原则包括清晰优先于简洁、保持与代码库既有模式一致、遵循 Go 惯用写法、除测试与生成代码等特例外避免下划线。覆盖命名约定(包名、接收者名、常量名、首字母缩略词大小写、Getter 省略 Get 前缀、变量名长度与作用域匹配)、注释(约 80 字符行宽、导出名必须有以自身开头的完整句子文档注释、用 ExampleXxx 记录公开 API)、错误处理(error 作为最后一个返回值、成功返回 nil、导出函数返回 error 接口、错误字符串不大写且无结尾标点、尽早处理错误保持快乐路径缩进最小、不用带内错误值)、语言构造(复合字面量、优先 nil 切片、括号对齐、函数签名格式)、panic 与 recover(仅用于不可恢复状态、Must 前缀约定)以及复制含锁结构体的注意事项。
使用方式:工作流为设计时遵循“最小机制”原则规划 API,实现时遵循上述风格决策,用 golangci-lint 或 go vet 检查常见风格违规,在 _test.go 中为公开 API 提供可运行示例,评审时确保变更符合清晰与一致的核心原则。完整指南见 references/decisions.md。
适用场景:编写或评审 Go 代码、统一团队风格、设计公开 API 时参考。
限制:资料未提供安装命令、收费方式、支持平台或具体效果数据。