用途:本技能处理 linter 无法覆盖、需要人类判断的 Go 代码清晰度问题(格式交由 gofmt、gofumpt、goimports、gocritic、revive、wsl_v5 等处理)。核心理念是“清晰优于聪明”,忽略规则时需在代码中加注释说明。命名、设计模式、结构体/接口等见同仓库的 golang-naming、golang-design-patterns、golang-structs-interfaces 技能。
主要能力与规则:行长无硬性限制,但超过约 120 字符 MUST 在语义边界换行;参数 4 个及以上的函数调用 MUST 每个参数一行。变量声明中 := 用于非零值,var 用于零值初始化。切片与映射 MUST 显式初始化,不可为 nil(nil 映射写入会 panic,nil 切片在 JSON 中序列化为 null);容量已知时可预分配,但不可投机性预分配。复合字面量 MUST 使用字段名。控制流上错误与边界情况优先处理并提前返回,减小嵌套;if 体以 return/break/continue 结束时 MUST 去掉 else;条件含 3 个以上操作数时 MUST 提取为具名布尔变量;同一变量多次比较优先用 switch。函数应短小单一,参数 SHOULD ≤4,超出则用选项结构体,参数顺序为 context.Context 在前、输入次之、输出目标在后。迭代 SHOULD 用 range。小类型按值传参,需要修改、大结构体或 nil 有意义时用指针。文件内按包文档、导入、常量、类型、构造函数、方法、辅助函数的顺序组织,并积极 unexport。字符串简单转换用 strconv,复杂格式化用 fmt.Sprintf,错误消息用 %q,循环拼接用 strings.Builder。类型转换偏好显式且窄,能用具体类型就不用 any。
使用方式:在大代码库中审查代码风格时,可最多并行 5 个子代理,每个覆盖一个独立风格关注点(如控制流、函数设计、变量声明、字符串处理、代码组织),再合并结论;在 Claude Code 上可用 ultracode 显式启用多代理编排。
限制:仅覆盖风格与清晰度约定,不含命名、接口设计与设计模式细节;公司技能若显式覆盖本技能则以其为准。文本未提供版本、安装命令、收费信息与具体评测结果。