SuperAPI AI 工具集

golang-style

编程与开发

查看项目

更新于 10-15 21:47

技能介绍

用途:该技能在创建、修改或向 .go 文件添加代码前触发,用于在写 Go 代码时统一并强制执行一套编码规范。

主要能力:规范覆盖 happy path 编码(让成功路径笔直向下,出错立即返回,避免把主逻辑嵌套在条件中);错误处理(始终用 %w 包装错误并附加上下文,包含操作和相关标识符);哨兵错误(在包级别定义 ErrNotFound、ErrUnauthorized、ErrInvalidInput,并用 errors.Is() 判断);注释规范(所有注释以句号结尾);命名约定(禁止使用 Go 预声明标识符作为变量或参数名,如 new、make、len、cap、append、copy、delete、close、panic、recover、print、println、complex、real、imag、clear、min、max,常量 true、false、iota、nil,以及 error、bool、string、int 等类型名);行长限制(最长 120 字符,在逻辑断点处换行);并倡导遵循 Go Proverbs(如通过通信共享内存、错误是值、不要 panic、清晰优于聪明等)。

使用方式:作为编码前触发的技能,在开始写或改 .go 文件时应用上述约定。可用 go doc 查询标准库与包文档,例如 go doc fmt.Errorf、go doc errors.Is、go doc context。若项目属于 Einride 组织,应始终使用项目内由 Sage 生成的 Makefile(.sage 文件夹)。

适用场景:任何 Go 项目的代码编写与编辑过程,尤其是需要统一团队代码风格、规范错误处理与命名的场景。

限制:资料仅给出编码约定,未提供安装步骤、收费、平台支持范围或效果说明,这些暂未提供。