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

speckit-git-validate — скилл для Claude Code: установка

Скилл speckit-git-validate проверяет имя текущей Git-ветки и ищет связанную папку спецификации в specs/. Нужен в проектах со структурой spec-kit.

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

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add alfredoperez/speckit-companion --skill speckit-git-validate -a claude-code
Открыть на GitHub

Что делает speckit-git-validate

Скилл проверяет, находится ли проект в Git-репозитории, получает имя текущей ветки и сверяет её последний сегмент с двумя правилами. Подходят последовательные имена вроде 001-feature-name и временные имена формата 20260319-143022-feature-name. Для веток с пространством имён проверяется именно последний сегмент.

После успешной проверки скилл ищет в specs/ папку с соответствующим числовым или временным префиксом. Он сообщает, найдена ли спецификация, а для обычной ветки показывает ожидаемый формат имени. В проекте должна быть директория .specify/. Без Git скилл использует SPECIFY_FEATURE как запасное значение, а без него пропускает проверку с предупреждением.

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

  • проверить имя текущей Git-ветки
  • найти ветки вне соглашения spec-kit
  • сопоставить ветку с папкой в specs/
  • использовать SPECIFY_FEATURE без Git

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

  • Проверь текущую ветку по правилам speckit-git-validate и найди связанную спецификацию.
  • Определи, соответствует ли имя ветки шаблону 001-feature-name или 20260319-143022-feature-name.
  • Проверь, есть ли в specs/ папка для префикса текущей feature-ветки.

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

1Через Skills CLI (Vercel)

npx skills add alfredoperez/speckit-companion --skill speckit-git-validate -a claude-code

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

~/.claude/skills/speckit-git-validate/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/speckit-git-validate/

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

Вопросы о speckit-git-validate

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

Выполните npx skills add alfredoperez/speckit-companion --skill speckit-git-validate -a claude-code, затем проверьте файл ~/.claude/skills/speckit-git-validate/SKILL.md.

Что делает speckit-git-validate?

Скилл проверяет имя текущей Git-ветки, определяет соответствующий префикс и ищет папку спецификации в specs/. Он также сообщает, если ветка не соответствует feature-шаблону.

Что нужно для работы speckit-git-validate?

Проект должен иметь структуру spec-kit с директорией .specify/. Если Git недоступен, скилл может проверить значение SPECIFY_FEATURE.

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

SKILL.md · MIT
---
name: speckit-git-validate
description: Validate current branch follows feature branch naming conventions
compatibility: Requires spec-kit project structure with .specify/ directory
metadata:
  author: spec-kit-core
  source: extension:git
user-invocable: true
disable-model-invocation: false
---

# Git Validate Skill

# 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

© spec-kit-core · MIT · alfredoperez/speckit-companion

Похожие скиллы

Все скиллы по теме «Git и GitHub» →
speckit-taskstoissues github-spec-kit Скилл speckit-taskstoissues превращает задачи из tasks.md в issues GitHub с учётом зависимостей. Скилл помечен как устаревший — есть замена в виде расширения. CX Codex +1 1 600установок speckit-converge github-spec-kit Скилл speckit-converge сравнивает текущий код с требованиями в spec.md, plan.md и tasks.md, затем добавляет в tasks.md новые задачи для оставшейся работы. Работает в проектах со структурой spec-kit. CX Codex +1 1 300установок git-advanced-workflows Seth Hobson Скилл git-advanced-workflows для Claude Code правит историю Git, переносит коммиты, ищет источник ошибки и восстанавливает потерянные ветки. Охватывает сложное ветвление и подготовку PR. CX Codex +1 19 356установок validate-branch-name davila7 Хук validate-branch-name перехватывает команды Bash перед запуском и не даёт создать ветку, которая не подходит под Git Flow. 464установок git-workflow affaan-m Скилл git-workflow с готовыми правилами Git: какую стратегию ветвления выбрать, как писать коммиты и когда rebase лучше merge. CX Codex +1 6 800установок conventional-git samber Скилл conventional-git задаёт правила именования веток и коммитов по стандарту Conventional Commits v1.0.0. Помогает поддерживать чистую историю проекта в GitHub и GitLab. CX Codex +1 5 400установок

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

Весь набор →
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звёзд репо speckit.companion.after-plan Команда speckit.companion.after-plan записывает в .spec-context.json отметку о завершении этапа планирования для GUI-интерфейса Companion. CX Codex +1 ★ 110звёзд репо speckit.companion.after-converge Команда speckit.companion.after-converge записывает завершение этапа converge в .spec-context.json для Companion GUI. Помогает передать статус выполнения интерфейсу Companion. CX Codex +1 ★ 110звёзд репо speckit.companion.after-specify Команда speckit.companion.after-specify для Claude Code и Codex, которая записывает текущий шаг spec-kit в .spec-context.json для GUI Companion. Запускается из корня репозитория после завершения этапа specify. CX Codex +1 ★ 110звёзд репо speckit.companion.after-implement Команда speckit.companion.after-implement записывает прогресс этапа implement из tasks.md в .spec-context.json для GUI Companion. CX Codex +1 ★ 110звёзд репо

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

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