ci-guard — команда для Claude Code: проверка ветки и коммитов
Команда ci-guard запускает workflow ci-commit-branch-guard.yml по запросу: проверяет имя ветки и синтаксис Conventional Commits, не дожидаясь обычного триггера.
MIT ★ 907 обновлён 2025-11-12
.claude/commands/ci-guard.mdЧто делает ci-guard
Команда запускает GitHub Actions workflow ci-commit-branch-guard.yml вручную. На выходе две проверки: как названа ветка и правильно ли оформлено сообщение коммита по Conventional Commits.
Аргумент [ref] необязательный. Можно передать ветку или SHA, а без аргумента берётся текущая ветка через git branch --show-current. Дальше gh workflow run отправляет прогон, gh run watch --workflow "Commit & Branch Guard" показывает, как он идёт. Упавшую проверку чинят переименованием ветки или правкой коммита.
Первый шаг — gh auth status.
Какие задачи решает
- прогнать проверку имени ветки по запросу
- поймать опечатку в Conventional Commit на выбранной ветке
- проверить конкретный SHA вместо текущей ветки
- разобраться, почему прогон Commit & Branch Guard упал
- перезапустить проверку после переименования ветки
Примеры запросов агенту
- Прогони
/ci-guardи скажи, что не так с именем текущей ветки или сообщением последнего коммита. - Запусти
/ci-guard <ref>для указанной ветки и проследи за прогоном до конца. - Guard упал после переименования ветки — перезапусти
/ci-guardи покажи вывод.
Как установить ci-guard
Вручную: положить файлы
.claude/commands/ci-guard.mdВызов — /ci-guard. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/ci-guard.mdВызов — /prompts:ci-guard. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/ci-guard.prompt.mdВручную: положить файлы
.gemini/commands/ci-guard.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о ci-guard
Как установить ci-guard в Claude Code?
Скопируйте файл команды в .claude/commands/ci-guard.md внутри проекта. После этого вызывайте её как /ci-guard.
Что делает ci-guard?
Запускает workflow ci-commit-branch-guard.yml вручную и проверяет имя ветки и синтаксис Conventional Commits.
Что нужно, чтобы команда сработала?
Авторизованный GitHub CLI: первый шаг — gh auth status. Аргумент [ref] опционален, по умолчанию проверяется текущая ветка.
Исходный текст
ci-guard.md · MIT
---
description: Trigger the Commit & Branch Guard workflow on demand.
argument-hint: [ref]
---
## Purpose
Run `ci-commit-branch-guard.yml` manually to validate branch naming and Conventional Commit syntax.
## Usage
```
/ci-guard [ref]
```
- `ref` (optional): Branch or SHA to validate. Defaults to current branch.
## Steps
1. Ensure you are authenticated with GitHub CLI (`gh auth status`).
2. Determine the branch to validate (defaults to `git branch --show-current`).
3. Trigger the workflow:
```bash
gh workflow run ci-commit-branch-guard.yml --ref ${ref:-$(git branch --show-current)}
```
4. Watch progress:
```bash
gh run watch --workflow "Commit & Branch Guard"
```
5. Resolve any failures (branch rename or commit amend) before continuing.
© alirezarezvani · MIT · alirezarezvani/claude-code-skill-factory