go-ultimate

-ultimate 一款专为编写最佳Go程序而设计的、带有个人偏见的Claude Code技能——该技能综合了四种通用的Go技能和五种代理/MCP捐赠者的技能。它可以将任何Go任务（命令行界面、库、后端服务、MCP服务器、AI代理）路由到正确的架构、约定和审查清单。具有强烈的个人偏见；在冲突时覆盖通用Go样式和lint指导。 > **状态：** v0.4.1。为Claude Code、ZCode和类似的AI编码代理设计。采用MIT许可证。 ## 内容概览 该技能位于[`skills/go-ultimate/`](skills/go-ultimate/)下，并按照渐进式披露的结构组织： | 路径 | 用途 | |---|---| | `skills/go-ultimate/SKILL.md` | 技能本身 — 何时应用、不可妥协的原则、项目类型决策树、冲突优先级。 | | `skills/go-ultimate/references/` | 按需加载的深入研究：`architecture.md`、`engineering-policy.md`、`modern-go.md`、`testing.md`、`code-review.md`、`libraries.md`、`project-layouts.md`、`wiring-and-runtime.md`、`modular-monolith.md`、`mcp-server.md`、`agents.md`。 | | `skills/go-ultimate/assets/` | 按类型生成的项目模板：`cli-simple`、`cli-cobra`、`library`、`game`、`mcp-server`、`webservice`（均使用Go 1.26.x构建成功）。 | | `skills/go-ultimate/scripts/` | `goversion/main.go`（检测项目的`go.mod`版本）和`check-source-versions.sh` + `source-versions.json`（上游捐赠者源的偏移检查器）。 | | `skills/go-ultimate/evals/` | 用于捕获技能偏移的示例提示和预期行为。 | ## 安装 ### 通过Djarvur市场（Claude Code） ```bash claude plugin marketplace add Djarvur/cc-mplace claude plugin install go-ultimate ``` 安装后，技能会自动触发任何Go任务（提及Go、Golang、`go.mod`、Go包、MCP服务器或AI代理）。 ### 手动/非Claude-Code运行 克隆并将您的运行环境指向技能目录： ```bash git clone https://github.com/Djarvur/go-ultimate.git ``` 对于ZCode，将`skills/go-ultimate/`复制或符号链接到`~/.zcode/skills/`。对于Cursor / Codex / OpenCode，请使用已配置的技能目录。`SKILL.md`包含一个`<skill-dir>`解析表，涵盖每个运行环境。 ## 工作原理 触发后，技能： 1. 检测项目的Go版本（`go run <skill-dir>/scripts/goversion/main.go <project>`）并控制功能的使用。 2. 将项目通过决策树（脚本/命令行界面/库/后端服务/MCP服务器/AI代理）路由，并加载匹配的引用。 3. 应用九项不可妥协的原则（现代版本控制的Go、无`pkg/`、上下文优先、薄适配器、并发卫生等）。 4. 通过显式优先级阶梯（架构 → 现代Go → 工程策略 → 库 → 代码审查 → MCP服务器 → 代理）解决冲突。 详见 [`SKILL.md`](skills/go-ultimate/SKILL.md) 获取完整的个人偏见规则集。 ## 捐赠者源 该技能综合了九个上游源。完整的归属和用于检测上游偏移的实时pin在 [`skills/go-ultimate/scripts/source-versions.json`](skills/go-ultimate/scripts/source-versions.json) 中。摘要： **通用Go：** `teetsh-org/claude-skills#golang-code-review`，`JetBrains/go-modern-guidelines#use-modern-go`，`powerman/skills#go-bounded-context-hexagonal`（v0.6.0），`powerman/skills#go-engineering-policy`（v0.0.5）。 **代理/MCP：** `cloudwego/eino`（编排设计 + ADK），`modelcontextprotocol/go-sdk`（v1.6.1），`philschmid.de#mcp-best-practices`，`modelcontextprotocol.info#docs/best-practices`。 > 最初还来源于 `danicat/skills#go-best-practices` 和 `danicat/skills#go-project-setup`；两者都在2026-07-21上游删除。它们提炼的内容现由该技能拥有和维护（`assets/`下的项目设置模板，`references/engineering-policy.md`和`references/code-review.md`中的最佳实践材料）。 ### 检查上游偏移 ```bash bash skills/go-ultimate/scripts/check-source-versions.sh ``` 退出状态0 = 无偏移，1 = 捐赠者自记录pin以来发生变化，2 = 获取失败。在将更改折回技能时，请在`source-versions.json`中刷新pin。 ## 许可证 MIT — 参见 [LICENSE](LICENSE)。