参与go-modern-guidelines社区Issue、PR与生态扩展全指南【免费下载链接】go-modern-guidelinesHelp AI coding agents write modern Go项目地址: https://gitcode.com/GitHub_Trending/go/go-modern-guidelinesgo-modern-guidelines 是一个帮助 AI 编程智能体AI Coding Agent写出现代化 Go 代码的开源项目。本完整指南面向新手带你从零开始学会三件事如何提交能快速得到响应的 Issue、如何贡献你的第一个现代 Go 编码指南 PR以及如何把这个指南生态扩展到你自己的 AI 开发工具中。先认识项目为什么 AI 需要现代 Go 指南很多 AI 编程助手写出的 Go 代码偏老派明明项目用 Go 1.24它却还在写for i : 0; i n; i而不是for i : range n。原因有两个训练数据滞后模型不知道新特性和频率偏差旧写法在语料里更多。go-modern-guidelines 的解法是给 AI 一份显式参考清单覆盖 Go 1.0 到 1.27 的实用特性。它以一个小 CLI 运行核心只有两个命令见 internal/cli/cli.golist解析项目的 Go 版本后返回该版本可用的现代写法清单新特性优先排序explain按指南 ID 返回详细说明和 Before/After 代码示例版本解析的优先级是显式指定 →go.mod/go.work→ 本地工具链实现见 internal/goversion/goversion.go。核心模块速览模块路径职责main.goCLI 程序入口internal/cli/cli.golist/explain命令分发internal/guidelines/guidelines.json指南数据源唯一事实来源internal/guidelines/schema/schema.go数据校验规则internal/guidelines/featuresgen/main.go从 JSON 生成文档的工具FEATURES.md自动生成的完整指南文档plugin/extension.json插件清单plugin/skills/use-modern-go/SKILL.md给 AI 智能体的技能说明本地开发环境快速配置一条命令跑通全部测试 参与贡献前先把本地环境搭好只需三步1️⃣ 克隆仓库并初始化git clone https://gitcode.com/GitHub_Trending/go/go-modern-guidelines cd go-modern-guidelines2️⃣ 运行全部测试等价于go test ./...make test3️⃣ 熟悉 Makefile 提供的四个维护命令命令作用make test运行所有测试make generate-features从guidelines.json重新生成FEATURES.mdmake dev-install把本地构建装入工具缓存供 AI 智能体试用make dev-uninstall移除本地构建恢复正式版本 环境要求Go 工具链需在 PATH 中CLI 面向 Go 1.25 及以上老版本在GOTOOLCHAINauto默认值下可自动切换工具链。如何提交能快速得到响应的 Issue 这个项目的合并门槛并不高社区贡献者的小改动都在 CHANGELOG.md 里有名有姓#2修正time.Tick在 Go 1.23 的表述#8新增 skills.sh 安装支持#23修正strings_clone指南的可用版本Go 1.18 起提交 Issue 时建议按以下结构组织维护者能更快定位环境信息你的 Go 版本go env GOVERSION、项目go.mod中声明的版本复现命令list或explain的完整调用方式与输出预期 vs 实际例如Go 1.24 的项目用list时没看到某条指南 适合新手认领的 Issue 类型文档勘误FEATURES.md 中某条指南的版本号、描述或示例有误补充示例某条指南缺少典型 Before/After 对比版本覆盖新版 Go 发布后跟进新特性的指南条目你的第一个 PR新增一条现代 Go 指南这是本项目最核心的贡献方式。指南数据是单一事实来源流程固定且可验证第一步编辑 guidelines.json在文件顶部按新特性优先顺序插入新条目。schema.go 会做严格校验PR 不满足以下规则会直接失败id只能用小写字母、数字、下划线且全局唯一since_version必须是major.minor格式且整份文件按版本从新到旧排序impact只能是Critical、High、Medium、Low四档每条指南必须包含guideline一句话规则、details详细说明和至少一组非空的 Before/After 示例第二步重新生成文档并测试make generate-features # 由 featuresgen 重新生成 FEATURES.md make test # 确保数据与文档一致⚠️ FEATURES.md 首行注明了由 JSON 生成勿手改请一定通过生成器更新它。第三步本地预览效果强烈推荐在提 PR 前你可以让本地构建替代正式发布版本直接在 AI 智能体里体验你的改动见 README.md 的 Local development 章节make dev-install export GO_MODERN_GUIDELINES_DEV1 # 启动智能体前导出此变量之后任意安装了该插件的智能体Claude Code、Codex、Cursor 均可都会运行你的本地构建。改完代码再跑一次make dev-install即可热更新make dev-uninstall可还原。Windows 或无make的环境可直接执行 scripts/dev-install.ps1 / scripts/dev-install.sh。第四步更新 CHANGELOG 并提交按 CHANGELOG.md 的现有格式在Unreleased下补一行### Added或### Fixed即可提交 PR。生态扩展把指南接入你常用的 AI 智能体 不想改代码、只想扩展生态这个项目天然支持多智能体接入插件清单见 plugin/extension.json技能定义见 plugin/skills/use-modern-go/SKILL.md。官方已内置四类集成智能体接入方式更新方式Junie CLI会话内/extensions marketplace add/extensions install/extensions updateClaude Code/plugin marketplace add/plugin install开启市场自动更新后/reload-pluginsCodex终端codex plugin marketplace addcodex plugin add刷新市场后重装Cursorcursor-agent plugin marketplace add 会话内/plugins刷新市场后重装其他智能体如 OpenCodeskills.sh 通道npx skills addnpx skills update完整的安装与更新命令都写在 README.md 中照着执行即可。技能是如何驱动智能体的SKILL.md 定义了明确的工作流智能体在改 Go 代码前先调用list优先传入要编辑的文件路径读完完整清单后再针对拿不准的条目调用explain。命令封装脚本为 run-tool.sh 与 run-tool.ps1首次运行时会自动把 CLI 安装到本地缓存目录不污染项目本身。如果你想给自己的智能体接入同类能力直接参考这套先 list 后 explain的调用约定即可。贡献者流程从 Fork 到合并的完整清单✅ 提交流程速查克隆仓库make test确认基线通过修改 guidelines.json数据或其他模块make generate-features同步 FEATURES.mdmake dev-install 设置GO_MODERN_GUIDELINES_DEV1在真实智能体里验证make test全部通过更新 CHANGELOG.md提交 PR附上改动动机与验证结果 从修正一个版本号到新增一条 Go 1.27 新特性指南再到为新的 AI 智能体写适配——go-modern-guidelines 为每种参与深度都留了位置。选一个最适合你的切入点今天就发出你的第一个 Issue 吧。【免费下载链接】go-modern-guidelinesHelp AI coding agents write modern Go项目地址: https://gitcode.com/GitHub_Trending/go/go-modern-guidelines创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
参与go-modern-guidelines社区：Issue、PR与生态扩展全指南
参与go-modern-guidelines社区Issue、PR与生态扩展全指南【免费下载链接】go-modern-guidelinesHelp AI coding agents write modern Go项目地址: https://gitcode.com/GitHub_Trending/go/go-modern-guidelinesgo-modern-guidelines 是一个帮助 AI 编程智能体AI Coding Agent写出现代化 Go 代码的开源项目。本完整指南面向新手带你从零开始学会三件事如何提交能快速得到响应的 Issue、如何贡献你的第一个现代 Go 编码指南 PR以及如何把这个指南生态扩展到你自己的 AI 开发工具中。先认识项目为什么 AI 需要现代 Go 指南很多 AI 编程助手写出的 Go 代码偏老派明明项目用 Go 1.24它却还在写for i : 0; i n; i而不是for i : range n。原因有两个训练数据滞后模型不知道新特性和频率偏差旧写法在语料里更多。go-modern-guidelines 的解法是给 AI 一份显式参考清单覆盖 Go 1.0 到 1.27 的实用特性。它以一个小 CLI 运行核心只有两个命令见 internal/cli/cli.golist解析项目的 Go 版本后返回该版本可用的现代写法清单新特性优先排序explain按指南 ID 返回详细说明和 Before/After 代码示例版本解析的优先级是显式指定 →go.mod/go.work→ 本地工具链实现见 internal/goversion/goversion.go。核心模块速览模块路径职责main.goCLI 程序入口internal/cli/cli.golist/explain命令分发internal/guidelines/guidelines.json指南数据源唯一事实来源internal/guidelines/schema/schema.go数据校验规则internal/guidelines/featuresgen/main.go从 JSON 生成文档的工具FEATURES.md自动生成的完整指南文档plugin/extension.json插件清单plugin/skills/use-modern-go/SKILL.md给 AI 智能体的技能说明本地开发环境快速配置一条命令跑通全部测试 参与贡献前先把本地环境搭好只需三步1️⃣ 克隆仓库并初始化git clone https://gitcode.com/GitHub_Trending/go/go-modern-guidelines cd go-modern-guidelines2️⃣ 运行全部测试等价于go test ./...make test3️⃣ 熟悉 Makefile 提供的四个维护命令命令作用make test运行所有测试make generate-features从guidelines.json重新生成FEATURES.mdmake dev-install把本地构建装入工具缓存供 AI 智能体试用make dev-uninstall移除本地构建恢复正式版本 环境要求Go 工具链需在 PATH 中CLI 面向 Go 1.25 及以上老版本在GOTOOLCHAINauto默认值下可自动切换工具链。如何提交能快速得到响应的 Issue 这个项目的合并门槛并不高社区贡献者的小改动都在 CHANGELOG.md 里有名有姓#2修正time.Tick在 Go 1.23 的表述#8新增 skills.sh 安装支持#23修正strings_clone指南的可用版本Go 1.18 起提交 Issue 时建议按以下结构组织维护者能更快定位环境信息你的 Go 版本go env GOVERSION、项目go.mod中声明的版本复现命令list或explain的完整调用方式与输出预期 vs 实际例如Go 1.24 的项目用list时没看到某条指南 适合新手认领的 Issue 类型文档勘误FEATURES.md 中某条指南的版本号、描述或示例有误补充示例某条指南缺少典型 Before/After 对比版本覆盖新版 Go 发布后跟进新特性的指南条目你的第一个 PR新增一条现代 Go 指南这是本项目最核心的贡献方式。指南数据是单一事实来源流程固定且可验证第一步编辑 guidelines.json在文件顶部按新特性优先顺序插入新条目。schema.go 会做严格校验PR 不满足以下规则会直接失败id只能用小写字母、数字、下划线且全局唯一since_version必须是major.minor格式且整份文件按版本从新到旧排序impact只能是Critical、High、Medium、Low四档每条指南必须包含guideline一句话规则、details详细说明和至少一组非空的 Before/After 示例第二步重新生成文档并测试make generate-features # 由 featuresgen 重新生成 FEATURES.md make test # 确保数据与文档一致⚠️ FEATURES.md 首行注明了由 JSON 生成勿手改请一定通过生成器更新它。第三步本地预览效果强烈推荐在提 PR 前你可以让本地构建替代正式发布版本直接在 AI 智能体里体验你的改动见 README.md 的 Local development 章节make dev-install export GO_MODERN_GUIDELINES_DEV1 # 启动智能体前导出此变量之后任意安装了该插件的智能体Claude Code、Codex、Cursor 均可都会运行你的本地构建。改完代码再跑一次make dev-install即可热更新make dev-uninstall可还原。Windows 或无make的环境可直接执行 scripts/dev-install.ps1 / scripts/dev-install.sh。第四步更新 CHANGELOG 并提交按 CHANGELOG.md 的现有格式在Unreleased下补一行### Added或### Fixed即可提交 PR。生态扩展把指南接入你常用的 AI 智能体 不想改代码、只想扩展生态这个项目天然支持多智能体接入插件清单见 plugin/extension.json技能定义见 plugin/skills/use-modern-go/SKILL.md。官方已内置四类集成智能体接入方式更新方式Junie CLI会话内/extensions marketplace add/extensions install/extensions updateClaude Code/plugin marketplace add/plugin install开启市场自动更新后/reload-pluginsCodex终端codex plugin marketplace addcodex plugin add刷新市场后重装Cursorcursor-agent plugin marketplace add 会话内/plugins刷新市场后重装其他智能体如 OpenCodeskills.sh 通道npx skills addnpx skills update完整的安装与更新命令都写在 README.md 中照着执行即可。技能是如何驱动智能体的SKILL.md 定义了明确的工作流智能体在改 Go 代码前先调用list优先传入要编辑的文件路径读完完整清单后再针对拿不准的条目调用explain。命令封装脚本为 run-tool.sh 与 run-tool.ps1首次运行时会自动把 CLI 安装到本地缓存目录不污染项目本身。如果你想给自己的智能体接入同类能力直接参考这套先 list 后 explain的调用约定即可。贡献者流程从 Fork 到合并的完整清单✅ 提交流程速查克隆仓库make test确认基线通过修改 guidelines.json数据或其他模块make generate-features同步 FEATURES.mdmake dev-install 设置GO_MODERN_GUIDELINES_DEV1在真实智能体里验证make test全部通过更新 CHANGELOG.md提交 PR附上改动动机与验证结果 从修正一个版本号到新增一条 Go 1.27 新特性指南再到为新的 AI 智能体写适配——go-modern-guidelines 为每种参与深度都留了位置。选一个最适合你的切入点今天就发出你的第一个 Issue 吧。【免费下载链接】go-modern-guidelinesHelp AI coding agents write modern Go项目地址: https://gitcode.com/GitHub_Trending/go/go-modern-guidelines创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考