前言¶

用 Agent 写 Go 时，常见问题不是语法错误，而是风格漂移：错误被 panic 或裸返回、接口在实现侧膨胀、errors.Is 用不上。团队若已有约定，还要在每次对话里重复说明。下面介绍 SkillHub 上的 Golangidioms，把错误处理、接口设计等惯用法写进 SKILL.md，供支持 Skills 的客户端在相关任务中加载。

这是什么¶

Golangidioms 是社区来源（community）的 Agent Skill，坐标为 @user_3c6cb52e/golang-idioms-lr-ao90，当前版本 1.0.0，分类为 dev-programming（SkillHub 展示为开发者工具）。发布者为 user_3c6cb52e，许可证为 MIT，标注 requires_api_key=false，无需额外 API Key。

官方简介为：Golangidioms 专用技能，帮助 AI Agent 高效完成相关任务。技能正文以英文撰写，标题为「Go Idioms」，面向在 Claude Code、Codex、Hermes Agent、OpenClaw、QClaw、WorkBuddy 等框架下写 Go 代码的场景；homepage 与 repository 均指向 https://github.com/1991513ccie-png。

核心功能¶

技能内容来自包内 SKILL.md（通用 Skills 格式）。已核实、且文档完整的部分如下。

错误处理（Error Handling）¶

约定库代码通过返回值传递错误，避免在库中 panic；用 fmt.Errorf 与 %w 包装错误，便于调用方使用 errors.Is、errors.As；在合适层级处理错误，避免「记录日志后又把同一错误返回」；对可预期条件定义哨兵错误（sentinel errors）。

文档中包含 LoadConfig 的完整示例，以及 ErrNotFound / ErrUnauthorized 与 errors.Is 的调用示例。

接口设计（Interface Design）¶

强调接口保持精简（约 1–3 个方法）、在使用方定义接口而非实现方、优先小而可组合的接口、复用标准库中的 io.Reader、io.Writer、fmt.Stringer 等；单方法接口命名采用「方法名 + er」；构造函数侧采用「接受 interface、返回 struct」（Accept interfaces, return structs）。文档给出 UserStore 与 NewService 示例。

并发模式（Goroutine and Channel Patterns）¶

文档设有 Worker Pool 小节，但当前从 SkillHub 下载的包内 SKILL.md 在该段代码处被截断，无法据此复述完整 worker pool 实现。使用前若依赖并发章节，建议本地打开安装后的 SKILL.md 核对是否已更新。

除上述正文外，SkillHub 页面未单独列出脚本或 MCP；技能以规则与示例驱动 Agent 行为为主。

安装与启用¶

安装方式以 SkillHub 技能页说明为准：参照 SkillHub 安装与优先源配置，使用 CLI 安装指定坐标。

1、确认本机已有 skillhub：

command -v skillhub && skillhub --version

未安装时，可按官方文档执行完整安装或仅安装 CLI（示例为文档中的 curl 安装脚本）。

2、将技能安装到当前 Agent 会读取的 skills 目录（须使用 --dir，否则默认落在 ./skills/ 且可能不被识别）：

skillhub install @user_3c6cb52e/golang-idioms-lr-ao90 --dir <skills 目录>

常用路径（来自官方安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

安装后按你所用客户端要求重启或刷新，使新 Skill 被加载。本技能不需要配置 API Key。

典型用法¶

启用 Golangidioms 后，在 Go 相关任务中直接描述需求，Agent 应参照 SKILL.md 中的规则生成或修改代码。可复现的核对方式如下。

1、安装到 Cursor 示例如下：

skillhub install @user_3c6cb52e/golang-idioms-lr-ao90 --dir ~/.cursor/skills/

2、在对话中提出与技能正文一致的要求，例如：实现一个从文件加载 JSON 配置的函数，错误需用 %w 包装并带上路径上下文。预期风格应接近技能中的 LoadConfig 模式：

func LoadConfig(path string) (Config, error) {
    data, err := os.ReadFile(path)
    if err != nil {
        return Config{}, fmt.Errorf("reading config %s: %w", path, err)
    }
    var cfg Config
    if err := json.Unmarshal(data, &cfg); err != nil {
        return Config{}, fmt.Errorf("parsing config: %w", err)
    }
    return cfg, nil
}

3、涉及「用户不存在」等业务错误时，可要求使用哨兵错误并在 HTTP 层用 errors.Is 分支，与技能中的 GetUser / ErrNotFound 示例一致。

适用场景与注意¶

适合谁： 经常用 Agent 写或改 Go 服务、工具库，希望输出默认贴近社区惯用法（错误包装、小接口、标准库抽象）的开发者。

平台： 技能元数据声明支持 Claude Code、Codex、OpenClaw 系及 WorkBuddy 等；Cursor 按官方安装文档将包装入 ~/.cursor/skills/ 即可，与其他客户端的差异主要在 skills 目录路径。

数据与热度（SkillHub 抓取）： 评分 100000，下载约 1112 次；具体数字以 SkillHub 页面为准。

限制： 社区技能，正文以英文规则列表为主，不包含项目专属的 go.mod 或 linter 配置；并发章节在当前包内可能不完整。仓库链接指向 GitHub 用户页而非单独 idioms 仓库，定制或排错时需以本地安装的 SKILL.md 为准。

结尾¶

Golangidioms 把 Go 错误处理与接口设计等惯用法沉淀为 Agent 可读的 Skill，适合作为写 Go 时的默认风格约束。安装坐标：@user_3c6cb52e/golang-idioms-lr-ao90。官方入口：SkillHub 技能页，API 坐标页：https://api.skillhub.cn/user_3c6cb52e/golang-idioms-lr-ao90。