К основному содержанию
скилл CX Codex

git-workflow · oakoss — скилл для Claude Code: что делает и как установить

Скилл git-workflow помогает агенту выстраивать trunk-based разработку, оформлять conventional commits, настраивать пайплайны GitHub Actions и чистить историю Git.

MIT 149 установок ★ 29 обновлён 2026-08-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add oakoss/agent-skills --skill git-workflow -a claude-code
Открыть на GitHub

Что делает git-workflow

Скилл задаёт правила работы с репозиторием: короткоживущие ветки со сроком жизни до 48 часов, линейную историю через rebase и оформление коммитов по стандарту Conventional Commits в повелительном наклонении. Он описывает требования к предварительным проверкам перед слиянием (линтер, тесты, проверка типов и безопасности) и правила версионирования через Semantic Release или Changesets.

Внутри собраны шаблоны модульных CI/CD пайплайнов на GitHub Actions с переиспользуемыми воркфлоу и авторизацией через OIDC вместо статических токенов. Для исправления истории скилл ориентирует агента на безопасный git filter-repo вместо устаревшего git filter-branch, а при потере коммитов предлагает восстановление через git reflog, git cat-file и git fsck.

Работу с интерфейсом GitHub CLI скилл не охватывает — для этого у автора предусмотрен отдельный скилл github-cli.

Какие задачи решает

  • настроить trunk-based модель ветвления и защиту главной ветки
  • составить цепочку коммитов по спецификации Conventional Commits
  • сконфигурировать модульные пайплайны GitHub Actions с OIDC
  • восстановить потерянные коммиты через reflog и проверку объектов

Примеры запросов агенту

  • Спланируй правила версионирования и ветвления для нового проекта
  • Напиши переиспользуемый воркфлоу GitHub Actions для запуска тестов и линтера
  • Помоги достать случайно удалённый коммит из git reflog

Как установить git-workflow

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill git-workflow -a claude-code

2Вручную: положить файлы

~/.claude/skills/git-workflow/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/git-workflow/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о git-workflow

Как установить git-workflow в Claude Code?

Выполните команду npx skills add oakoss/agent-skills --skill git-workflow -a claude-code. Конфигурация запишется по пути ~/.claude/skills/git-workflow/SKILL.md.

Что делает скилл git-workflow?

Он передаёт ИИ-агенту регламенты для работы с Git: правила именования веток, шаблоны Conventional Commits, практики rebase для линейной истории и схемы CI/CD пайплайнов.

Управляет ли скилл утилитой gh?

Нет, вызовы GitHub CLI вынесены в отдельный скилл github-cli. Этот скилл фокусируется исключительно на структуре Git-процессов, очистке репозитория и конфигурациях GitHub Actions.

Исходный текст

SKILL.md · MIT
---
name: git-workflow
description: 'Designs git workflows covering branching strategies, trunk-based development, stacked changes, conventional commits, CI/CD pipelines, and repository hygiene. Use when setting up branching models, writing commit messages, configuring GitHub Actions, managing stacked PRs, cleaning stale branches, creating issue templates, or recovering lost commits.'
license: MIT
metadata:
  author: oakoss
  version: '1.1'
user-invocable: false
---

# Git Workflow

Covers branching strategies, conventional commits, CI/CD automation, repository hygiene, and git internals. GitHub CLI usage is handled by a separate `github-cli` skill; this skill focuses on git workflow patterns and CI/CD configuration.

## Quick Reference

| Area        | Key Practice                                              |
| ----------- | --------------------------------------------------------- |
| Branching   | Trunk-based development with short-lived feature branches |
| Commits     | Conventional commits with imperative mood                 |
| History     | Linear history via rebase; squash noisy commits           |
| PRs         | Small, stacked changes; no mega PRs                       |
| Main branch | Always deployable; broken main is an emergency            |
| CI/CD       | Modular GitHub Actions with reusable workflows            |
| Merging     | Green CI + review required before merge                   |
| Versioning  | Semantic Release or Changesets (never manual)             |
| Branches    | Max 48 hours lifespan; auto-prune stale/merged            |
| Secrets     | OIDC Connect in pipelines; never hardcode tokens          |
| Signing     | Sign commits with SSH or GPG keys for verified authorship |

## Branch Naming

| Type     | Use For            | Example                |
| -------- | ------------------ | ---------------------- |
| feat     | New features       | `feat/add-user-auth`   |
| fix      | Bug fixes          | `fix/login-redirect`   |
| chore    | Maintenance        | `chore/update-deps`    |
| docs     | Documentation      | `docs/api-reference`   |
| refactor | Code restructuring | `refactor/auth-module` |

