现代 Go 指南(JetBrains)

帮助 AI 编码代理编写现代 Go 代码的官方指南集,涵盖 Go 1.0 至 1.27 的特性。

Star 数
★ 3.9k
最近更新
7 天前
License
Apache-2.0
主语言
Go

30 秒速览

运行形态
Agent 插件 / 技能命令行工具
可在哪里用
兼容但需适配Codex · Claude Code
费用
免费,无需付费服务
上手难度
低 · 几分钟可跑通
开始前需要
Go 1.25+(或更高版本,支持自动工具链切换)Shell / 命令行网络访问
典型场景
使用 Claude Code 的 Go 开发者,希望新生成的代码遵循现代惯用法,而无需手动纠正过时的模式。
不适合
  • 需要完全离线、无法安装 Go 工具链的团队
  • 不使用 Claude Code、Codex、Cursor、Junie 等编码代理的用户
  • 希望一条命令静默更新插件的 Cursor 用户

这个 Agent 能做什么,适合哪些场景?

现代 Go 指南是 JetBrains 发布的一个仓库,提供一组指导原则,供 AI 编码代理在生成 Go 代码时参考,以促使其使用现代惯用法(例如 max(a,b)、slices.Contains、cmp.Or),而不是过时的模式。该指南基于项目的 go.mod 文件检测目标 Go 版本,并引导代理使用与该版本匹配的语言特性和标准库新增功能。仓库包含一个命令行工具(用 Go 编写),该工具在首次使用时通过 'go install' 安装,并作为技能/插件分发给多个 AI 代理(包括 Junie、Claude Code、Codex 和 Cursor),以及通过 skills.sh 分发给其他代理。该工具的目标是 Go 1.25 或更新版本,并使用自动工具链切换(GOTOOLCHAIN=auto)在需要时获取兼容的工具链。指南还涵盖了 'modernize' 分析器针对的所有特性,与 Go 团队的新代码方向保持一致。

该仓库提供一组 Go 指南,AI 编码代理可自动加载(当检测到 Go 任务时)或手动触发。实际操作包括:
- 安装过程通过市场命令(如 Junie 的 '/extensions marketplace add')集成到代理中,然后调用代理的命令(如 '/extensions install')装载技能。
- 代理运行时,会调用一个本地 CLI(通过 'go install' 安装)来读取指南文件,并可能配置代理上下文。
- CLI 以 Go 编写,需要 Go 工具链(1.25+)才能自动安装。它存储在本地缓存(例如 ~/.cache/go-modern-guidelines)中,不修改项目。
- 代理会读取项目的 go.mod 文件以确定 Go 版本,并据此应用相应版本范围内的现代特性。
- 该技能可以通过代理命令显式调用,例如 Claude Code 的 '/modern-go-guidelines:use-modern-go'。
- 更新通过文档化的命令与流程自动或手动执行(如 Claude Code 的自动更新和 reload-plugins)。
- 仓库还包括开发模式(GO_MODERN_GUIDELINES_DEV=1),允许本地构建以测试改动。

  1. 使用 Claude Code 的 Go 开发者,希望新生成的代码遵循现代惯用法,而无需手动纠正过时的模式。
  2. 在 Junie CLI 中工作的开发者,需要自动加载 Go 现代指南,无需额外配置。
  3. 使用 Codex 的团队,希望通过简单的市场命令在多个项目中一致地应用 Go 最佳实践。
  4. 使用 skills.sh 的代理(如 OpenCode)用户,希望以标准方式安装技能,而不特定于某个平台。
  5. Go 项目维护者希望确保 AI 贡献的代码使用最新标准库特性(例如 Go 1.26 中的 errors.AsType)。
  6. 在本地试验指南改进的开发者,希望使用开发模式测试更改,而不会影响发布版本。

如何安装或部署这个 Agent?

根据目标代理有多种安装方式:

Junie CLI:在 Junie CLI 会话中运行:

  1. 添加市场:/extensions marketplace add JetBrains/go-modern-guidelines
  2. 安装扩展:/extensions install modern-go-guidelines

Claude Code:在 Claude Code 会话中运行:

  1. 添加市场:/plugin marketplace add JetBrains/go-modern-guidelines
  2. 安装插件:/plugin install modern-go-guidelines@goland-claude-marketplace

Codex:在终端中运行:

  1. codex plugin marketplace add JetBrains/go-modern-guidelines
  2. codex plugin add modern-go-guidelines@goland-codex-marketplace

Cursor:在终端中运行:

  1. cursor-agent plugin marketplace add https://github.com/JetBrains/go-modern-guidelines
  2. 在 Cursor 会话中使用 /plugins 命令安装。

其他代理(通过 skills.sh):
运行 npx skills add JetBrains/go-modern-guidelines(可选 --skill use-modern-go)。

要求:需要安装 Go 工具链并加入 PATH;自动安装 CLI 时会用到。

如何使用这个 Agent?

