SKILL.md, где описаны условия применения и шаги работы. Для ревью полезно зафиксировать критерии: что считать дефектом, какие проверки запускать и как доказывать вывод.Когда это действительно нужно
Обычная просьба «посмотри PR» даёт разный результат от запуска к запуску. Один раз агент ищет ошибки состояния, другой — комментирует стиль. Навык нужен там, где процесс повторяется и команда хочет сравнимое качество.
Пошаговый маршрут
Ограничьте область
Напишите, что Skill применяется к изменённым файлам и не редактирует код без отдельной просьбы. Укажите приоритеты: функциональные ошибки, безопасность, доступность, регрессии; стилистические замечания — только если они влияют на работу.
Потребуйте воспроизведение
Пусть агент читает diff, вызовы функций и тесты, запускает доступные проверки и указывает файл, строку, входные условия и последствия. Если проблему нельзя подтвердить, это гипотеза, а не найденный баг.
Зафиксируйте отчёт
Для каждого вывода требуйте серьёзность, краткую причину и способ проверки. Отдельно — список проверок, которые не удалось запустить, чтобы отсутствие теста не выглядело как успешный результат.
Пример для практики
«Проверяй только изменённое поведение и связанный код. Сначала найди путь воспроизведения. Не называй дефектом вопрос вкуса. Верни findings от критичных к незначительным; если подтверждённых проблем нет, так и скажи».
Что проверить перед запуском
- Не добавляйте в Skill секреты или приватные ключи.
- Проверьте навык на небольшом PR с известным дефектом и на чистом PR.
- После обновления тестового стека пересмотрите команды в инструкции.
Официальный источник
Проверить актуальные возможности: Документация OpenAI: Build skills ↗. Интерфейсы и права доступа могут меняться.
Разберём вашу задачу
Поможем выбрать рабочий сценарий для повторяемого AI-процесса — с реальными правами, данными и контрольными точками.
Обсудить задачу ↗