Agentskillz Logo

mattpocock/skills / request-refactor-plan

request-refactor-plan

Установки
208,884
Автор
mattpocock/skills

Скилл помогает составить детальный план рефакторинга: он уточняет у пользователя суть проблемы, изучает код, проверяет покрытие тестами и разбивает изменения на маленькие безопасные шаги. В итоге создаёт готовый GitHub issue с чёткой структурой — от описания проблемы до списка коммитов и решений. Полезен, когда нужно провести рефакторинг аккуратно, без риска сломать проект.

Установить скилл

npx skills add https://github.com/mattpocock/skills --skill request-refactor-plan

Аудит безопасности

Gen Agent Trust Hub

pass

This skill acts as a template for planning codebase refactors and creating GitHub issues. It presents a standard indirect prompt injection surface by processing untrusted repository content and user input without explicit boundary markers.

Audited: 5/19/2026, 6:26:14 PM

Socket

pass

No alerts

Audited: 5/19/2026, 6:26:02 PM

Snyk

pass

Risk: LOW · No issues

Audited: 5/19/2026, 6:25:59 PM

Runlayer

pass

1 file scanned · No issues

Audited: 3/13/2026, 9:59:12 PM

ZeroLeaks

pass

Score: 93/100 · 2 sections analyzed

Audited: 4/16/2026, 12:58:19 PM

Промпт скилла

This skill will be invoked when the user wants to create a refactor request. You should go through the steps below. You may skip steps if you don't consider them necessary.

  1. Ask the user for a long, detailed description of the problem they want to solve and any potential ideas for solutions.

  2. Explore the repo to verify their assertions and understand the current state of the codebase.

  3. Ask whether they have considered other options, and present other options to them.

  4. Interview the user about the implementation. Be extremely detailed and thorough.

  5. Hammer out the exact scope of the implementation. Work out what you plan to change and what you plan not to change.

  6. Look in the codebase to check for test coverage of this area of the codebase. If there is insufficient test coverage, ask the user what their plans for testing are.

  7. Break the implementation into a plan of tiny commits. Remember Martin Fowler's advice to "make each refactoring step as small as possible, so that you can always see the program working."

  8. Create a GitHub issue with the refactor plan. Use the following template for the issue description:

<refactor-plan-template>

Problem Statement

The problem that the developer is facing, from the developer's perspective.

Solution

The solution to the problem, from the developer's perspective.

Commits

A LONG, detailed implementation plan. Write the plan in plain English, breaking down the implementation into the tiniest commits possible. Each commit should leave the codebase in a working state.

Decision Document

A list of implementation decisions that were made. This can include:

  • The modules that will be built/modified
  • The interfaces of those modules that will be modified
  • Technical clarifications from the developer
  • Architectural decisions
  • Schema changes
  • API contracts
  • Specific interactions

Do NOT include specific file paths or code snippets. They may end up being outdated very quickly.

Testing Decisions

A list of testing decisions that were made. Include:

  • A description of what makes a good test (only test external behavior, not implementation details)
  • Which modules will be tested
  • Prior art for the tests (i.e. similar types of tests in the codebase)

Out of Scope

A description of the things that are out of scope for this refactor.

Further Notes (optional)

Any further notes about the refactor.

</refactor-plan-template>

Все файлы скилла

Другие скиллы автора

grill-me

1,012,484 установок

mattpocock/skills

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

grill-with-docs

862,884 установок

mattpocock/skills

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

improve-codebase-architecture

829,821 установок

mattpocock/skills

Анализирует кодовую базу, выявляет архитектурные проблемы и предлагает рефакторинг через углубление «мелких» модулей. Формирует наглядный HTML-отчёт с диаграммами «до/после» и приоритетными рекомендациями, затем помогает детально проработать выбранные улучшения с учётом доменной модели и принятых решений.

tdd

802,461 установок

mattpocock/skills

Скилл для разработки через тестирование (TDD): помогает создавать функции и исправлять ошибки по циклу «красный-зеленый-рефакторинг», писать качественные тесты через публичные интерфейсы и избегать анти-паттернов. Полезен, когда нужно строить фичи тест-первым или добавлять интеграционные тесты.

