mattpocock/skills / request-refactor-plan
request-refactor-plan
- Установки
- 208,884
- Автор
- mattpocock/skills
- Источник
- github.com/mattpocock/skills
Скилл помогает составить детальный план рефакторинга: он уточняет у пользователя суть проблемы, изучает код, проверяет покрытие тестами и разбивает изменения на маленькие безопасные шаги. В итоге создаёт готовый GitHub issue с чёткой структурой — от описания проблемы до списка коммитов и решений. Полезен, когда нужно провести рефакторинг аккуратно, без риска сломать проект.
Установить скилл
npx skills add https://github.com/mattpocock/skills --skill request-refactor-plan
Аудит безопасности
Gen Agent Trust Hub
passThis 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
passNo alerts
Audited: 5/19/2026, 6:26:02 PM
Snyk
passRisk: LOW · No issues
Audited: 5/19/2026, 6:25:59 PM
Runlayer
pass1 file scanned · No issues
Audited: 3/13/2026, 9:59:12 PM
ZeroLeaks
passScore: 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.
-
Ask the user for a long, detailed description of the problem they want to solve and any potential ideas for solutions.
-
Explore the repo to verify their assertions and understand the current state of the codebase.
-
Ask whether they have considered other options, and present other options to them.
-
Interview the user about the implementation. Be extremely detailed and thorough.
-
Hammer out the exact scope of the implementation. Work out what you plan to change and what you plan not to change.
-
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.
-
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."
-
Create a GitHub issue with the refactor plan. Use the following template for the issue description:
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>Все файлы скилла
- agents/openai.yaml
- SKILL.md
Другие скиллы автора
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
Руководство по созданию предсказуемых скиллов для ИИ-агентов: описывает принципы и терминологию, помогающие писать чёткие инструкции, управлять контекстной нагрузкой и избегать типичных ошибок вроде дублирования и преждевременного завершения шагов.