kodevu — скилл для Claude Code: что делает и как установить
Забирает диффы из Git или SVN, передаёт их в ИИ-ревьюер и сохраняет отчёты разбора кода в Markdown или JSON.
npx skills add gyteng/kodevu --skill kodevu -a claude-codeЧто делает kodevu
Утилита запускается через npx kodevu и автоматизирует проверку кода в репозиториях. Скилл умеет извлекать патчи из локальных каталогов Git или рабочих копий SVN, включая удалённые URL репозиториев. Для анализа можно выбрать один коммит по хешу через --rev, диапазон последних изменений через --last или незакоммиченные правки флагом --uncommitted.
В роли ревьюера выступают бэкенды openai, gemini, codex или copilot. По умолчанию активен режим auto, опрашивающий доступные бинарники в системном PATH. Результаты работы записываются в файлы Markdown в директорию ~/.kodevu/, а при передаче аргумента --format json формируют машиночитаемый отчёт.
Параметры работы переопределяются через флаги командной строки, переменные окружения вроде KODEVU_REVIEWER или файл ~/.kodevu/config.json. Без установленного Node.js и настроенного CLI-ревьюера в PATH автоматический запуск завершится сбоем.
Какие задачи решает
- проверить незакоммиченные изменения перед отправкой в ветку
- сгенерировать отчёт ревью по последним коммитам в JSON или Markdown
- передать diff из Git или SVN во внешний ИИ-ревьюер
- задать правила проверки кода через внешний файл промпта
Примеры запросов агенту
- Проверь последние три коммита в репозитории через kodevu
- Запусти kodevu на незакоммиченных правках и сохрани JSON-отчёт в папку ./reports
- Выполни ревью коммита с фокусом на уязвимости с помощью kodevu
Как установить kodevu
1Через Skills CLI (Vercel)
npx skills add gyteng/kodevu --skill kodevu -a claude-code2Вручную: положить файлы
~/.claude/skills/kodevu/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/kodevu/
1Через Skills CLI (Vercel)
npx skills add gyteng/kodevu --skill kodevu -a codex2Вручную: положить файлы
.agents/skills/kodevu/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add gyteng/kodevu --skill kodevu -a cursor2Вручную: положить файлы
.cursor/skills/kodevu/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install gyteng/kodevu kodevu2Вручную: положить файлы
.github/skills/kodevu/SKILL.md1Через Skills CLI (Vercel)
npx skills add gyteng/kodevu --skill kodevu -a gemini-cli2Командой платформы
gemini skills install https://github.com/gyteng/kodevuВручную: положить файлы
.devin/skills/kodevu/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add gyteng/kodevu --skill kodevu -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о kodevu
Как установить kodevu в Claude Code?
Выполните команду npx skills add gyteng/kodevu --skill kodevu -a claude-code в терминале.
Какие бэкенды ревью поддерживает kodevu?
Поддерживаются openai, gemini, codex и copilot. Значение по умолчанию auto ищет доступные CLI-инструменты в вашем PATH.
Где сохраняются созданные отчёты?
По умолчанию Markdown-файлы попадают в ~/.kodevu/. Изменить папку можно флагом --output <dir>, а переключить формат на JSON — через --format json.
Исходный текст
SKILL.md · MIT
---
name: kodevu
description: A tool to fetch Git/SVN diffs, send them to an AI reviewer, and generate configurable code review reports.
---
# Kodevu Skill
Kodevu is a Node.js tool that fetches Git commits or SVN revisions, sends the diff to a supported AI reviewer CLI, and writes review results to report files. It supports an optional persistent config file at `~/.kodevu/config.json` for settings that should survive across sessions.
## Usage
Use `npx kodevu` to review a codebase.
### Reviewing the latest commit
```bash
npx kodevu .
```
### Reviewing a specific commit
```bash
npx kodevu . --rev <commit-hash>
```
### Reviewing the last N commits
```bash
npx kodevu . --last 3
```
### Reviewing uncommitted changes
```bash
npx kodevu . --uncommitted
```
### Supported Reviewers
`kodevu` supports several AI reviewer backends: `auto`, `openai`, `gemini`, `codex`, `copilot`. The default is `auto`, which probes available CLI tools in your `PATH`.
Example using OpenAI:
```bash
npx kodevu . --reviewer openai --openai-api-key <YOUR_API_KEY> --openai-model gpt-5-mini
```
### Generating JSON Reports
By default, review reports are generated as Markdown files in `~/.kodevu/`. You can specify `--format json` or change the output directory using `--output <dir>`.
```bash
npx kodevu . --format json --output ./reports
```
### Custom Prompts
You can provide additional instructions to the reviewer using `--prompt`:
```bash
npx kodevu . --prompt "Focus on security issues and suggest optimizations."
```
Or from a file: `--prompt @my-rules.txt`
### Environment Variables
All options can also be set via environment variables to avoid repetitive flags:
- `KODEVU_REVIEWER` – Default reviewer.
- `KODEVU_LANG` – Default output language.
- `KODEVU_OUTPUT_DIR` – Default output directory.
- `KODEVU_PROMPT` – Default prompt instructions.
- `KODEVU_OPENAI_API_KEY` – API key for `openai`.
- `KODEVU_OPENAI_BASE_URL` – Base URL for `openai`.
- `KODEVU_OPENAI_MODEL` – Model for `openai`.
### Configuration File
For persistent settings that survive across shells and AI tool invocations, create `~/.kodevu/config.json`:
```json
{
"reviewer": "openai",
"openaiApiKey": "sk-...",
"openaiBaseUrl": "https://your-gateway.example.com/v1",
"openaiModel": "gpt-4o",
"lang": "zh"
}
```
The file is optional and silently ignored if absent. Priority: **CLI flags > ENV vars > config file > defaults**.
## Working with Target Repositories
- **Git**: `target` must be a local repository or subdirectory.
- **SVN**: `target` can be a working copy path or repository URL.
```bash
npx kodevu /path/to/project --last 1
```
© gyteng · MIT · gyteng/kodevu
