القائمة
Philosophy — манифест разработки vmkteam: Go idioms, принципы, архитектурная культура. Используй как справку при спорных решениях по коду/архитектуре и при обосновании стиля проекту.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
API Health — проверка здоровья JSON-RPC сервиса через SMD. Используй когда нужно убедиться что RPC-endpoint жив, собрать тайминги методов или диагностировать недоступность API.
Appkit — библиотека vmkteam/appkit: метрики, pprof, HTTP client, service metadata, X-Request-ID. Используй при подключении метрик/pprof в сервис, работе с HTTP-клиентом appkit или добавлении корреляционных ID.
CI/CD — GitLab CI + Nomad deploy для Go-сервисов vmkteam. Используй при редактировании .gitlab-ci.yml, *.nomad.hcl, настройке пайплайна или дебаге деплоя.
Colgen — генератор коллекций для Go-структур. Используй при работе с collection.go и конвертерами между слоями.
Commit message — краткое сообщение коммита на английском из git diff. Используй перед `git commit`, после /solve, или при явной просьбе 'сгенерируй commit message'.
Cron — менеджер cron-задач с UI, middleware и Prometheus-метриками. Используй при добавлении/правке cron-задачи, подключении пакета vmkteam/cron или настройке CronConfig.
| name | philosophy |
| description | Philosophy — манифест разработки vmkteam: Go idioms, принципы, архитектурная культура. Используй как справку при спорных решениях по коду/архитектуре и при обосновании стиля проекту. |
Принципы разработки vmkteam. Источник: https://vmkteam.dev
Конкретные правила, которых придерживаемся на всех слоях. Большинство — mainstream Go, часть — vmkteam-специфика (явно помечено).
context.Context — всегда первый аргумент (после receiver), никогда не в структурахerror — последний возврат. Ошибки не теряютсяfmt.Errorf("context: %w", err). Проверка: errors.Is / errors.As. Свои типы ошибок — через структуру с методом Error(), а не sentinel stringdefer для ресурсов сразу после захвата. defer rows.Close(), defer mu.Unlock()util, common, helpersctx + errgroup — базовый паттернRun(ctx) error, возврат при ctx.Done() (см. /gold-arch)Get: user.Name(), не user.GetName()userID, HTTPServer, URLi, u (короткое), параметр функции — длиннее и содержательнееtesting.B + go test -benchpprof через /appkit когда нужно искать узкие места на живом сервисеtype Service struct { embedlog.Logger } (/embedlog)domain, service, utils как зонтик для всего подрядinterface{} / any без причины — лучше generic или конкретный типdevel). Устаревшая база = устаревший анализ и ревьюdocs/llm/ (tasks/ для задач, incidents/ для инцидентов) — прозрачность процесса| Стадия | БД | Миграции | Мониторинг |
|---|---|---|---|
| Идея | sql файл актуальный, make db с нуля | Нет | Нет |
| Dev | + pgmigrator, sql всё ещё актуальный | Да | Sentry, возможно Prometheus |
| Production | + полный мониторинг | Да | Sentry, Prometheus, Loki, Grafana, Nomad |