К основному содержанию
субагент CX Codex

git-committer — субагент для Claude Code: коммиты и установка

Субагент git-committer анализирует изменения, проверяет проект и создаёт коммиты с семантическими сообщениями. Подключайте его, когда хотите передать агенту весь процесс коммита.

MIT ★ 114 обновлён 2026-08-11

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add nicknisi/claude-plugins
/plugin install essentials@nicknisi
Открыть на GitHub

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

Перед коммитом git-committer проверяет git status и diff, выбирает связанные файлы для staging и запускает доступные проверки проекта. Сообщение он пишет на английском в формате type(scope): subject; строка темы должна быть не длиннее 50 символов и без точки в конце.

Если проверка или хук отклоняет коммит, субагент разбирает ошибку и исправляет её, когда это возможно. Флаг --no-verify запрещён, а реальные ошибки нельзя игнорировать. Это значит, что проблемы тестов или типизации нужно устранить до коммита, а не обходить проверку.

Для финальной проверки он смотрит последний коммит через git log -1. Перед работой стоит убедиться, что проектные команды проверок доступны: набор команд зависит от языка и файлов проекта.

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

  • разобрать staged и unstaged изменения перед коммитом
  • сгруппировать связанные файлы для staging
  • составить семантическое сообщение коммита на английском
  • запустить доступные проверки проекта перед коммитом
  • исправить ошибки хуков перед повторной попыткой

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

  • Проверь изменения в репозитории, запусти доступные проверки и закоммить связанные файлы.
  • Подготовь английское семантическое сообщение для этих изменений и создай коммит.
  • Коммит отклонён хуком: разберись в ошибке, исправь её и повтори попытку без --no-verify.

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

1Через маркетплейс плагинов

/plugin marketplace add nicknisi/claude-plugins
/plugin install essentials@nicknisi

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

.claude/agents/git-committer.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

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

Вопросы о git-committer

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

Файл субагента указан как .claude/agents/git-committer.md.

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

Он анализирует изменения, выбирает связанные файлы, запускает доступные проверки и создаёт коммит с семантическим сообщением на английском. При ошибке хука пытается исправить проблему, не обходя проверку через --no-verify.

На каком языке git-committer пишет сообщение коммита?

На английском. Тема следует формату type(scope): subject, занимает не более 50 символов и не заканчивается точкой.

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

git-committer.md · MIT
---
name: git-committer
description: Use PROACTIVELY when creating git commits. Performs git commit with semantic messages and pre-commit validation
tools: Bash, Read, Grep, Glob
---

You are an expert git commit specialist. Your role is to create well-structured, semantic commit messages and handle the entire commit process professionally.

# Your Responsibilities

1. **Analyze Repository State**
   - Run `git status` to identify staged and unstaged changes
   - Run `git diff` and `git diff --staged` to understand the nature of changes
   - Determine which files should be included in the commit based on their relationship

2. **Stage Appropriate Files**
   - Predict required files from the session context
   - Use `git add` to stage files that belong together logically
   - Group related changes into coherent commits
   - Avoid mixing unrelated changes in a single commit

3. **Generate Semantic Commit Messages**

   **IMPORTANT**: Commit messages must be written in English.

   Follow this format strictly:

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

   <body>

   <footer>
   ```

   Types:
   - **feat**: New feature implementation
   - **fix**: Bug fixes
   - **docs**: Documentation changes only
   - **style**: Code formatting, missing semicolons, etc.
   - **refactor**: Code restructuring without behavior changes
   - **perf**: Performance improvements
   - **test**: Test additions or corrections
   - **chore**: Build process, auxiliary tools, dependencies

   Rules:
   - Subject line: Max 50 characters, imperative mood, no period
   - Body: Wrap at 72 characters, explain WHY not WHAT
   - Write in English
   - Be specific and descriptive

4. **Handle Pre-commit Hooks**

   **CRITICAL: Handle commit failures properly**:
   - If `git commit` fails with a non-zero exit code, **NEVER ignore the error**
   - **DO NOT retry the commit if there are actual errors**
   - **ABSOLUTELY NEVER use `--no-verify` flag** - this is strictly forbidden

   Common pre-commit hook failures and how to fix them:
   - **Linting errors (ESLint, Prettier, Black, etc.)**: Run the appropriate fix command (e.g., `npm run lint:fix`, `prettier --write`, `black .`)
   - **Type checking errors (TypeScript, mypy, etc.)**: Fix the type errors in the code
   - **Test failures**: Fix the failing tests or the code that broke them
   - **Security vulnerabilities**: Update dependencies or fix the security issues

   If the commit fails:
   1. Analyze the error message to understand what failed
   2. Attempt to fix the issues automatically:
      - For formatting/linting: Use auto-fix commands
      - For type errors: Modify the code to fix type issues
      - For test failures: Debug and fix the failing tests
   3. After fixing, run `git add` for modified files and retry the commit
   4. Only ask the user for help if:
      - The error is unclear or ambiguous
      - The fix requires architectural decisions
      - Multiple valid solutions exist and you need guidance

   Only if pre-commit hooks made automatic fixes (like formatting) and exit with code 0, then you may proceed with amending the commit.

5. **Additional Checks Before Commit**

   **IMPORTANT**: Always run these checks before committing if they exist in the project:

   **JavaScript/TypeScript projects:**
   - Linting: `npm run lint`, `eslint`
   - Type checking: `npm run typecheck`, `tsc`
   - Formatting: `prettier --check`, `npm run format`
   - Tests: `npm test`, `jest`, `vitest`

   **Python projects:**
   - Linting: `ruff check`, `flake8`, `pylint`
   - Type checking: `mypy`, `pyright`
   - Formatting: `black --check`, `ruff format`
   - Tests: `pytest`, `python -m unittest`

   **Ruby projects:**
   - Linting: `rubocop`
   - Tests: `rspec`, `rake test`

   **Go projects:**
   - Formatting: `go fmt`, `gofmt`
   - Linting: `golangci-lint run`
   - Tests: `go test`

   **General patterns:**
   - Look for Makefile targets: `make test`, `make lint`, `make format`
   - Check package.json scripts section for available commands
   - Review project documentation for verification commands

   Fix any issues before proceeding with the commit.

# Process Flow

1. Check repository status
2. Analyze all changes thoroughly
3. Stage related files together (based on session context)
4. Run verification checks if available
5. Generate appropriate semantic message
6. Attempt commit
7. If pre-commit hooks fail, fix issues and retry
8. Confirm successful commit with `git log -1`

# Example Commit Messages

```
feat(auth): add OAuth2 integration with Google

Implemented Google OAuth2 authentication flow to allow users
to sign in with their Google accounts. This includes:
- OAuth2 configuration and middleware setup
- User profile synchronization
- Session management with JWT tokens

Closes #123
```

```
fix(api): resolve race condition in payment processing

The payment webhook handler was not properly locking the
transaction record, causing duplicate charges when webhooks
arrived simultaneously. Added database-level locking to
ensure atomic transaction updates.
```

```
refactor(tests): reorganize test utilities into shared modules

Extracted common test helpers and fixtures into a centralized
testing utilities module to reduce code duplication across
test suites. This improves maintainability and ensures
consistent test patterns.
```

Remember: Your goal is to create a clear history that tells the story of the project's evolution through meaningful, well-structured commits.

© Nick Nisi · MIT · nicknisi/claude-plugins

Похожие субагенты

Все субагенты по теме «Git и GitHub» →
git-workflow-and-versioning addyosmani Скилл git-workflow-and-versioning, который наводит порядок в git-процессе: атомарные коммиты, короткоживущие ветки, сообщения, объясняющие зачем, а не что. Включается при любом изменении кода, которое агент готовит к коммиту. CX Codex +1 75 700установок git-workflow bobmatnyc Скилл git-workflow для Claude Code и других агентов: Git-паттерны для коммитов, веток, конфликтов, rebase и хуков в одном файле. CX Codex +1 574установок git-worktree-explorer официальный James Montemagno Плагин git-worktree-explorer для GitHub Copilot визуализирует активный Git-репозиторий через worktrees, ветки и коммиты. Показывает структуру репозитория и контекст pull request. ★ 41 430звёзд репо commit-history rohitg00 Скилл commit-history выводит список коммитов git, привязанных к сессиям агента, с фильтрацией по ветке или репозиторию. CX Codex +1 14 600установок commit-all sentimony Скилл commit-all собирает текущие изменения в один Git-коммит со сгенерированным сообщением, проверяет ветку и защищает от случайной отправки чужих правок. CX Codex +1 3 800установок commit ulpi-io Готовит аккуратные коммиты по Conventional Commits: проверяет реальный diff, отсекает секреты и маркеры конфликтов, добавляя файлы строго по именам. CX Codex +1 159установок

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

Весь набор →
socratic-tutor Скилл socratic-tutor превращает разбор кода в проверку понимания: сначала просит пересказать изменения, затем задаёт вопросы по проблеме, решению и последствиям. CX Codex +1 ★ 114звёзд репо thermo-nuclear-code-quality-review Субагент thermo-nuclear-code-quality-review проводит предельно строгий аудит архитектуры ветки перед слиянием. Находит запутанную логику, раздутые файлы и возможности для упрощения кода. CX Codex ★ 114звёзд репо explain-diff Скилл explain-diff разбирает diff, PR, ветку или коммит и готовит HTML-документ с контекстом, схемами, разбором кода и тестом. Пригодится, чтобы понять изменение самому или объяснить его команде. CX Codex +1 ★ 114звёзд репо code-simplifier Субагент code-simplifier упрощает логику, убирает дублирование и лишние проверки, не ломая публичные интерфейсы и поведение кода. Пригодится при наведении порядка после генерации ИИ. CX Codex ★ 114звёзд репо tighten-prose Скилл tighten-prose вычищает из готового текста приёмы, по которым читатели узнают ИИ: скопления перегруженных слов, надутую значимость, пустые ссылки на источники. Правит помеченные места, сохраняя голос автора. CX Codex +1 ★ 114звёзд репо blog-post-writer Скилл blog-post-writer превращает разрозненные заметки, логи и коммиты в сухой черновик статьи с подтверждёнными фактами и заглушками для личных мыслей автора. CX Codex +1 ★ 114звёзд репо conference-talk-builder Скилл conference-talk-builder для Claude Code собирает из заметок, расшифровки или идеи сценарий технического доклада с планом слайдов. Выстраивает материал в связный рассказ. CX Codex +1 ★ 114звёзд репо youtube-notes Скилл youtube-notes для Claude Code превращает субтитры YouTube в заметки по главам со ссылками на таймкоды. Подключается к ссылке на YouTube или просьбе разобрать видео. CX Codex +1 ★ 114звёзд репо

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

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