Дом

Skill

Обзор кода

request-refactor-plan

vinvcn/mattpocock-skills-zh-cn

Путем проведения интервью с пользователями создается подробный план реконструкции с мелкими этапами выполнения, который затем предоставляется в виде задачи на GitHub. Этот подход подходит, когда пользователи хотят спланировать реконструкцию, составить соответствующий RFC или разделить процесс реконструкции на безопасные пошаговые этапы.

...Расширить все

Обновлено время 26 августа 2026 г.

# documentation # github # code-review # refactoring # Code ReviewGit & Version ControlDocumentation # planning

О функции request-refactor-plan

request-refactor-plan — это навык планирования на китайском языке (в переводе) из коллекции mattpocock-skills-zh-cn (устаревший путь), предназначенный для сбора информации у пользователя с целью создания подробного плана рефакторинга, разбитого на небольшие коммиты, после чего этот план сохраняется в виде задачи на GitHub. Проблема, которую он решает, заключается в том, что крупномасштабные рефакторинги, выполняемые одновременно в больших объемах, сопряжены с рисками; данный навык обеспечивает поэтапное выполнение действий, при которых программа всегда остается рабочей, следуя совету Мартина Фаулера делать каждый шаг рефакторинга максимально небольшим.

Процедура (этапы можно пропускать) выглядит следующим образом: пользователь описывает проблему и возможные решения; проводится изучение репозитория для проверки его утверждений и понимания текущего состояния; выдвигаются альтернативные варианты; с пользователем тщательно обсуждаются детали реализации; определяется точный объем работ, включая то, что будет изменено, а что — нет; проверяется уровень покрытия тестами в затронутой области, и при необходимости собираются информация о планах тестирования; реализация разбивается на план небольших коммитов, каждый из которых оставляет кодовую базу в рабочем состоянии; наконец, с помощью предоставленной шаблона создается задача на GitHub с разделами «Описание проблемы», «Решение», «Коммиты», «Документ с решениями», «Решения по тестированию», «Извлекаемое за рамки» и необязательным разделом «Дополнительные примечания». В шаблоне намеренно не указываются конкретные пути к файлам и фрагменты кода, поскольку они быстро устаревают.

Этот навык предназначен для разработчиков и технических лидеров, планирующих рефакторинги или составляющих соответствующие RFC, которые нуждаются в строгом, основанном на интервью, поэтапном плане, сохраненном в виде долговечной задачи. Его функционал включает изучение репозитория и создание задачи — без каких-либо разрушительных или конфиденциальных операций.

Часто задаваемые вопросы

Что создает этот навык?

Подробный план рефакторинга, сохраненный в виде задачи на GitHub с использованием шаблона, содержащего разделы «Описание проблемы», «Решение», «Коммиты», «Документ с решениями», «Решения по тестированию», «Извлекаемое за рамки» и необязательный раздел «Дополнительные примечания».

Как он обеспечивает безопасность рефакторинга?

Он разбивает работу на небольшие коммиты, каждый из которых оставляет кодовую базу в рабочем состоянии, следуя рекомендации Мартина Фаулера делать каждый шаг рефакторинга максимально небольшим.

Ссылается ли план на конкретные файлы или код?

Нет. В шаблоне намеренно не указываются конкретные пути к файлам и фрагменты кода, поскольку они быстро устаревают; внимание сосредотачивается на решениях, модулях, интерфейсах и поведении.

Что делается с тестированием?

Проверяется уровень покрытия тестами в затронутой области, и при недостаточном покрытии у пользователя запрашиваются информация о планах тестирования, после чего решения по тестированию записываются в задачу.