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

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

Скилл git-workflows с готовыми рецептами git: модели ветвления, команды на каждый день, откаты и хуки в одном файле, который агент читает сам.

MIT 114 установок ★ 26 обновлён 2026-01-20

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

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

Скилл собирает в одном SKILL.md то, что обычно ищут по старым заметкам: схемы ветвления, ежедневные команды и хуки. Внутри три стратегии: Git Flow с git flow feature start, GitHub Flow через gh pr create и trunk-based с короткими ветками. Плюс разбор Conventional Commits с таблицей типов от feat до chore.

Дальше операции: интерактивное стейджирование git add -p, squash- и no-ff-мержи, git rebase -i HEAD~3 с расшифровкой pick/squash/fixup, stash. Отдельный раздел про откаты: git restore, git reset --soft, git revert -m 1 для мерж-коммита.

Хуки даны двумя способами: сырой .git/hooks/pre-commit и связка Husky с lint-staged. Пример хука гоняет npm run lint и npm run type-check, так что эти скрипты должны лежать в package.json. Нет их — коммит не пройдёт.

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

  • Выбрать модель ветвления, не перечитывая три статьи
  • Почистить историю коммитов squash-ем перед ревью
  • Откатить мерж-коммит, не снося ветку целиком
  • Настроить pre-commit с линтом и проверкой типов
  • Объяснить коллеге разницу между git reset --soft и --hard

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

  • Помоги перевести репозиторий с Git Flow на trunk-based: распиши шаги для ветки develop.
  • Собери pre-commit хук с npm run lint и npm run type-check.
  • Нужно почистить три последних коммита перед PR — покажи интерактивный rebase.

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

1Через Skills CLI (Vercel)

npx skills add miles990/claude-software-skills --skill git-workflows -a claude-code

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

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

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

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

Вопросы о git-workflows

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

Выполните npx skills add miles990/claude-software-skills --skill git-workflows -a claude-code, файл скилла окажется в ~/.claude/skills/git-workflows/SKILL.md.

Что делает git-workflows?

Даёт агенту справочник по git: три модели ветвления, повседневные команды, способы откатить изменения и настройку хуков через Husky или вручную.

Почему готовый pre-commit хук падает в моём проекте?

Он вызывает npm run lint и npm run type-check. Если таких скриптов нет в package.json, проверка завершится ошибкой и коммит не создастся.

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

SKILL.md · MIT
---
name: git-workflows
description: Git version control, branching strategies, and collaboration patterns
domain: tools-integrations
version: 1.0.0
tags: [git, github, gitlab, branching, merge, rebase, hooks]
triggers:
  keywords:
    primary: [git, github, gitlab, branch, merge, rebase, commit, pr, pull request]
    secondary: [gitflow, trunk based, cherry pick, stash, hook, conflict]
  context_boost: [version control, collaboration, code review]
  context_penalty: [database, frontend, ui]
  priority: high
---

# Git Workflows

## Overview

Git version control patterns, branching strategies, and team collaboration best practices.

---

## Branching Strategies

### Git Flow

```
main ─────●────────────●─────────────●───────────
           \          /               \
            \   release/1.0          release/1.1
             \    /    \              /
develop ──────●───●──────●────●──────●────────────
               \        /      \    /
            feature/   feature/ feature/
            login      payment  search
```

```bash
# Initialize git flow
git flow init

# Start a new feature
git flow feature start user-authentication
# Work on feature...
git flow feature finish user-authentication

# Start a release
git flow release start 1.0.0
# Bug fixes only...
git flow release finish 1.0.0

# Hotfix for production
git flow hotfix start critical-bug
git flow hotfix finish critical-bug
```

### GitHub Flow (Simplified)

```
main ─────●──────●──────●──────●──────●───────
           \    /        \    /        \
         feature/       feature/      feature/
         add-auth       fix-bug       new-ui
```

```bash
# 1. Create branch from main
git checkout main
git pull origin main
git checkout -b feature/add-authentication

# 2. Make changes and commit
git add .
git commit -m "feat: add user authentication"

# 3. Push and create PR
git push -u origin feature/add-authentication
gh pr create --title "Add user authentication" --body "..."

# 4. After review, merge via GitHub
gh pr merge --squash

# 5. Delete branch
git checkout main
git pull origin main
git branch -d feature/add-authentication
```

### Trunk-Based Development

```
main ────●──●──●──●──●──●──●──●──●────
         │     │        │
         └─────┴────────┴─── short-lived branches (< 1 day)
```

```bash
# Small, frequent commits directly to main or via short-lived branches
git checkout main
git pull
git checkout -b fix/typo-in-readme
# Make small change...
git commit -m "fix: typo in README"
git push -u origin fix/typo-in-readme
# PR, review, merge same day
```

---

## Common Operations

### Commits

