speckit.git.commit — команда для Claude Code: что делает
Команда speckit.git.commit для Claude Code добавляет изменения в индекс Git и создаёт коммит после команд Spec Kit по настройкам конфигурации проекта.
MIT ★ 110 обновлён 2026-10-19
.claude/commands/speckit.git.commit.mdЧто делает 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/
Вручную: положить файлы
~/.codex/prompts/speckit.git.commit.mdВызов — /prompts:speckit.git.commit. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/speckit.git.commit.prompt.mdВручную: положить файлы
.gemini/commands/speckit.git.commit.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о 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