面向生产级 Go 项目的 AI Agent 技能集，提供 40+ 原子化可复用指令，为 Claude Code、Cursor、Copilot 等编码助手注入 Go 领域专业知识，支持 CI 自动化代码审查。
cc-skills-golang 是由 samber（Samuel Berthe）维护的面向生产级 Go 项目的 AI Agent 技能集合，当前版本 v1.4.0。项目核心理念是将 Go 工程最佳实践拆解为原子化、可交叉引用的 Markdown 指令集，按需加载到各类 AI 编码助手中。
技能体系#
技能分为两大类：
通用技能（29 个）：覆盖代码风格、数据结构、数据库、设计模式、文档、错误处理、现代化、命名规范、安全、测试、性能、并发、上下文管理、CI/CD、依赖注入、依赖管理、接口与结构体、lint、可观测性、项目布局等，其中 13 个为推荐技能。
工具技能（14 个）：覆盖 Google Wire、gRPC、GraphQL、Cobra CLI、Viper 配置、Swagger、Uber Dig/Fx、samber 系列库（do、hot、lo、mo、oops、ro、slog）、stretchr/testify 等。
调度机制#
- 按需加载：描述字段（~100 token）常驻用于触发判断；完整 SKILL.md 仅在激活时加载；二级 markdown 按需读取，不占用上下文预算
- 原子化 + 交叉引用：每个概念只属于一个技能，其他技能通过
samber/cc-skills-golang@<skill>格式引用，避免重复 - 可覆盖机制：企业可在自有技能中声明覆盖社区默认技能
- 指令触发：部分技能支持斜杠命令手动调用（如
/golang-performance） - 深度思考：安全审计、性能分析、troubleshooting 等技能标记需要 ultrathink 模式
Token 预算管控#
- 单个 SKILL.md 建议 < 2,500 token
- 同时加载技能总计建议 < 10,000 token
AI 驱动代码审查（CI 集成）#
提供完整的 GitHub Actions 工作流，将 AI Agent 作为 PR Reviewer：
| 审查维度 | 严重性策略 | 关联技能 |
|---|---|---|
| Quality（质量） | Suggestion-first | code-style, naming, documentation |
| Correctness（正确性） | Blocking-first | error-handling, safety, concurrency |
| Security & Dependencies | Blocking-first | security, dependency-management |
| Tests, Performance & Observability | Important/Suggestion | testing, performance, observability, modernize |
| CI Failure Diagnosis | — | 自动诊断失败原因 |
| Discuss | — | 对人工评论进行讨论回复 |
评测数据#
项目自有对抗性评测：有技能正确率 98%（3315/3395）vs 无技能 56%（1915/3395），提升 +41pp。该数据基于项目自有评测集，各技能维度的细分评测明细未完全公开。
安装与使用#
通过 npx skills CLI 统一安装：
# 安装所有技能
npx skills add https://github.com/samber/cc-skills-golang --all
# 安装单个技能
npx skills add https://github.com/samber/cc-skills-golang --skill golang-performance
# CI 集成
npx skills add https://github.com/samber/cc-skills-golang -a claude-code --skill '*' -y --copy
支持参数：--all（全部安装）、--skill <name>（指定技能，支持 '*' 通配）、-a <agent>（指定目标 agent）、--copy（复制到本地 .agents/ 目录）、-y（跳过确认）。插件配置 .claude-plugin/plugin.json、.cursor-plugin/plugin.json、gemini-extension.json 三者版本必须保持一致。
兼容性#
兼容 Claude Code、Cursor、GitHub Copilot、Gemini CLI、OpenCode、Codex、Antigravity、Openclaw 等主流 Agent 工具，同时兼容 Snyk agent scanner 安全扫描规则（W011/W012/W001）。GitHub Copilot 通过项目根目录 .github/copilot-instructions.md 文件集成。
架构概览#
skills/
<skill-name>/
SKILL.md # 必需：YAML frontmatter + 指令体
references/ # 可选：按需加载的详细文档
scripts/ # 可选：可执行脚本
assets/ # 可选：模板、资源、linter 配置等
evals/ # 可选：对抗性评测场景
遵循 Agent Skills 规范，集成 ClawHub 技能市场。