setup-matt-pocock-skills

739,455 установок

mattpocock/skills

Настраивает репозиторий для работы инженерных навыков: определяет, где хранятся задачи, какие метки триажа использовать и как устроены доменные документы. Запускается один раз перед первым использованием других скиллов, чтобы они могли корректно читать и записывать данные.

handoff

704,918 установок

mattpocock/skills

Скилл создаёт компактный документ передачи дел для другого агента, суммируя текущий разговор и сохраняя его во временную папку. Он включает раздел с рекомендуемыми скиллами, ссылается на существующие артефакты и скрывает чувствительные данные, помогая новому агенту быстро продолжить работу.

triage

696,924 установок

mattpocock/skills

Скилл для триажа задач и пул-реквестов в репозитории: классифицирует по категориям (баг/улучшение) и состояниям (нужен триаж, нужна информация, готово для агента, готово для человека, не будет исправлено), проверяет дубликаты и воспроизводимость, готовит краткие задания для агентов или людей. Помогает поддерживать порядок в issue tracker и ускорять обработку входящих запросов.

prototype

687,506 установок

mattpocock/skills

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

grilling

581,817 установок

mattpocock/skills

Скилл помогает проверить идею, план или решение на прочность: он задаёт наводящие вопросы и выстраивает дерево решений, пока не будет достигнуто полное понимание. Полезен, когда нужно увидеть слабые места замысла, ничего не упустить и принять взвешенное решение.

teach

561,904 установок

mattpocock/skills

Скилл teach превращает текущую директорию в интерактивное учебное пространство для поэтапного освоения новых навыков. Он создаёт структуру из файлов (миссия, справочники, уроки, записи) и применяет педагогические принципы для эффективного и долгосрочного обучения. Полезен для агентов, которые хотят системно обучать пользователя чему-либо в рамках проекта.

domain-modeling

530,760 установок

mattpocock/skills

Навык помогает активно развивать и уточнять доменную модель проекта: оспаривать неоднозначные термины, проверять граничные сценарии и фиксировать глоссарий в CONTEXT.md, а архитектурные решения — в ADR. Полезен для поддержания точного общего языка в команде и предотвращения расхождений между кодом и терминологией.

codebase-design

514,952 установок

mattpocock/skills

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

diagnosing-bugs

506,966 установок

mattpocock/skills

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

ask-matt

468,783 установок

mattpocock/skills

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

implement

460,958 установок

mattpocock/skills

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

code-review

448,829 установок

mattpocock/skills

Проводит ревью изменений кода относительно заданной точки (коммита, ветки или тега) по двум независимым осям: соответствие стандартам репозитория и реализация требований задачи. Запускает две параллельные проверки и выдаёт раздельные отчёты, чтобы одна ось не маскировала другую. Удобен для оценки веток, пулл-реквестов и незавершённой работы.

wayfinder

417,690 установок

mattpocock/skills

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

research

410,104 установок

mattpocock/skills

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

to-spec

406,183 установок

mattpocock/skills

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

to-tickets

399,190 установок

mattpocock/skills

Превращает план, спецификацию или текущий диалог в набор вертикальных «трассерных» тикетов, каждый из которых описывает сквозной пользовательский сценарий и свои блокирующие зависимости. Согласует разбивку с пользователем, публикует тикеты в локальные файлы или реальный трекер (GitHub, Linear) и учитывает широкие рефакторинги через стратегию expand–contract.

resolving-merge-conflicts

394,667 установок

mattpocock/skills

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

to-prd

366,194 установок

mattpocock/skills

Превращает текущий диалог в PRD (документ требований к продукту) и публикует его в трекере задач проекта. Без интервью — просто синтезирует уже обсуждённое, учитывает глоссарий и архитектурные решения проекта, определяет точки тестирования и ставит метку ready-for-agent.

to-issues

353,211 установок

mattpocock/skills

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

writing-great-skills

321,041 установок

mattpocock/skills

Руководство по созданию предсказуемых скиллов для ИИ-агентов: описывает принципы и терминологию, помогающие писать чёткие инструкции, управлять контекстной нагрузкой и избегать типичных ошибок вроде дублирования и преждевременного завершения шагов.