zero-skills
Скилл учит агента писать сервисы на go-zero: REST и RPC, генерацию через goctl, базы, устойчивость и очереди
- 91 ★ репозитория
- Последний коммит
Минимальный доступ
Почему такой уровень
- Скилл только инструкции и справочники, разрешены чтение и поиск по файлам
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/zero-skillsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Скилл только инструкции и справочники, разрешены чтение и поиск по файлам
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл собирает знания о фреймворке go-zero для микросервисов на Go в одном каталоге: агент читает их и пишет код по соглашениям проекта. В основе трехслойная архитектура Handler, Logic, Model, а справочники в папке `references` разбирают шаблоны REST и RPC, работу с базами и коллекциями, устойчивость, распределенные транзакции, очереди сообщений, наблюдаемость и Swagger. Команды `goctl` собраны в отдельном файле. Есть папки с лучшими практиками, разбором типовых проблем, примером демо-проекта и разбором looklook. Папка `skill-patterns` содержит готовые сценарии для агента: анализ проекта, генерация сервиса, планирование архитектуры. Отдельные руководства в `getting-started` объясняют подключение к Claude Code, Codex, Cursor, GitHub Copilot и Windsurf.
Для кого. Go-разработчикам, которые строят или поддерживают микросервисы на go-zero и хотят, чтобы агент знал соглашения фреймворка.
Подходит, если
- Нужно сгенерировать REST-сервис по файлу `.api` и не нарушить трехслойную структуру проекта
- Надо подключить gRPC-сервис, обнаружение сервисов и middleware
- В сервисе падают запросы под нагрузкой, и нужны шаблоны ограничения и автоматических выключателей
- Проект уже импортирует `github.com/zeromicro/go-zero`, а ревью выявляет нарушения соглашений
Не подходит, если
- Проект на Gin, Echo или стандартном `net/http`: скилл про go-zero и другие фреймворки не знает
- Нужна справка по самому языку Go без привязки к фреймворку
- Вы ищете утилиту генерации кода: скилл только подсказывает агенту команды `goctl` и код сам не генерирует
Пример запроса к агенту
Сгенерируй по файлу user.api сервис go-zero с логином и регистрацией и добавь middleware для проверки токенаОграничения
- Скилл охватывает только go-zero: общий Go-код и другие фреймворки вне его области.
- Права на файлы ограничены разрешениями `Read`, `Grep` и `Glob`, поэтому скилл сам ничего не запускает, это делает агент по вашему согласию.
- Часть материалов, например сравнение инструментов в `getting-started`, описывает поведение сторонних агентов и может устареть.
- Лицензия MIT указана в `SKILL.md`, но в карточке репозитория на GitHub поле лицензии пустое.
Как отключить. Удалите папку скилла: `.claude/skills/zero-skills` в проекте или `~/.claude/skills/zero-skills` в личном каталоге.
Частые вопросы
Как поставить zero-skills в Claude Code?
Выполните `git clone https://github.com/zeromicro/zero-skills.git .claude/skills/zero-skills` в корне проекта или клонируйте в `~/.claude/skills/zero-skills`, чтобы скилл работал во всех проектах. Можно попросить самого агента: установи zero-skills по ссылке на репозиторий.
Когда скилл срабатывает сам?
Когда вы просите собрать, проверить или починить сервис go-zero, упоминаете `goctl`, открываете файлы `.api` или `.proto` либо в проекте есть импорт go-zero.
Чем он отличается от самого goctl?
`goctl` генерирует код по описанию API. Скилл дает агенту знания: когда какую команду вызвать, как устроены слои и что делать с типовыми ошибками.
Есть ли версия на китайском?
Да, в репозитории лежит `README_CN.md` с китайским описанием.
Какие агенты поддерживаются?
Claude Code, OpenAI Codex, GitHub Copilot, Cursor и Windsurf. Для каждого в папке `getting-started` есть отдельное руководство.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкиллы для Go от samber
cc-skills-golang
Больше сорока скиллов по Go: стиль, ошибки, конкурентность, тесты, безопасность, производительность и популярные библиотеки
Набор скиллов для Claude Code и Codex, которые учат агента писать Spring Boot по вашим конвенциям и шаблонам
Набор из 14 скиллов для Java Spring Boot: от анализа требований и генерации кода до тестов, ревью и Docker-развертывания.
Скилл для Claude Code и Codex по Scala в прямом стиле: структурная конкуренция Ox, Tapir, обработка ошибок и конфигурация.
Скиллы для серверного Swift и линтер swift-server-lint: Swift NIO, Hummingbird, Postgres, конкурентность и хук проверки.
Набор из 16 скиллов для Spring Boot: агент сначала изучает приложение, потом правит JPA, DTO, REST, Security, Kafka и тесты.
Коротко о README
README объясняет, что такое скилл агента, зачем нужен этот и как его поставить, и показывает структуру репозитория. Далее идут разделы о том, как работать с разными агентами, и ссылки на справочники по шаблонам. Есть версия на китайском и скрипт проверки обучающего примера.
Бейдж для README
Исходный SKILL.md
--- name: zero-skills description: Use when building, reviewing, or troubleshooting go-zero services, including REST and RPC code generation, middleware, service discovery, database models, collection data structures, resilience, observability, distributed transactions, and message queues. Trigger for goctl, .api or .proto files, or projects importing github.com/zeromicro/go-zero. version: 1.0.0 license: MIT allowed-tools: - Read - Grep - Glob --- # go-zero Skills for AI Agents This skill provides comprehensive go-zero microservices framework knowledge, optimized for AI agents helping developers build production-ready services. It covers REST APIs, RPC services, database operations, resilience patterns, high-performance data structures, and troubleshooting. ## 🎯 When to Use This Skill