安装后,代理会在检测到 Go 任务时自动调用技能。例如,在 Claude Code 中,它会自动触发,或可通过命令手动触发:/modern-go-guidelines:use-modern-go。技能会指导代理读取项目的 go.mod 并应用合适的指南。更新已安装的版本:
- Junie:在 CLI 中运行 /extensions update modern-go-guidelines。
- Claude Code:启用自动更新(在 /plugin 市场中为 'goland-claude-marketplace' 启用,然后如有需要运行 /reload-plugins),或手动执行 claude plugin marketplace update goland-claude-marketplace 和 claude plugin update modern-go-guidelines@goland-claude-marketplace。
- Codex:运行 codex plugin marketplace upgrade goland-codex-marketplace,然后重新安装插件。
- Cursor:运行 cursor-agent plugin marketplace update goland-cursor-marketplace,然后重启 Cursor;如果没有更新,在 /plugins 中重新安装。
- skills.sh:项目安装:npx skills update use-modern-go -p -y;全局安装:-g。

对于本地开发,运行 make dev-install,然后设置环境变量 GO_MODERN_GUIDELINES_DEV=1 以使用本地构建。

这个 Agent 有哪些优点和局限?

优点
  • 由 JetBrains 官方提供,可信度与支持均有保障。
  • 覆盖 Go 1.0 至 1.27 的特性,且与 Go 官方 'modernize' 分析器目标一致。
  • 提供多种代理集成(Junie、Claude Code、Codex、Cursor)以及通用的 skills.sh 途径。
  • 本地 CLI 缓存安装,不修改项目,并通过 GOTOOLCHAIN=auto 自动管理工具链。
  • 提供详细的开发模式,方便测试改动。
局限
  • 需要安装 Go 工具链(1.25+)并配置 PATH;首次安装 CLI 时需要网络连接。
  • 技能自动触发的效果取决于代理实现;用户可能需要手动命令激活。
  • 各代理的安装与更新命令因平台而异,增加了维护成本。
  • Cursor 更新流程需要手动重新安装;没有提供非交互式 CLI 命令。
  • 安装第三方市场时,自动更新默认在 Claude Code 中禁用,需要手动启用。

这个 Agent 与同类方案有什么区别?

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
现代 Go 指南(JetBrains) 当前 56 · 缺口较多 Agent 插件 / 技能免费 ★ 3.9k 7 天前 Go Codex · Claude Code
工作流插件:Claude Workflow V2 50 · 缺口较多 Agent 插件 / 技能免费 + 模型费 ★ 1.4k 21 天前 Python Claude Code
RepoBrain 代码库智能问答引擎 49 · 缺口较多 Agent 插件 / 技能免费 + 模型费 ★ 1.4k 8 天前 Python Codex · Claude Code
cc-skills-golang:Go 语言智能体技能包 35 · 缺口较多 Agent 插件 / 技能免费 + 模型费 ★ 3.6k 22 天前 Go ChatGPT · Codex · Claude Code

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
缺口较多
56/ 100 五分制 2.8 / 5
信任安全 13/29
可靠稳定 8/14
适用触发 12/18
规范维护 10/18
有效结果 9/13
证据核验 4/8
查看各维度的扣分理由
信任安全13 / 29 · 2.2/5

证据显示:CLI 安装到本地缓存,不修改项目,权限最小化;但缺少用户确认机制和详细的数据流说明。扣分:用户确认和数据流透明度不足。

可靠稳定8 / 14 · 2.9/5

证据显示:README 与 FEATURES.md 一致,依赖仅 golang.org/x/mod,但缺少错误处理文档。扣分:失败消息不明确。

适用触发12 / 18 · 3.3/5

证据显示:面向多种代理和场景,明确能力边界,触发机制清晰,环境要求明确。扣分:无重大缺陷。

规范维护10 / 18 · 2.8/5

证据显示:信息架构清晰,安装说明详细,命名稳定,示例丰富,许可证明确,维护责任清晰。扣分:缺少已知限制和版本变更日志。

有效结果9 / 13 · 3.5/5

证据显示:输出直接可用,提供现代 Go 指南,边际价值高,成本低。扣分:无重大缺陷。

证据核验4 / 8 · 2.5/5

证据显示:声明与文件一致,但缺少外部验证。扣分:交叉来源验证不足。

风险与缓解建议
  • 未验证的发布者身份,需谨慎对待。
  • 缺少用户确认机制,可能自动触发。
  • 依赖 golang.org/x/mod,需关注其安全性。
证据充分度:低 评估于 2026年9月7日 审查版本 91a30b36f05b 评估后仓库已有新提交,评分可能未覆盖最新改动
评估证据 README.mdLICENSEgo.mod
查看完整评分方法 →

常见问题

安装这个指南需要付费吗?
仓库本身使用 Apache-2.0 许可证,免费使用。但 JetBrains 或第三方代理是商业产品,需要单独的许可证。
这些指南是否意味着我的项目必须使用 Go 1.27?
不是。指南会根据项目的 go.mod 文件检测 Go 版本,并仅应用该版本及之前可用的特性。
如果我的代理无法自动触发技能,我该怎么办?
你可以通过文档中描述的命令显式调用,例如在 Claude Code 中使用 /modern-go-guidelines:use-modern-go。
安装过程会修改我的项目文件吗?
该 CLI 安装在本地缓存中(例如 ~/.cache/go-modern-guidelines),且“从不修改你的项目”。
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关 Agents