gerrit — скилл для Claude Code: ревью в Gerrit через git-review
Скилл ведёт изменения через Gerrit: отправляет патчсеты, скачивает чужие правки для проверки и отдаёт результаты запросов в markdown.
MIT 135 установок ★ 13 обновлён 2026-10-25
npx skills add odyssey4me/agent-skills --skill gerrit -a claude-codeЧто делает gerrit
Скилл собирает работу с Gerrit в один набор команд. Читающие операции идут через обёртку scripts/gerrit.py: changes list, changes view 12345, changes diff, changes search и projects list. Ответ приходит в markdown, поэтому агенту не нужно разбирать сырой вывод SSH.
Отправка и правка патчсетов остаются за git-review. Обычный git review заливает текущую ветку, git commit --amend с повторным git review добавляет новый патчсет, а git review -d 12345 скачивает чужое изменение в ветку review/username/topic. Ревьюеры перечисляются флагом --reviewers.
Перед первым запуском нужны pip install git-review, Python и SSH-ключ, добавленный в Gerrit. Имя пользователя прописывается в git config --global gitreview.username, хост и проект — в .gitreview или через git review -s. Без исходящего доступа к серверу Gerrit по HTTPS и SSH удалённые команды не пройдут — сетевые сбои скилл просит показывать как сетевые и не лечить сбросом учётных данных.
Какие задачи решает
- отправить ветку на ревью в Gerrit вместе с ревьюерами
- скачать чужой патчсет и прогнать на нём тесты
- посмотреть diff конкретного патчсета
- найти открытые изменения по проекту поисковым запросом
- залить новый патчсет после замечаний
Примеры запросов агенту
- Отправь текущую ветку на ревью с темой
auth-refactorи добавь ревьюеровuser1,user2. - Скачай изменение 12345 и покажи, какие файлы в нём поменялись.
- Найди открытые изменения в проекте
myprojectи выведи список.
Как установить gerrit
1Через Skills CLI (Vercel)
npx skills add odyssey4me/agent-skills --skill gerrit -a claude-code2Вручную: положить файлы
~/.claude/skills/gerrit/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/gerrit/
1Через Skills CLI (Vercel)
npx skills add odyssey4me/agent-skills --skill gerrit -a codex2Вручную: положить файлы
.agents/skills/gerrit/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add odyssey4me/agent-skills --skill gerrit -a cursor2Вручную: положить файлы
.cursor/skills/gerrit/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install odyssey4me/agent-skills skills/gerrit2Вручную: положить файлы
.github/skills/gerrit/SKILL.md1Через Skills CLI (Vercel)
npx skills add odyssey4me/agent-skills --skill gerrit -a gemini-cli2Командой платформы
gemini skills install https://github.com/odyssey4me/agent-skills --path skills/gerritВручную: положить файлы
.devin/skills/gerrit/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add odyssey4me/agent-skills --skill gerrit -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о gerrit
Как установить скилл gerrit в Claude Code?
Выполните npx skills add odyssey4me/agent-skills --skill gerrit -a claude-code. Файл скилла появится по пути ~/.claude/skills/gerrit/SKILL.md.
Что делает скилл gerrit?
Даёт агенту команды для Gerrit: список и просмотр изменений, diff патчсета, поиск по запросу, список проектов. Отправку и правку патчсетов он делает через git-review.
Что нужно, чтобы скилл заработал?
Пакет git-review из pip install git-review, Python для скрипта-обёртки и SSH-ключ, загруженный в настройки Gerrit. Удалённым командам нужен исходящий доступ к серверу ревью.
Исходный текст
SKILL.md · MIT
--- name: gerrit description: Submit, amend, and review Gerrit changes using git-review CLI. Use when asked to submit a patchset, download a change, rebase a change request, check CR status, or manage code reviews in Gerrit. metadata: author: odyssey4me version: "0.3.1" category: code-hosting tags: "code-review, patches" complexity: lightweight license: MIT --- # Gerrit Skill This skill provides Gerrit code review integration using `git-review` with a Python wrapper for markdown-formatted query output on read/view operations. Action commands (submit, review, abandon) should use `git-review` or SSH commands directly. ## Network access Gerrit commands require outbound HTTPS to the configured Gerrit REST API. Git fetch/push and git-review require HTTPS or SSH to the configured review and repository hosts. Remote operations require outbound network access. If the agent environment restricts it, obtain access through that environment's approval or network controls before the first remote command, reusing authorization already granted. Local help and file processing do not need network access. Skill instructions do not grant network permission. Report DNS, connection, and timeout failures as network errors; do not reset credentials to resolve them. If approved access also fails, stop and report it. Authentication and permission errors require user action. ## Resolving script paths `SKILL_DIR` in the examples is the directory containing this loaded `SKILL.md`. Set it to that absolute path before running commands; do not assume the agent sets this shell variable. Quote the script path if it contains spaces. ## Prerequisites **Install git-review**: `pip install git-review` — [docs](https://docs.opendev.org/opendev/git-review/latest/installation.html) ## Authentication git-review uses SSH for authentication with Gerrit servers. ```bash # Configure Gerrit username (if different from local user) git config --global gitreview.username yourgerrituser # Test SSH connection ssh -p 29418 [email protected] gerrit version # Add SSH key to Gerrit # 1. Generate SSH key if needed: ssh-keygen -t ed25519 # 2. Copy public key: cat ~/.ssh/id_ed25519.pub # 3. Add to Gerrit: Settings > SSH Keys ``` Gerrit supports multiple authentication methods: - **SSH** (recommended): Used by git-review for all operations - **HTTP/HTTPS**: For web UI and REST API access (set password in Settings > HTTP Password) See [Gerrit Authentication](https://gerrit-review.googlesource.com/Documentation/user-upload.html#ssh) for details. ## Initial Setup ### Configure Repository ```bash # One-time setup for a repository git review -s # Or manually create .gitreview file in repository root cat > .gitreview <<EOF [gerrit] host=review.example.com port=29418 project=myproject defaultbranch=main EOF ``` See [Installation Guide](https://docs.opendev.org/opendev/git-review/latest/installation.html) for details. ## Script Usage The wrapper script (`scripts/gerrit.py`) uses Gerrit SSH query commands and formats output as markdown. Connection details are read from `.gitreview` or provided via `--host`/`--port`/`--username` flags. See [permissions.md](references/permissions.md) for read/write classification of each command. ```bash # Check Gerrit SSH access $SKILL_DIR/scripts/gerrit.py check # Changes $SKILL_DIR/scripts/gerrit.py changes list $SKILL_DIR/scripts/gerrit.py changes view 12345 $SKILL_DIR/scripts/gerrit.py changes diff 12345 $SKILL_DIR/scripts/gerrit.py changes diff 12345 --patchset 3 $SKILL_DIR/scripts/gerrit.py changes search "status:open project:myproject" # Projects $SKILL_DIR/scripts/gerrit.py projects list ``` All commands support `--limit N` for list commands (default 30). Global connection options: `--host`, `--port` (default 29418), `--username`. ## Commands (Direct git-review Usage) For action commands, use `git-review` or SSH commands directly: ### Submitting Changes ```bash git review # Submit current branch for review git review -t topic-name # Submit with topic git review -f # Submit and close local branch git review --reviewers user1,user2 # Add reviewers git review -n # Dry-run (show what would be done) ``` Full reference: [git-review usage](https://docs.opendev.org/opendev/git-review/latest/usage.html) ### Downloading Changes ```bash git review -d 12345 # Download change 12345 git review -d 12345,3 # Download patchset 3 of change 12345 git review -x 12345 # Cherry-pick change (no branch) git review -m 12345 # Compare local changes to remote ``` Downloads create a local branch named `review/username/topic`. ### Updating Changes ```bash # Make changes to downloaded review git commit --amend git review # Upload new patchset # Update to latest patchset git review -d 12345 # Re-download updates the branch ``` ### Advanced Options ```bash git review -R # Don't rebase (submit as-is) git review -D # Draft mode (WIP changes) git review --no-cache # Skip local cache git review -v # Verbose output git review --track # Track remote branch ``` ## Configuration ### Per-Repository Settings File: `.gitreview` (repository root) ```ini [gerrit] host=review.example.com port=29418 project=myproject/subproject defaultbranch=main defaultremote=origin ``` ### Global Settings ```bash # Set Gerrit username git config --global gitreview.username myuser # Set default remote git config --global gitreview.remote gerrit # Configure scheme (ssh/http/https) git config --global gitreview.scheme ssh ``` Configuration stored in `~/.gitconfig` ## Examples ### Daily Workflow ```bash # Start work on new feature git checkout -b feature-branch # ... make changes ... git commit -m "Add new feature" # Submit for review git review -t feature-topic # Verify submission $SKILL_DIR/scripts/gerrit.py changes list # confirm change appears # Address review comments # ... make changes ... git commit --amend git review # Verify new patchset uploaded $SKILL_DIR/scripts/gerrit.py changes view <change-number> ``` ### Reviewing Others' Changes ```bash # Download change for review git review -d 12345 # Verify download $SKILL_DIR/scripts/gerrit.py changes view 12345 # Test the change # ... run tests, verify code ... # Return to main branch git checkout main git branch -D review/user/topic ``` ### Working with Topics ```bash # Submit with topic git review -t authentication-refactor # Verify submission $SKILL_DIR/scripts/gerrit.py changes list # All related changes will be grouped under this topic git commit -m "Part 2: Update tests" git review -t authentication-refactor ``` See [common-workflows.md](references/common-workflows.md) for more examples. ## Advanced Usage See [advanced-usage.md](references/advanced-usage.md) for SSH commands, JSON output, and multi-server configuration. ## Model Guidance This skill wraps an official CLI. A fast, lightweight model is sufficient. ## Troubleshooting See [troubleshooting.md](references/troubleshooting.md) for common issues and fixes. ## Official Documentation - **git-review Manual**: <https://docs.opendev.org/opendev/git-review/latest/> - **git-review Repository**: <https://opendev.org/opendev/git-review> - **Gerrit Documentation**: <https://gerrit-review.googlesource.com/Documentation/> - **Gerrit SSH Commands**: <https://gerrit-review.googlesource.com/Documentation/cmd-index.html>
© odyssey4me · MIT · odyssey4me/agent-skills