## Conventional Commit Types

| Type       | Purpose                               | Version Bump |
| ---------- | ------------------------------------- | ------------ |
| `feat`     | New features                          | Minor        |
| `fix`      | Bug fixes                             | Patch        |
| `docs`     | Documentation only                    | None         |
| `style`    | Formatting, no logic changes          | None         |
| `refactor` | Neither fix nor feature               | None         |
| `perf`     | Performance improvements              | Patch        |
| `test`     | Adding or correcting tests            | None         |
| `build`    | Build system or external dependencies | None         |
| `ci`       | CI configuration changes              | None         |
| `chore`    | Tooling, maintenance, non-src changes | None         |
| `revert`   | Revert a previous commit              | Varies       |

Append `!` after type/scope for breaking changes (major version bump).

## Pre-Merge Checks

All PRs require before merge:

- Lint
- Type check
- Tests
- Security scan
- Review approval (human or automated)

Auto-merge is acceptable for low-risk PRs when pipeline succeeds.

## Troubleshooting

| Issue                                  | Resolution                                                                         |
| -------------------------------------- | ---------------------------------------------------------------------------------- |
| Merge conflicts on long-running branch | Rebase onto main frequently; break remaining work into new branch if over 48 hours |
| Broken main branch                     | Treat as emergency; revert offending commit, then fix forward on a branch          |
| Lost commits or data recovery          | Use git reflog and object inspection (`git cat-file`, `git fsck`)                  |
| CI pipeline failures                   | Check reusable workflow versions; verify OIDC permissions                          |
| Stacked PR conflicts after rebase      | Restack entire chain from base; Graphite handles automatically with `gt restack`   |
| Large file accidentally committed      | Use `git filter-repo` to remove from history (not `git filter-branch`)             |

## Common Mistakes

| Mistake                                               | Correct Pattern                                               |
| ----------------------------------------------------- | ------------------------------------------------------------- |
| Keeping feature branches alive longer than 48 hours   | Merge or rebase daily; break large work into stacked PRs      |
| Committing directly to main without branch protection | Enable branch protection rules requiring CI and review        |
| Using merge commits that clutter history              | Rebase and squash to maintain linear history                  |
| Hardcoding tokens in GitHub Actions workflows         | Use OIDC Connect for authentication in CI/CD pipelines        |
| Creating monolithic CI workflows in a single file     | Split into reusable workflows and composite actions           |
| `Fix bug` as commit message                           | `fix(scope): correct bug description` (conventional)          |
| `feat: Added feature` (past tense)                    | `feat: add feature` (imperative mood, lowercase)              |
| Using `git filter-branch` for history rewriting       | Use `git filter-repo` (faster, safer, officially recommended) |
| Pushing to main directly                              | Create feature branch first                                   |
| Unsigned commits in shared repositories               | Configure commit signing with SSH or GPG keys                 |

## Delegation

- **Audit repository branch hygiene and stale branches**: Use `Explore` agent to list and classify branch age and merge status
- **Set up CI/CD pipelines with reusable workflows**: Use `Task` agent to create modular GitHub Actions configurations
- **Design branching strategy for a new project**: Use `Plan` agent to evaluate trunk-based vs Git Flow based on team needs

## References

- [branching-strategies.md](references/branching-strategies.md) -- Git Flow, GitHub Flow, GitLab Flow, One-Flow comparison and selection criteria
- [trunk-based-development.md](references/trunk-based-development.md) -- Core principles, workflow steps, feature flags, and anti-patterns
- [stacked-changes.md](references/stacked-changes.md) -- Stacked PRs concept, manual stacking, Graphite automation, best practices
- [conventional-commits.md](references/conventional-commits.md) -- Commit format, types, scopes, breaking changes, and full workflow
- [github-actions.md](references/github-actions.md) -- Reusable workflows, matrix testing, deployment environments, security
- [git-internals.md](references/git-internals.md) -- Object model, SHA hashing, index, references, packfiles, garbage collection
- [automation-scripts.md](references/automation-scripts.md) -- Branch pruning, semantic release, security scanning, stacked PR helpers
- [issue-templates.md](references/issue-templates.md) -- Bug report, feature request, task, and minimal issue templates
- [advanced-operations.md](references/advanced-operations.md) -- Commit signing, interactive rebase, worktrees, bisect, reflog recovery, and --force-with-lease

