SuperAPI AI 工具集

go-style-core

通用与其它

查看项目

更新于 10-15 20:30

技能介绍

用途:本技能用于回答和处理 Go 语言的核心代码风格问题,涵盖格式化、行长、嵌套、裸返回(naked return)、分号等内容,也适用于现有风格规则未覆盖时的取舍判断。

主要能力:给出风格原则的优先级顺序——清晰性、简洁性、精炼性、可维护性、一致性;说明格式化要求(必须运行 gofmt,无硬性行长限制但 Uber 建议软上限 99 字符,应按语义而非长度换行,优先重构而非硬折行);提供减少嵌套的做法(先处理错误与特殊情况,用提前返回或 continue 保持“正常路径”不缩进);说明无必要 else(可用默认值加覆盖模式);解释裸返回的使用边界(短函数可用,中长函数应显式返回,不应仅为裸返回而命名返回值);解释分号的自动插入规则及左花括号必须与语句同行。

使用方式:按主题查阅对应参考文件——在清晰性、简洁性、精炼性、可维护性、一致性发生冲突时查阅 references/PRINCIPLES.md;处理 gofmt、换行、空白、注释、分号时查阅 references/FORMATTING.md。

适用场景:编写或审查可读 Go 代码、解决格式与嵌套风格争议、判断裸返回是否合适、排查分号与花括号导致的编译问题。

限制:资料以风格原则与示例说明为主,未提供安装方式、命令配置、收费或性能数据;涉及命名、错误处理、文档、lint、代码审查、日志等主题时,资料指向 go-naming、go-error-handling、go-documentation、go-linting、go-code-review、go-logging 等相关技能。