```bash
# Stage specific changes
git add -p  # Interactive staging

# Commit with message
git commit -m "feat(auth): add JWT token validation"

# Amend last commit (not pushed)
git commit --amend -m "feat(auth): add JWT token validation and refresh"

# Commit with co-author
git commit -m "feat: implement feature

Co-authored-by: Name <[email protected]>"

# Empty commit (trigger CI)
git commit --allow-empty -m "chore: trigger CI build"
```

### Conventional Commits

```
<type>(<scope>): <description>

[optional body]

[optional footer(s)]
```

| Type | Description |
|------|-------------|
| feat | New feature |
| fix | Bug fix |
| docs | Documentation only |
| style | Formatting, no code change |
| refactor | Code change, no new feature or fix |
| perf | Performance improvement |
| test | Adding tests |
| chore | Build, CI, tooling |

```bash
# Examples
git commit -m "feat(api): add user registration endpoint"
git commit -m "fix(auth): handle expired token refresh"
git commit -m "docs: update API documentation"
git commit -m "refactor(db): extract connection pool logic"
git commit -m "test(user): add unit tests for validation"
```

### Branching

```bash
# Create and switch to branch
git checkout -b feature/new-feature
# or
git switch -c feature/new-feature

# List branches
git branch -a  # All branches
git branch -vv # With tracking info

# Delete branch
git branch -d feature/merged-branch    # Safe delete
git branch -D feature/unmerged-branch  # Force delete

# Rename branch
git branch -m old-name new-name

# Set upstream
git branch --set-upstream-to=origin/main main
```

### Merging

```bash
# Merge branch into current
git merge feature/branch

# Merge with no fast-forward (always create merge commit)
git merge --no-ff feature/branch

# Squash merge (combine all commits)
git merge --squash feature/branch
git commit -m "feat: add feature (squashed)"

# Abort merge
git merge --abort
```

### Rebasing

```bash
# Rebase current branch onto main
git fetch origin
git rebase origin/main

# Interactive rebase (last 3 commits)
git rebase -i HEAD~3

# In editor, change 'pick' to:
# - squash (s): combine with previous
# - fixup (f): combine, discard message
# - reword (r): change commit message
# - edit (e): stop for amending
# - drop (d): remove commit

# Continue rebase after resolving conflicts
git add .
git rebase --continue

# Abort rebase
git rebase --abort
```

### Stashing

```bash
# Stash changes
git stash
git stash push -m "work in progress"

# Stash including untracked files
git stash -u

# List stashes
git stash list

# Apply stash
git stash pop           # Apply and remove
git stash apply         # Apply and keep
git stash apply stash@{2}  # Apply specific

# Show stash contents
git stash show -p stash@{0}

# Drop stash
git stash drop stash@{0}
git stash clear  # Drop all
```

---

## Undoing Changes

```bash
# Discard changes in working directory
git checkout -- file.txt
git restore file.txt  # Git 2.23+

# Unstage file
git reset HEAD file.txt
git restore --staged file.txt  # Git 2.23+

# Reset to previous commit (keep changes staged)
git reset --soft HEAD~1

# Reset to previous commit (keep changes unstaged)
git reset HEAD~1
git reset --mixed HEAD~1

# Reset to previous commit (discard changes)
git reset --hard HEAD~1

# Revert a commit (create new commit that undoes)
git revert <commit-hash>

# Revert merge commit
git revert -m 1 <merge-commit-hash>
```

---

## Git Hooks

### Pre-commit Hook

```bash
#!/bin/sh
# .git/hooks/pre-commit

# Run linting
npm run lint
if [ $? -ne 0 ]; then
  echo "Linting failed. Please fix errors before committing."
  exit 1
fi

# Run type checking
npm run type-check
if [ $? -ne 0 ]; then
  echo "Type checking failed. Please fix errors before committing."
  exit 1
fi

# Check for console.log
if git diff --cached | grep -E '^\+.*console\.(log|debug|info)' > /dev/null; then
  echo "Warning: Found console.log statements. Remove before committing."
  exit 1
fi
```

### Husky + lint-staged

```json
// package.json
{
  "scripts": {
    "prepare": "husky install"
  },
  "lint-staged": {
    "*.{js,ts,tsx}": [
      "eslint --fix",
      "prettier --write"
    ],
    "*.{json,md,yml}": [
      "prettier --write"
    ]
  }
}
```

```bash
# .husky/pre-commit
#!/bin/sh
. "$(dirname "$0")/_/husky.sh"

npx lint-staged
```

```bash
# .husky/commit-msg
#!/bin/sh
. "$(dirname "$0")/_/husky.sh"

npx --no -- commitlint --edit "$1"
```

---

## Advanced Operations

### Cherry-pick

```bash
# Apply specific commit to current branch
git cherry-pick <commit-hash>

# Cherry-pick multiple commits
git cherry-pick <commit1> <commit2> <commit3>

# Cherry-pick without committing
git cherry-pick -n <commit-hash>

# Cherry-pick merge commit
git cherry-pick -m 1 <merge-commit-hash>
```

### Bisect (Find Bug Introduction)