© oakoss · MIT · oakoss/agent-skills

Похожие скиллы

Все скиллы по теме «Git и GitHub» →

Сначала — git-workflow от других авторов.

git-workflow affaan-m Скилл git-workflow с готовыми правилами Git: какую стратегию ветвления выбрать, как писать коммиты и когда rebase лучше merge. CX Codex +1 6 800установок git-workflow agno-team Скилл git-workflow для Claude Code, который помогает следовать best practices в git: форматирует коммиты, предлагает названия веток и структуру PR. Подсказывает формат и чек-листы, не блокируя коммиты. CX Codex +1 675установок git-workflow ruvnet Скилл git-workflow для Claude Code помогает управлять ветками, разрешать конфликты и вести жизненный цикл PR. Он включается для сложных Git-операций и координации pull request. CX Codex +1 743установок git-workflow Galaxy-Dawn Скилл git-workflow задаёт правила работы с Git: формат Conventional Commits, ветвление, слияние через no-ff и разбор конфликтов. Пригодится команде при настройке единого процесса разработки. CX Codex +1 382установок git-workflow jezweb Скилл git-workflow ведёт агента по операциям Git: подготовке PR, чистке веток, разрешению конфликтов и выпуску тегов в монорепозитории. CX Codex +1 1 300установок git-hygiene-enforcer patricio0312rev Скилл git-hygiene-enforcer для Claude Code задаёт правила коммитов и веток, готовит шаблон PR и описывает процесс ревью. Он приводит Git-процесс проекта к общим правилам. CX Codex +1 271установок ci-guard alirezarezvani Команда ci-guard запускает workflow ci-commit-branch-guard.yml по запросу: проверяет имя ветки и синтаксис Conventional Commits, не дожидаясь обычного триггера. CX Codex +1 ★ 907звёзд репо setup-automated-releases davila7 Команда setup-automated-releases настраивает автоматические релизы: версии, conventional commits, GitHub Actions, changelog и проверки pull request. Подходит для первичной настройки репозитория. CX Codex +1 347установок conventional-git samber Скилл conventional-git задаёт правила именования веток и коммитов по стандарту Conventional Commits v1.0.0. Помогает поддерживать чистую историю проекта в GitHub и GitLab. CX Codex +1 5 400установок git-pushing sickn33 Скилл git-pushing отправляет коммиты по стандарту Conventional Commits в удалённую ветку через изолированный индекс Git. Защищает от случайного захвата лишних файлов при рядовых пушах. CX Codex +1 932установок release-please bmad-labs По настройке релизного конвейера через Conventional Commits. Генерирует конфиги release-please, манифесты версий и воркфлоу GitHub Actions для публикации пакетов. CX Codex +1 128установок

Из того же набора106

Весь набор →
arktype-validation Скилл arktype-validation для Claude Code описывает схемы ArkType строками в синтаксисе TypeScript, включая морфы и рантайм-валидацию данных и переменных окружения через ArkEnv. CX Codex +1 153установок tanstack-router Скилл tanstack-router настраивает типобезопасную файловую маршрутизацию в React через @tanstack/react-router. Помогает с лоадерами данных, валидацией параметров поиска и разделением кода. CX Codex +1 150установок api-testing Скилл api-testing для Claude Code помогает писать интеграционные тесты REST API и проверять ответы эндпоинтов. Включается при настройке HTTP-моков или тестировании ошибок. CX Codex +1 149установок github-actions Помогает создавать и настраивать GitHub Actions workflows: от триггеров и матриц сборки до кеширования и аутентификации. Автоматизирует тесты, релизы и развёртывание. CX Codex +1 149установок ux-designer Скилл ux-designer для ИИ-агентов: проводит проект от информационной архитектуры до передачи в разработку, с проверкой доступности и юзабилити. CX Codex +1 148установок responsive-images Скилл responsive-images внедряет адаптивные изображения с srcset, современными форматами AVIF и WebP, защищая от сдвигов верстки CLS и ускоряя LCP. CX Codex +1 148установок tanstack-virtual Скилл учит агента виртуализировать длинные списки, таблицы и сетки на TanStack Virtual: в DOM остаются только видимые строки. CX Codex +1 148установок de-slopify Скилл de-slopify для Claude Code находит шаблонные обороты, лишние тире и следы ИИ в комментариях при правке текста и кода после языковой модели. CX Codex +1 146установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой