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

speckit.git.commit — команда для Claude Code: что делает

Команда speckit.git.commit для Claude Code добавляет изменения в индекс Git и создаёт коммит после команд Spec Kit по настройкам конфигурации проекта.

MIT ★ 110 обновлён 2026-10-19

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/commands/speckit.git.commit.md
Открыть на GitHub

Что делает speckit.git.commit

Команда запускается как хук жизненного цикла Spec Kit (например, after_specify, before_plan или after_implement). Сначала она проверяет конфигурационный файл .specify/extensions/git/git-config.yml, выясняя, включён ли автоматический коммит для конкретного события или глобально через auto_commit.default. Если в рабочем каталоге есть изменённые файлы, вызывается исполняемый скрипт для Bash или PowerShell.

Формат сообщения зависит от настройки commit_style. При значении fixed используется заранее заданная строка из конфигурации. Если выбран режим conventional, агент просматривает git diff и формирует сообщение формата Conventional Commits. Из соображений безопасности сгенерированный текст записывается во временный файл и передаётся скрипту флагом пути, чтобы исключить выполнение произвольных подстановок в оболочке.

Если Git не установлен, текущая папка не является репозиторием или в ней нет изменений, команда завершает работу без ошибки. Однако при настройке commit_style: conventional отсутствие файла с сообщением приводит к сбою.

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

  • индексировать и коммитить файлы сразу после завершения шага спецификации
  • формировать сообщения коммитов по стандарту Conventional Commits на основе диффа
  • гибко включать или отключать автокоммиты для отдельных хуков Spec Kit
  • безопасно передавать текст коммита через временный файл без риска подстановки команд

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

  • Выполни хук after_specify и закоммить созданные артефакты
  • Проверь дифф после after_plan и зафиксируй изменения в стиле Conventional Commits
  • Запусти команду speckit.git.commit для стадии after_implement

Как установить speckit.git.commit

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

.claude/commands/speckit.git.commit.md

Вызов — /speckit.git.commit. Для всех проектов — ~/.claude/commands/

Вопросы о speckit.git.commit

Как установить speckit.git.commit в Claude Code?

Создайте файл команды по пути .claude/commands/speckit.git.commit.md.

Что делает speckit.git.commit?

Команда проверяет настройки в .specify/extensions/git/git-config.yml и фиксирует изменения в репозитории через git add . и git commit после шагов Spec Kit.

Чем режим conventional отличается от fixed?

В режиме fixed берётся готовая строка из конфига, а в conventional агент анализирует рабочий дифф и записывает сообщение в отдельный временный файл для передачи скрипту.

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

speckit.git.commit.md · MIT
---
description: "Auto-commit changes after a Spec Kit command completes"
---

# Auto-Commit Changes

Automatically stage and commit all changes after a Spec Kit command completes.

## Behavior

This command is invoked as a hook after (or before) core commands. It:

1. Determines the event name from the hook context (e.g., if invoked as an `after_specify` hook, the event is `after_specify`; if `before_plan`, the event is `before_plan`)
2. Checks `.specify/extensions/git/git-config.yml` for the `auto_commit` section
3. Looks up the specific event key to see if auto-commit is enabled
4. Falls back to `auto_commit.default` if no event-specific key exists
5. Determines the commit message based on `commit_style` (see below)
6. If enabled and there are uncommitted changes, runs `git add .` + `git commit`

## Commit Message Styles

Controlled by the `commit_style` key in `.specify/extensions/git/git-config.yml`:

