view --main pr-review-avtomatizirovannaya-proverka-pull-requests-dlya-navykov.md

pr-review — Автоматизированная проверка pull requests для навыков

Name: pr-review — Автоматизированная проверка pull requests для навыков
Author: MiniMax-AI/skills

pr-review автоматизирует проверку pull requests, обеспечивая соответствие навыков заранее определенным структурным и качественным требованиям. Это решает проблему непоследовательности и отклонений от стандартов при внесении изменений в базу навыков, гарантируя их целостность и единообразие. Инструмент представляет собой CLI-инструмент, который легко интегрируется в существующие процессы разработки.

Для автоматизированной проверки используются Python скрипты и конфигурационные файлы в формате YAML. Работа с инструментом осуществляется через командную строку, позволяя быстро и эффективно выполнять валидацию. Скрипт validate_skills.py проверяет наличие обязательных файлов, корректность синтаксиса YAML и соответствие структуры навыков заданным правилам.

pr-review – это удобная терминальная утилита, предназначенная для автоматизации проверки структуры и качества навыков. Инструмент позволяет разработчикам сосредоточиться на содержательной части pull request после успешного прохождения автоматизированных проверок, что повышает эффективность и снижает вероятность ошибок. Использование Bash и Markdown позволяет легко настраивать и расширять правила проверки.

$ git log --oneline --stat

⭐ звёзды: 7,435

форки: 556

обновлено: 27 марта 2026 года в 12:47

Проводник файлов

4 файлы

SKILL.md

references

quality-guidelines.md 2.6 KB

structure-rules.md 1.8 KB

scripts

validate_skills.py 7 KB

SKILL.md

readonly --- lines

--- name: pr-review description: > Review pull requests for the MiniMax Skills repository. Use when reviewing PRs, validating new skill submissions, or checking existing skills for compliance. Run the validation script first for hard checks, then apply quality guidelines for content review. Triggers: PR review, pull request, validate skill, check skill. license: MIT metadata: version: "1.0" category: tooling --- # PR Review Skill Review pull requests against repository standards. Two-phase process: automated validation, then manual content review. ## Phase 1: Automated Validation (Hard Rules) Run the validation script to check structural requirements: ```bash python .claude/skills/pr-review/scripts/validate_skills.py ``` The script checks: - `SKILL.md` exists in every skill directory - YAML frontmatter is parseable - Required fields present: `name`, `description` - `name` matches directory name - No hardcoded secrets detected All ERROR-level checks must pass. WARNING-level items (missing `license`, `metadata`) should be flagged but are not blockers. See [references/structure-rules.md](references/structure-rules.md) for the complete hard rules specification. ## Phase 2: Content Review (Soft Guidelines) After automated checks pass, review the PR against quality guidelines: 1. **Skill scope** — Does it overlap with existing skills? Is the boundary clear? 2. **Description quality** — Does the `description` include clear trigger conditions? 3. **File size** — Are reference docs reasonably sized for context window consumption? 4. **API key handling** — If external APIs are used, are credentials read from environment variables? 5. **Script quality** — Do scripts have shebang, requirements.txt, and error handling? 6. **Language** — Are SKILL.md and code written in English? 7. **README sync** — Are `README.md` and `README_zh.md` updated for new skills? See [references/quality-guidelines.md](references/quality-guidelines.md) for soft guidelines details. ## Review Checklist Summary ### Must Pass (Blockers) - [ ] `validate_skills.py` exits with code 0 - [ ] PR title follows conventional commit format - [ ] One PR, one purpose ### Should Pass (Flagged in Review) - [ ] No functional overlap with existing skills - [ ] Description includes trigger conditions - [ ] Files are reasonably sized - [ ] API keys via environment variables - [ ] README tables updated for new skills (Source column set to `Community`)

Инициализация мануала...