JetBrains/go-modern-guidelines

TL;DR

这是 JetBrains 官方发布的一套针对 AI Coding Agent（如 Claude Code、Cursor）的 Go 语言现代风格指南插件。它通过显式注入 modernize 分析器覆盖的规范，解决 AI 生成陈旧 Go 代码的问题。

它解决什么问题

AI 编码助手生成的 Go 代码往往滞后于语言演进，主要受限于两个因素：一是训练数据的时间截断（Training data lag），导致模型无法知晓 Go 1.26+ 等新特性；二是频率偏差（Frequency bias），即使模型知道新语法，也倾向于生成训练集中占比更高的旧模式。该项目旨在通过提供显式的 Prompt 规范，确保 Agent 从生成阶段就使用现代 Go Idioms。

核心做法

项目本质是一个 Skill/Plugin，包含详细的指令文档（SKILL.md）。其逻辑核心是： 1. 版本感知：Agent 首先检测项目 go.mod 中的 Go 版本号。 2. 特性映射：根据版本，Agent 被指示使用从 Go 1.0 到当前最高支持版本（如 Go 1.26/1.27）的标准库和语法特性。 3. 模式替换：强制使用现代替代方案，例如用 max(a, b) 代替 if-else，slices.Contains 代替手动循环，以及 Go 1.26 的 errors.AsType[T]。

作者

由 JetBrains（GoLand、IntelliJ IDEA 的开发商）官方维护。作为 Go 生态中最核心的 IDE 厂商，JetBrains 对 modernize analyzer 有深度参与。这保证了指南与官方工具链的演进方向高度一致。

社区反应

项目上线时间极短（2025年底创建），但已迅速获得 2,570 Stars 和 8 个 Open Issues。考虑到 JetBrains 在 Go 社区的权威地位以及 AI Coding Agent 的爆发式增长，这一数据表明开发者对“修正 AI 代码质量”有强烈需求。目前处于 MVP/早期采用阶段，Issue 较少说明核心功能稳定。

怎么上手

1. 环境依赖：本地需安装 Go Toolchain（Go 1.25+），用于运行 CLI 缓存工具。
2. 安装方式： - Claude Code: /plugin marketplace add JetBrains/go-modern-guidelines 后安装。 - Cursor: cursor-agent plugin marketplace add ... - 其他 Agent (via skills.sh): npx skills add JetBrains/go-modern-guidelines
3. 开发调试：设置 GO_MODERN_GUIDELINES_DEV=1 环境变量，并使用 make dev-install 加载本地构建版本。

争议与局限

• 仅覆盖 Go：目前专注于 Go 语言，未涉及其他主流后端语言的现代化规范。
• 被动触发：Agent 仅在检测到 Go 任务时自动调用，无法作为全局代码审查工具强制重构历史遗留代码。
• 版本兼容性推断：虽然支持自动检测 go.mod，但对于极老旧项目（如 Go 1.0-1.5），现代特性的适用性可能受限，README 未明确说明此类边缘情况的降级策略。

相关项目

• golang.org/x/tools/gopls — Go 官方语言服务器，提供 modernize analyzer 用于静态代码分析和自动修复。
• gofumpt — 专注于 Go 格式化的工具，解决代码风格一致性问题，但不涉及语义层面的现代特性替换。
• mvdan.cc/gofumpt — 同上，强调严格的格式化规范，与 AI Agent 的生成逻辑互补。
• ai-code-guidelines — 假设存在的通用 AI 编码规范库，通常缺乏特定语言版本演进的动态适配能力。
• cursor-rules — Cursor 编辑器通用的规则文件机制，可手动编写 Go 规范，但缺乏 JetBrains 官方的标准化维护。