- **`fixed`** (default): use the per-command `message` if configured, otherwise a generic `[Spec Kit] Auto-commit <phase> <command>` message.
- **`conventional`**: inspect the actual changes (`git diff` / `git status`) since the last commit and generate a single-line [Conventional Commit](https://www.conventionalcommits.org/) message (`type(scope): subject`, e.g. `feat: add OAuth specification` or `docs: update implementation plan`) that accurately summarizes the change. Write this message to a temporary file and pass the file's path to the script (see Execution below). The configured `message` values are ignored in this mode.

## Execution

Determine the event name from the hook that triggered this command, then run the script:

- **Bash**: `.specify/extensions/git/scripts/bash/auto-commit.sh <event_name> [--message-file <path>]`
- **PowerShell**: `.specify/extensions/git/scripts/powershell/auto-commit.ps1 <event_name> [-MessageFile <path>]`

Replace `<event_name>` with the actual hook event (e.g., `after_specify`, `before_plan`, `after_implement`). Only pass a generated message when `commit_style: conventional` is configured — first check `.specify/extensions/git/git-config.yml` for the value of `commit_style`:

- If `conventional`: inspect the diff and generate a Conventional Commit message. **Do not interpolate the generated message directly into a shell command string** — its content is derived from repository changes and may contain characters (quotes, `$(...)`, backticks) that a shell would execute or that would break command quoting. Instead, write the message to a temporary file using your file-editing tool (not a shell `echo`/`printf`), then pass that file's path via `--message-file <path>` (Bash) or `-MessageFile <path>` (PowerShell).
- If `fixed` or absent: run the script with just `<event_name>`; it uses the configured/static message.

## Configuration

In `.specify/extensions/git/git-config.yml`:

```yaml
# "fixed" (default) uses the messages below; "conventional" asks the agent
# to generate a Conventional Commit message from the diff instead.
commit_style: fixed

auto_commit:
  default: false          # Global toggle — set true to enable for all commands
  after_specify:
    enabled: true          # Override per-command
    message: "[Spec Kit] Add specification"
  after_plan:
    enabled: false
    message: "[Spec Kit] Add implementation plan"
```

## Graceful Degradation

- If Git is not available or the current directory is not a repository: skips with a warning
- If no config file exists: skips (disabled by default)
- If no changes to commit: skips with a message
- If `commit_style: conventional` is set and no generated message was supplied: fails with a clear error instead of silently falling back to the fixed message format

© alfredoperez · MIT · alfredoperez/speckit-companion

Похожие слэш-команды

Все слэш-команды по теме «Git и GitHub» →
git-commit ilteoood Скилл git-commit для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode анализирует diff и генерирует сообщение коммита по спецификации Conventional Commits. CX Codex +1 624установок git-commit-workflow laurigates Скилл git-commit-workflow для Claude Code задаёт формат сообщений и правила staging. Помогает разделять изменения по смыслу и не смешивать файлы в одном коммите. CX Codex +1 161установок git-pushing sickn33 Скилл git-pushing отправляет коммиты по стандарту Conventional Commits в удалённую ветку через изолированный индекс Git. Защищает от случайного захвата лишних файлов при рядовых пушах. CX Codex +1 932установок git-commit-helper alirezarezvani Скилл git-commit-helper анализирует staged diff и предлагает сообщение коммита в формате Conventional Commits. Пригодится перед созданием коммита или когда сложно сформулировать его описание. CX Codex +1 ★ 788звёзд репо create_git_diff_commit danielmiessler Промпт create_git_diff_commit генерирует команды git add и сообщения коммитов по diff репозитория в формате Conventional Commits. GP ChatGPT ★ 44 690звёзд репо git-conventional-commit-messages PatrickJS Правило git-conventional-commit-messages для Cursor задаёт формат Conventional Commits для сообщений Git. Оформляет коммиты по схеме: тип, необязательная область в скобках и описание после двоеточия. CX Codex +1 ★ 41 178звёзд репо

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

Весь набор →
release-qa Команда release-qa для Claude Code проверяет код перед выпуском: сравнивает его с последним тегом версии, запускает тесты и ручные проверки, пишет отчёт с вердиктом ship или fix-first. Блокирует /publish до прохождения проверок. CX Codex +1 ★ 110звёзд репо install-local Команда install-local собирает и ставит локальные версии расширений VS Code и spec-kit из репозитория speckit-companion, автоматически повышая patch-версию для сброса кэша. CX Codex +1 ★ 110звёзд репо speckit.companion.living-drift Команда speckit.companion.living-drift показывает, какие файлы возможностей living spec изменились с момента последнего коммита их спецификаций. Помогает найти изменения, которые не попали обратно в спецификацию. CX Codex +1 ★ 110звёзд репо speckit.companion.resume Команда speckit.companion.resume для Claude Code восстанавливает состояние spec-driven разработки после перерыва. Она переносит записанные решения в контекст и запускает следующий шаг пайплайна. CX Codex +1 ★ 110звёзд репо speckit-git-commit Скилл speckit-git-commit автоматически добавляет и коммитит изменения после команд Spec Kit. Он пригодится, когда историю Git нужно обновлять через настройки проекта. CX Codex +1 ★ 110звёзд репо bench-capture Команда bench-capture для Claude Code и Codex, которая фиксирует результаты трёх ячеек бенчмарка после прохода по одному размеру, добавляет их в историю, перестраивает отчёт и очищает ячейки для следующего раунда. CX Codex +1 ★ 110звёзд репо speckit.companion.living-validate Команда speckit.companion.living-validate проверяет разметку living-спецификаций и дельт без правки файлов. Находит требования без сценариев, битые заголовки и синтаксические ошибки. CX Codex +1 ★ 110звёзд репо publish Команда publish проводит выпуск версии VS Code-расширения: проверяет релизные условия, помогает подготовить чейнджлог, обновить версию и отправить коммит с тегом. Для Codex файл команды устанавливают отдельно. CX Codex +1 ★ 110звёзд репо

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

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