现代 Go 指南（JetBrains）
帮助 AI 编码代理编写现代 Go 代码的官方指南集，涵盖 Go 1.0 至 1.27 的特性。
证据显示：CLI 安装到本地缓存，不修改项目，权限最小化；但缺少用户确认机制和详细的数据流说明。扣分：用户确认和数据流透明度不足。
证据显示：README 与 FEATURES.md 一致，依赖仅 golang.org/x/mod，但缺少错误处理文档。扣分：失败消息不明确。
证据显示：面向多种代理和场景，明确能力边界，触发机制清晰，环境要求明确。扣分：无重大缺陷。
证据显示：信息架构清晰，安装说明详细，命名稳定，示例丰富，许可证明确，维护责任清晰。扣分：缺少已知限制和版本变更日志。
证据显示：输出直接可用，提供现代 Go 指南，边际价值高，成本低。扣分：无重大缺陷。
证据显示：声明与文件一致，但缺少外部验证。扣分：交叉来源验证不足。
- 未验证的发布者身份，需谨慎对待。
- 缺少用户确认机制，可能自动触发。
- 依赖 golang.org/x/mod，需关注其安全性。
这个 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），允许本地构建以测试改动。
- 使用 Claude Code 的 Go 开发者，希望新生成的代码遵循现代惯用法，而无需手动纠正过时的模式。
- 在 Junie CLI 中工作的开发者，需要自动加载 Go 现代指南，无需额外配置。
- 使用 Codex 的团队，希望通过简单的市场命令在多个项目中一致地应用 Go 最佳实践。
- 使用 skills.sh 的代理（如 OpenCode）用户，希望以标准方式安装技能，而不特定于某个平台。
- Go 项目维护者希望确保 AI 贡献的代码使用最新标准库特性（例如 Go 1.26 中的 errors.AsType）。
- 在本地试验指南改进的开发者，希望使用开发模式测试更改，而不会影响发布版本。
这个 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？
根据目标代理有多种安装方式：
Junie CLI：在 Junie CLI 会话中运行：
- 添加市场：
/extensions marketplace add JetBrains/go-modern-guidelines - 安装扩展：
/extensions install modern-go-guidelines
Claude Code：在 Claude Code 会话中运行：
- 添加市场：
/plugin marketplace add JetBrains/go-modern-guidelines - 安装插件：
/plugin install modern-go-guidelines@goland-claude-marketplace
Codex：在终端中运行：
codex plugin marketplace add JetBrains/go-modern-guidelinescodex plugin add modern-go-guidelines@goland-codex-marketplace
Cursor：在终端中运行：
cursor-agent plugin marketplace add https://github.com/JetBrains/go-modern-guidelines- 在 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 以使用本地构建。
常见问题
安装这个指南需要付费吗？
这些指南是否意味着我的项目必须使用 Go 1.27？
如果我的代理无法自动触发技能，我该怎么办？
/modern-go-guidelines:use-modern-go。安装过程会修改我的项目文件吗？
~/.cache/go-modern-guidelines），且“从不修改你的项目”。