Полный отзыв, код, требования и ранее принятые технические решения.
Разбор замечаний, обоснованные исправления или возражения и сведения о выполненных проверках.
Кому пригодится
Разработчикам, получившим замечания к изменениям.
Требования и ограничения
Разобрать замечания к коду перед исправлениями
Скилл помогает отвечать на результаты ревью и вносить обоснованные изменения. Основной порядок — прочитать весь отзыв, понять требования, сопоставить их с кодом и только затем править. Это полезно, когда комментарии неоднозначны, предлагают крупную переделку или противоречат принятому решению.
Уточнить смысл связанных замечаний
Агент переформулирует техническое требование и выделяет непонятные пункты. Автор предлагает сначала прояснить связанные вопросы, поскольку частичное понимание может привести к несовместимым изменениям. Например, указание исправить шесть пунктов не означает, что можно угадать смысл двух из них и продолжить. В ответе должно быть видно, что именно понятно и какой информации не хватает.
Сопоставить предложение с реальным проектом
Для внешнего отзыва рассматриваются причины текущей реализации, поддерживаемые платформы и версии, возможные поломки и полнота контекста рецензента. Предложение удалить старый код может конфликтовать с поддержкой прежней версии системы. Отсутствие вызовов внутри репозитория тоже требует внимания к внешним потребителям: один поиск по исходникам не доказывает ненужность публичного интерфейса.
Обсуждать разногласия по существу
Если рекомендация неверна или нарушает архитектурные договорённости, скилл предлагает объяснить конкретную причину и сослаться на код, тесты или требования. Если подтвердить вывод пока нельзя, ограничение нужно назвать прямо. Источник делает акцент на техническом ответе вместо автоматического согласия. При обнаружении собственной ошибки достаточно исправить вывод и перейти к работе.
Исправлять в порядке риска
После уточнений автор предлагает начать с блокирующих проблем и безопасности, затем выполнить простые исправления и перейти к сложным изменениям логики. Пункты вносятся последовательно с подходящими проверками, чтобы причина нового сбоя оставалась понятной. Предложение добавить большую подсистему отдельно сопоставляется с реальной потребностью: полнота реализации не является самостоятельной целью.
Зафиксировать результат рядом с замечанием
Итоговый ответ сообщает, что изменено и где, либо почему предложение не принято. Для адресных комментариев GitHub источник рекомендует отвечать в той же ветке обсуждения, чтобы контекст не потерялся. Сам скилл не устанавливает доступ к репозиторию и не заменяет разрешение на внешнюю переписку. Его результат — обоснованный разбор, конкретные правки и сведения о выполненных проверках.
Автор и источник
Оригинальное название: receiving-code-review
Автор или репозиторий: obra/superpowers
Лицензия: MIT
Открыть первоисточник