api-review — скилл для Claude Code: что делает и как установить
Проверяет дизайн Kubernetes API и CRD в проекте Kelos на совместимость и соглашения. Помогает оценить изменения перед слиянием прямо в чате.
npx skills add gjkim42/kanon-repo --skill api-review -a claude-codeЧто делает api-review
Скилл нацелен на аудит схем Kubernetes API и определений CRD в репозитории Kelos. Агент читает изменённые файлы каталога api/ и сопоставляет имена полей с манифестами в examples/. Он также проверяет наличие свежих артефактов после запуска make update. По умолчанию анализ запускается для текущей ветки относительно origin/main.
Это инструмент только для ревью. Он не вносит правки в код и ничего не отправляет на GitHub. Для чтения контекста пулреквестов агенту требуется утилита gh. Найденные проблемы ранжируются по шкале от критических P0 до мелких P3. Любая блокирующая ошибка ведёт к вердикту REQUEST CHANGES прямо в чате.
Какие задачи решает
- Проверить обратную совместимость изменённых типов CRD
- Найти расхождения в именовании полей между схемами
api/и примерами - Убедиться в наличии сгенерированных манифестов после
make update - Получить структурированный вердикт по PR без отправки правок в репозиторий
Примеры запросов агенту
- Проведи API review для текущей ветки против main
- Проверь дизайн Kubernetes API в пулреквесте 124
- Оцени изменения в каталоге api/ на соответствие соглашениям CRD
Как установить api-review
1Через Skills CLI (Vercel)
npx skills add gjkim42/kanon-repo --skill api-review -a claude-code2Вручную: положить файлы
~/.claude/skills/api-review/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/api-review/
1Через Skills CLI (Vercel)
npx skills add gjkim42/kanon-repo --skill api-review -a codex2Вручную: положить файлы
.agents/skills/api-review/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add gjkim42/kanon-repo --skill api-review -a cursor2Вручную: положить файлы
.cursor/skills/api-review/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install gjkim42/kanon-repo api-review2Вручную: положить файлы
.github/skills/api-review/SKILL.md1Через Skills CLI (Vercel)
npx skills add gjkim42/kanon-repo --skill api-review -a gemini-cli2Командой платформы
gemini skills install https://github.com/gjkim42/kanon-repo --path skills/api-reviewВручную: положить файлы
.devin/skills/api-review/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add gjkim42/kanon-repo --skill api-review -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о api-review
Как установить api-review в Claude Code?
Выполните команду npx skills add gjkim42/kanon-repo --skill api-review -a claude-code. Манифест скилла сохранится в файл ~/.claude/skills/api-review/SKILL.md.
Что делает скилл api-review?
Он проверяет манифесты Kelos на соблюдение соглашений Kubernetes API и выявляет риски поломки обратной совместимости. Итог выводится в чат в виде таблицы с уровнями приоритета от P0 до P3.
Может ли скилл сам применить правки к коду или оставить комментарий на GitHub?
Нет, скилл работает исключительно в режиме чтения. Он не изменяет файлы проекта, не делает коммиты и не публикует комментарии к пулреквестам.
