Навык go-dev
Обеспечивает соблюдение стандартов разработки на Go, включая правила именования, обработку ошибок, паттерны конкурентности и практики тестирования.
- Звёзды на GitHub
- 1 061
- Файлы
- 3
- Последний коммит
- 26 авг. 2026 г.
- Лицензия
- —
- Разрешённые инструменты
- —
Что делает навык go-dev?
go-dev — это Agent Skill. Обеспечивает соблюдение стандартов разработки на Go, включая правила именования, обработку ошибок, паттерны конкурентности и практики тестирования.
Сводка сгенерирована из SKILL.md навыка.
О skill go-dev
Этот SKILL позволяет поддерживать высокое качество кодовой базы Go за счет строгого соблюдения отраслевых стандартов. Разработчики могут использовать его для контроля правил именования, паттернов обработки ошибок и безопасности конкурентного выполнения в файлах .go, go.mod и go.sum. Когда агент загружает этот SKILL, он выступает в роли специализированного ревьюера, гарантирующего соответствие коду принципам Effective Go и руководствам Uber Go.
SKILL интегрирует основные команды инструментария, такие как goimports для форматирования, go vet для статического анализа и golangci-lint для комплексных проверок. Он также управляет протоколами тестирования, используя go test с флагами обнаружения состояния гонки (race detection) и покрытия (coverage). Применяя эти правила, агент создает код, позволяющий избежать распространенных ошибок, таких как необработанные ошибки, неправильные жизненные циклы goroutine или неэффективная конкатенация строк в циклах. Он помогает структурировать проекты по стандартным директориям, таким как cmd, internal и pkg, предотвращая использование бессмысленных имен пакетов вроде util или base.
Что агент может делать с ним
- 1Обнаружение проблем с конкурентностьюПроверка того, что goroutine управляются с помощью context, и поиск состояний гонки (data races) во время тестирования.
Написано на основе skill SKILL.md. Каждый сценарий использования проверен по цитате из него.
Как установить навык go-dev
Каждая команда копирует папку навыка в каталог навыков клиента. Перезапустите клиент или начните новую сессию, чтобы загрузить его.Установка навыка go-dev в Плагин
/plugin marketplace add doccker/cc-use-exp /plugin install cc-use-exp@cc-use-exp
Установка навыка go-dev в Claude Code
~/.claude/skills/go-dev/SKILL.md
$ npx degit doccker/cc-use-exp/skills/go-dev ~/.claude/skills/go-devУстановка навыка go-dev в Claude Code (project)
.claude/skills/go-dev/SKILL.md
$ npx degit doccker/cc-use-exp/skills/go-dev .claude/skills/go-devУстановка навыка go-dev в Codex
~/.agents/skills/go-dev/SKILL.md
$ npx degit doccker/cc-use-exp/skills/go-dev ~/.agents/skills/go-devУстановка навыка go-dev в Gemini CLI
~/.gemini/skills/go-dev/SKILL.md
$ npx degit doccker/cc-use-exp/skills/go-dev ~/.gemini/skills/go-devУстановка навыка go-dev в Claude.ai
npx degit doccker/cc-use-exp/skills/go-dev go-dev && zip -r go-dev.zip go-dev # claude.ai → Customize → Skills → + → Create skill → Upload a skill → go-dev.zip
Автоматические проверки
Запущено 15 нояб. 2026 г.Полный отчёт →Ещё не проверен. Навыку нужно 80 баллов, ни одной серьёзной находки и достаточно данных для проверки. Как работают проверки · Что исправить, чтобы получить больше баллов
- Связанный и доступный исходный репозиторийdoccker/cc-use-exp/skills/go-dev is public and reachablegithub.com/doccker/cc-use-exp/tree/HEAD/skills/go-dev ↗Пройдено
- Open source лицензия (OSI)No licenseПроблема
- Коммит или релиз за последний годLast commit 2026-08-26github.com/doccker/cc-use-exp/commits ↗Пройдено
- В скриптах нет загрузки с запуском и кражи учётных данныхNo scripts in the skill folderПройдено
- В SKILL.md нет скрытых инструкцийNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/doccker/cc-use-exp/blob/HEAD/skills/go-dev/SKILL. ↗Пройдено
- Заранее разрешённые инструменты ограниченыNo pre-approved tools; the agent asks before using onegithub.com/doccker/cc-use-exp/blob/HEAD/skills/go-dev/SKILL. ↗Пройдено
- SKILL.md соответствует формату Agent Skillsthe description does not say when to use the skill; the description is only 30 charactersgithub.com/doccker/cc-use-exp/blob/HEAD/skills/go-dev/SKILL. ↗Проблема
SKILL.md
Открыть на GitHubGo 开发规范
参考来源: Effective Go、Go Code Review Comments、uber-go/guide
工具链
goimports -w . # 格式化并整理 import
go vet ./... # 静态分析
golangci-lint run # 综合检查
go test -v -race -cover ./... # 测试(含竞态检测和覆盖率)
命名约定
| 类型 | 规则 | 示例 |
|---|---|---|
| 包名 | 小写单词,不用下划线 | user, orderservice |
| 变量/函数 | 驼峰命名,缩写词一致大小写 | userID, HTTPServer |
| 常量 | 导出用驼峰,私有可驼峰或全大写 | MaxRetryCount |
| 接口 | 单方法用方法名+er | Reader, Writer |
禁止: common, util, base 等无意义包名
import 顺序
import (
"context" // 标准库
"fmt"
"github.com/gin-gonic/gin" // 第三方库
"project/internal/model" // 项目内部
)
错误处理
必须处理错误,不能忽略:
// ✅ 好:添加上下文
if err != nil {
return fmt.Errorf("failed to query user %d: %w", userID, err)
}
// ❌ 差:忽略错误
result, _ := doSomething()
错误包装: 使用 %w 保留错误链,用 errors.Is() / errors.As() 检查
并发编程
基本原则:
- 优先使用 channel 通信
- 启动 goroutine 前考虑:谁来等待它?怎么停止它?
- 使用
context.Context控制生命周期
// ✅ 好:使用 context 控制
func process(ctx context.Context) error {
done := make(chan error, 1)
go func() { done <- doWork() }()
select {
case err := <-done:
return err
case <-ctx.Done():
return ctx.Err()
}
}
数据竞争: 使用 go test -race 检测
测试规范
// 表驱动测试
func TestAdd(t *testing.T) {
tests := []struct {
name string
a, b int
expected int
}{
{"positive", 1, 2, 3},
{"zero", 0, 0, 0},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
got := Add(tt.a, tt.b)
if got != tt.expected {
t.Errorf("Add(%d, %d) = %d, want %d", tt.a, tt.b, got, tt.expected)
}
})
}
}
性能优化
| 陷阱 | 解决方案 |
|---|---|
| 循环中拼接字符串 | 使用 strings.Builder |
| 未预分配 slice | make([]T, 0, cap) |
| N+1 查询 | 批量查询 + 预加载 |
| 无限制并发 | 使用 semaphore 或 worker pool |
| Raw SQL 别名用了保留字 | 避免 year_month/order/status/rank 等 MySQL 保留字做别名 |
# 性能分析
go test -cpuprofile=cpu.prof -bench=.
go tool pprof cpu.prof
项目结构
project/
├── cmd/ # 可执行文件入口
├── internal/ # 私有代码
│ ├── handler/
│ ├── service/
│ ├── repository/
│ └── model/
├── pkg/ # 公共代码
├── go.mod
└── go.sum
详细参考
| 文件 | 内容 |
|---|---|
references/go-style.md |
命名约定、错误处理、并发、测试、性能 |
references/date-time.md |
日期加减、账期计算、AddDate 溢出处理 |
📋 本回复遵循:
go-dev- [具体章节]
Файлы в этом навыке
3Вопросы о навыке go-dev
Как установить навык go-dev в Claude Code?
Выполните npx degit doccker/cc-use-exp/skills/go-dev ~/.claude/skills/go-dev. Claude Code загружает навыки из ~/.claude/skills (все проекты) или .claude/skills (один проект) и использует навык, когда его описание соответствует задаче.
Какие клиенты могут использовать навык go-dev?
Любой клиент, который читает формат Agent Skills: Claude Code, Codex, Gemini CLI и claude.ai (загрузить как ZIP). Скрипты в навыке выполняются только там, где клиент разрешает выполнение кода.