speckit.git.validate — команда для Claude Code
Команда speckit.git.validate проверяет, соответствует ли текущая ветка Git соглашениям об именовании фич-веток. Подходит, если в проекте есть правило для префиксов веток и нужно автоматизировать валидацию.
MIT ★ 110 обновлён 2026-10-19
.claude/commands/speckit.git.validate.mdЧто делает speckit.git.validate
Команда получает имя текущей ветки и проверяет, начинается ли финальный сегмент пути с одного из двух маркеров: последовательный номер из трёх или более цифр (например, 001-feature-name или jdoe/web/042-fix-bug) или временная метка YYYYMMDD-HHMMSS (например, 20260319-143022-feature-name). Если ветка соответствует шаблону, команда выводит сообщение об успехе и проверяет, существует ли директория спеки с соответствующим префиксом под specs/.
Если ветка не совпадает ни с одним паттерном, команда выводит ошибку с рекомендациями по названию. При отсутствии Git или если директория не является репозиторием, команда проверяет переменную окружения SPECIFY_FEATURE как fallback. Для работы требуется Git в PATH.
Какие задачи решает
- проверить имя ветки против стандартов проекта
- убедиться, что для ветки создана директория спеков
- валидировать ветку, если Git недоступен, через переменную окружения
- вывести подробное сообщение об ошибке при несоответствии ветки правилам
Примеры запросов агенту
- Запусти
speckit.git.validateперед коммитом, чтобы проверить, что ветка названа правильно - Выполни команду в начале работы над фичей, чтобы убедиться, что директория
specs/существует - Используй команду в CI/CD для автоматической валидации веток в pull-request
Как установить speckit.git.validate
Вручную: положить файлы
.claude/commands/speckit.git.validate.mdВызов — /speckit.git.validate. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/speckit.git.validate.mdВызов — /prompts:speckit.git.validate. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/speckit.git.validate.prompt.mdВручную: положить файлы
.gemini/commands/speckit.git.validate.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о speckit.git.validate
Как установить speckit.git.validate в Claude Code?
Добавь файл команды в .claude/commands/speckit.git.validate.md в корне проекта. Команда станет доступна в Claude Code сразу после загрузки проекта.
Что делает speckit.git.validate?
Проверяет, соответствует ли имя текущей ветки одному из двух формата: последовательный номер (001-, 042-) или временная метка (20260319-143022-). Если ветка правильная, проверяет наличие директории спеков.
Какие форматы имён веток принимает команда?
Финальный сегмент пути должен начинаться с трёхзначного номера и дефиса (например, 001-feature-name) или с временной метки в формате YYYYMMDD-HHMMSS (например, 20260319-143022-feature-name). Допускаются namespace-префиксы типа jdoe/web/.
Исходный текст
speckit.git.validate.md · MIT
---
description: "Validate current branch follows feature branch naming conventions"
---
# Validate Feature Branch
Validate that the current Git branch follows the expected feature branch naming conventions.
## Prerequisites
- Check if Git is available by running `git rev-parse --is-inside-work-tree 2>/dev/null`
- If Git is not available, output a warning and skip validation:
```
[specify] Warning: Git repository not detected; skipped branch validation
```
## Validation Rules
Get the current branch name:
```bash
git rev-parse --abbrev-ref HEAD
```
The branch name's final path segment must start with one of these feature markers:
1. **Sequential**: `[0-9]{3,}-` (e.g., `001-feature-name`, `042-fix-bug`, `1000-big-feature`, `jdoe/web/008-guided-tour`)
2. **Timestamp**: `[0-9]{8}-[0-9]{6}-` (e.g., `20260319-143022-feature-name`, `jdoe/web/20260319-143022-feature-name`)
## Execution
If on a feature branch (matches either pattern):
- Output: `✓ On feature branch: <branch-name>`
- Check if the corresponding spec directory exists under `specs/`:
- For sequential branches, look for `specs/<prefix>-*` where prefix matches the numeric portion, regardless of branch namespace prefixes
- For timestamp branches, look for `specs/<prefix>-*` where prefix matches the `YYYYMMDD-HHMMSS` portion, regardless of branch namespace prefixes
- If spec directory exists: `✓ Spec directory found: <path>`
- If spec directory missing: `⚠ No spec directory found for prefix <prefix>`
If NOT on a feature branch:
- Output: `✗ Not on a feature branch. Current branch: <branch-name>`
- Output: `Feature branches should be named like: 001-feature-name, 20260319-143022-feature-name, or <namespace>/001-feature-name`
## Graceful Degradation
If Git is not installed or the directory is not a Git repository:
- Check the `SPECIFY_FEATURE` environment variable as a fallback
- If set, validate that value against the naming patterns
- If not set, skip validation with a warning
© alfredoperez · MIT · alfredoperez/speckit-companion