用途:在实现或审计 Go 代码时,帮助遵循惯用写法,保持与仓库既有风格一致。
主要能力:构建流程强调优先直白代码而非抽象,尽早处理错误让主路径自上而下可读;沿用仓库已有的标准库惯例,如 context、errors、fmt、io、testing、slog、net/http 等;命名在作用域内简短且具说明性,避免导出标识符重复包名;需要 errors.Is 或 errors.As 时用 %w 包装错误并附加上下文;接受小接口、返回具体类型,避免指向接口的指针;仅在存在真实类型关系时使用类型参数,不用泛型回避清晰的领域代码;谨慎处理 nil,空集合用 nil 切片通常可行,映射写入前必须 make;为导出的包、类型、函数、方法及非显而易见行为写文档注释;编辑后运行 gofmt/goimports,并将生成代码分开存放。
审计流程:判断命名、导出 API、接口或泛型类型前先查看调用点;标记丢失分类、上下文、包装、取消或调用方可操作性的错误处理;检查 context 使用、nil 处理、映射写入、切片、指针与接口选择以及生成代码边界;仅风格问题视为低优先级,除非影响正确性或 API 意图;给出保留仓库既有风格的简洁修复建议;产出完整发现优先的评审时搭配 golang-code-audit。
使用方式:实现 API、错误行为、注释、接口、泛型或清理重构时阅读 references/idioms.md;在声称实现完成前搭配 golang-quality-linting 技能。
限制:资料未提供具体安装命令、收费、平台或效果信息。