用途:该技能面向 Go 开发,帮助按 Google Go 风格指南编写、重构或审查代码,目标是产出可读、可维护且符合惯用法的 Go 代码。
主要能力:按优先级给出风格原则——清晰(优先易读而非易写,解释原因而非行为)、简洁、最少机制(优先切片、映射、通道等核心语言构造,而非复杂机制或外部库)、精炼(高信噪比、避免重复与多余抽象)、可维护(API 平滑演进、减少依赖、完善测试)、一致(与项目、包或文件中的同类代码保持一致)。
核心规范:所有代码必须符合 gofmt 输出;命名使用 MixedCaps 或 mixedCaps,禁止下划线,首字母缩略词保持大小写一致(如 serveHTTP、URL、ID、JSON),名称简洁且结合上下文,接收者用 1-2 个字母并在类型的所有方法中保持一致;行长度无固定限制,过长应重构而非简单拆分;错误处理使用 if err := doSomething(); err != nil 惯用法,保持快乐路径靠左,偏离常见惯用法时加注释说明,用 %w 包装上下文,错误字符串不大写、不以标点结尾;并发用通道做编排与通信、互斥锁保护共享状态,启动 goroutine 必须有明确终止方案(如 context.Context);接口在消费方定义、保持小而聚焦(常为 1-2 个方法),并权衡抽象收益与信息损失;接收者类型保持一致,大结构体或需修改时用指针接收者;每个导出符号必须有文档注释,用完整句子并以符号名开头,重点解释原因;测试优先表驱动,包含可运行示例,失败信息应可操作,避免断言库,测试中直接覆盖绑定的 flag 值而非使用 flag.Set。
使用方式:资料未提供具体安装命令或调用步骤,仅说明完整指南见 references/guide.md。工作流为分析需求与现有 Go 环境、按最少机制设计、实现惯用代码、应用 gofmt、编写表驱动测试并确保高覆盖与清晰诊断。
适用场景:Go 代码编写、重构、代码审查与风格统一。
限制:资料未提供收费、价格、平台支持范围等信息;具体安装与集成方式暂未提供。