```bash
# Start bisect
git bisect start

# Mark current as bad
git bisect bad

# Mark known good commit
git bisect good v1.0.0

# Git checks out middle commit, test and mark
git bisect good  # or
git bisect bad

# Repeat until found
# Git reports the first bad commit

# End bisect
git bisect reset

# Automated bisect
git bisect start HEAD v1.0.0
git bisect run npm test
```

### Worktrees

```bash
# Create worktree for parallel work
git worktree add ../project-hotfix hotfix/urgent-fix
git worktree add ../project-feature feature/new-feature

# List worktrees
git worktree list

# Remove worktree
git worktree remove ../project-hotfix
```

### Submodules

```bash
# Add submodule
git submodule add https://github.com/org/repo.git libs/repo

# Clone with submodules
git clone --recurse-submodules https://github.com/org/project.git

# Update submodules
git submodule update --init --recursive

# Pull submodule updates
git submodule update --remote
```

---

## Git Configuration

```bash
# User config
git config --global user.name "Your Name"
git config --global user.email "[email protected]"

# Default branch
git config --global init.defaultBranch main

# Editor
git config --global core.editor "code --wait"

# Aliases
git config --global alias.co checkout
git config --global alias.br branch
git config --global alias.ci commit
git config --global alias.st status
git config --global alias.lg "log --oneline --graph --all"
git config --global alias.unstage "reset HEAD --"
git config --global alias.last "log -1 HEAD"

# Pull behavior
git config --global pull.rebase true

# Auto-setup remote tracking
git config --global push.autoSetupRemote true

# Credential caching
git config --global credential.helper cache
git config --global credential.helper 'cache --timeout=3600'
```

---

## Related Skills

- [[devops-cicd]] - CI/CD with Git
- [[code-quality]] - Code review practices
- [[project-management]] - Agile workflows

© miles990 · MIT · miles990/claude-software-skills

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

Все скиллы по теме «Git и GitHub» →
conventional-git samber Скилл conventional-git задаёт правила именования веток и коммитов по стандарту Conventional Commits v1.0.0. Помогает поддерживать чистую историю проекта в GitHub и GitLab. CX Codex +1 5 400установок git-workflow-expert curiositech Скилл git-workflow-expert для git-операций: стратегии ветвления, разрешение конфликтов, rebase и продвинутые команды вроде bisect и reflog. Выручает, когда история запуталась или нужно вытащить потерянный коммит. CX Codex +1 143установок gh-switch sentimony Скилл gh-switch проверяет активный аккаунт в GitHub CLI или токен GitLab перед выполнением команд и переключает профиль под проект из файла .env/.env. CX Codex +1 2 200установок create-branch tartinerlabs Скилл create-branch создаёт ветки git с валидацией имени и автопривязкой к задачам GitHub или GitLab. Пригодится при старте работы над issue или фичей. CX Codex +1 413установок pr-review Jiachen (MiniMax Code team) Скилл pr-review для Claude Code проверяет PR или текущую ветку по правилам MCode Review. Запускается из CI или по просьбе разработчика до ручного ревью. CX Codex +1 ★ 741звёзд репо om-followup-issue-from-pr open-mercato Скилл om-followup-issue-from-pr для Claude Code превращает ссылку на PR или комментарий из ревью в задачу трекера. Фиксирует правки после ревью как issue. CX Codex +1 3 700установок

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

Весь набор →
e-commerce Скилл e-commerce для Claude Code и других агентов: состояние корзины, оплата через Stripe, оформление заказа и склад. Покрывает чекаут и подключение платежей. CX Codex +1 377установок saas-platforms Скилл saas-platforms для ИИ-кодинга, который подсказывает, как устроить мультитенантность, биллинг подписок и учёт потребления в SaaS-приложении. CX Codex +1 364установок architecture-patterns Скилл architecture-patterns подсказывает архитектурные шаблоны для бэкенда: от монолита и микросервисов до Clean Architecture и DDD. CX Codex +1 282установок developer-tools Скилл developer-tools учит ИИ-агента проектировать консольные утилиты на Node.js и собирать типизированные SDK с ограничением запросов. CX Codex +1 218установок frontend Скилл frontend для Claude Code содержит шаблоны и практики фронтенд-разработки на React, Vue и Next.js. Помогает создавать типобезопасные компоненты и настраивать клиентское состояние. CX Codex +1 194установок automation-scripts Скилл automation-scripts для Claude Code помогает собирать скрипты автоматизации и запускать задачи разработки. Включается при запросах про Makefile, npm-скрипты и планировщики задач. CX Codex +1 152установок shell-bash Скилл shell-bash для Claude Code подсказывает шаблоны Bash-скриптов: от разбора аргументов до работы с массивами. Шаблоны помогают автоматизировать задачи в терминале и писать системные скрипты. CX Codex +1 112установок desktop-apps Скилл desktop-apps для десктопных приложений на Electron и Tauri: схемы главного процесса, preload-моста, IPC и автообновления. CX Codex +1 101установок

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

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