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

speckit.git.validate — команда для Claude Code

Команда speckit.git.validate проверяет, соответствует ли текущая ветка Git соглашениям об именовании фич-веток. Подходит, если в проекте есть правило для префиксов веток и нужно автоматизировать валидацию.

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

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

Что делает 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/

Вопросы о 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

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

Все слэш-команды по теме «Git и GitHub» →
git-workflow ruvnet Скилл git-workflow для Claude Code помогает управлять ветками, разрешать конфликты и вести жизненный цикл PR. Он включается для сложных Git-операций и координации pull request. CX Codex +1 743установок github-workflow transilienceai Скилл github-workflow для Claude Code автоматизирует GitHub-операции: ветки, коммиты, пуши, pull requests, issues и code review. Выполняет запросы агента на коммит, пуш, создание PR и управление веткой. CX Codex +1 195установок prepare-branch-context jnsahaj Скилл prepare-branch-context собирает диффы, историю коммитов и данные пулреквеста текущей ветки, чтобы агент понимал контекст до начала правок. CX Codex +1 107установок claude-docs-validate costiash Скилл claude-docs-validate для Claude Code проверяет локальную копию документации: свежесть манифеста, битые ссылки, статус кэша. CX Codex +1 ★ 58звёзд репо command-sync-branch softaworks Плагин command-sync-branch для Claude Code синхронизирует feature-ветку с main. Забирает свежие коммиты из основной ветки и применяет их к текущей. ★ 2 707звёзд репо new-branch-and-pr cursor Скилл new-branch-and-pr для Claude Code, Codex, Cursor и других агентов берёт задачу и проводит её по полному циклу: создаёт ветку от актуального main, делает коммит и открывает pull request. CX Codex +1 2 300установок

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

Весь набор →
cleanup-reviewer Субагент cleanup-reviewer для Claude Code проверяет указанный участок diff очистки репозитория и возвращает только замечания по конкретным файлам. CX Codex ★ 110звёзд репо speckit.git.initialize Команда speckit.git.initialize создаёт Git-репозиторий в проекте и делает первый коммит, если репо ещё не инициализировано. Пригодится в начале работы над новым проектом или при подготовке шаблона. CX Codex +1 ★ 110звёзд репо speckit-git-remote Скилл speckit-git-remote определяет адрес удалённого Git-репозитория и проверяет связь с GitHub для сценариев вроде создания задач в spec-kit. Пригодится проектам со структурой .specify/. CX Codex +1 ★ 110звёзд репо speckit-git-initialize Скилл speckit-git-initialize для Claude Code создаёт Git-репозиторий в текущем проекте и делает первый коммит. Подготавливает проект spec-kit к работе с Git. CX Codex +1 ★ 110звёзд репо cleanup-implementer Субагент cleanup-implementer выполняет один пакет задач по очистке репозитория. Меняет только свои файлы, запускает назначенные тесты и принципиально не трогает git. CX Codex ★ 110звёзд репо bench-prep Команда bench-prep для Claude Code и Codex сбрасывает три тестовые ячейки на базовое состояние и назначает им один размер задачи перед работой агента через расширение SpecKit Companion. CX Codex +1 ★ 110звёзд репо speckit.companion.before-converge Команда speckit.companion.before-converge для Claude Code записывает начало converge в .spec-context.json для Companion GUI. Её запускают перед шагом converge из корня репозитория. CX Codex +1 ★ 110звёзд репо speckit.companion.classify Команда speckit.companion.classify для Claude Code оценивает масштаб изменений по spec.md и выдаёт вердикт: simple, normal или oversized. Определяет сценарий работы в Speckit Companion без ручных переключателей. CX Codex +1 ★ 110звёзд репо

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

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