CommunityProgramación y desarrollogithub.com

mattpocock/request-refactor-plan

Crea un plan detallado de refactorización con commits pequeños a través de una entrevista con el usuario, y luego regístralo como un issue de GitHub. Útil cuando el usuario quiera planificar una refactorización, crear un RFC de refactorización o dividir una refactorización en pasos incrementales seguros.

¿Qué es request-refactor-plan?

Este skill para agentes de IA conversacionales (como Claude Code, Cursor, o Codex) guía al usuario a través de un proceso estructurado de planificación de refactorización. Comienza con una entrevista interactiva donde el agente recopila detalles sobre el código a refactorizar, las razones y los objetivos. Luego genera un plan paso a paso con commits mínimos y seguros, y finalmente crea un archivo de issue de GitHub con el plan completo. Es útil para evitar cambios grandes y riesgosos, permitiendo una refactorización progresiva y documentada. El skill es multiplataforma y se activa cuando el usuario expresa la necesidad de planificar o documentar una refactorización.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mattpocock/skills/tree/main/skills/request-refactor-plan

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace request-refactor-plan?

Crea un plan detallado de refactorización con commits pequeños a través de una entrevista con el usuario, y luego regístralo como un issue de GitHub. Útil cuando el usuario quiera planificar una refactorización, crear un RFC de refactorización o dividir una refactorización en pasos incrementales seguros.

¿Cómo funciona?

  1. El agente inicia una entrevista interactiva con el usuario para entender:
    • El código o sistema objetivo
    • Las razones y beneficios de la refactorización
    • Los límites y restricciones
    • Los pasos deseados
  2. Con base en la entrevista, el agente genera un plan de refactorización detallado con commits pequeños y seguros.
  3. El agente crea automáticamente un issue de GitHub con el plan, listo para revisión y seguimiento.

Cuándo usarlo

  • Cuando el usuario quiera planificar una refactorización grande o pequeña
  • Para crear un RFC de refactorización formal
  • Para dividir una tarea compleja en pasos incrementales y seguros
  • Cuando se necesite documentación clara del proceso de refactorización

Ejemplo de uso

Usuario: "Necesito refactorizar el módulo de autenticación para separar la lógica de negocio de la capa de presentación."

Agente: "Claro, hagamos una entrevista rápida para definir los detalles..." (sigue una serie de preguntas)

Después de la entrevista, el agente genera un plan y lo registra como un issue.

Notas adicionales

  • El plan generado incluye commits pequeños que se pueden implementar de forma segura.
  • El issue se crea en el repositorio configurado actualmente.
  • Es compatible con cualquier proyecto que use GitHub para la gestión de issues.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

mattpocock/ask-matt

Ask which skill or flow fits your situation. A router over the skills in this repo.

mattpocock/caveman

Ultra-compressed communication mode. Cuts token usage ~75% by dropping filler, articles, and pleasantries while keeping full technical accuracy. Use when user says "caveman mode", "talk like caveman", "use caveman", "less tokens", "be brief", or invokes /caveman.

mattpocock/claude-handoff

Hand the current conversation off to a fresh background agent that picks up the work immediately.

mattpocock/codebase-design

Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.

mattpocock/design-an-interface

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

mattpocock/diagnose

Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument → fix → regression-test. Use when user says "diagnose this" / "debug this", reports a bug, says something is broken/throwing/failing, or describes a performance regression.

mattpocock/diagnosing-bugs

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.

mattpocock/domain-modeling

Build and sharpen a project's domain model. Use when the user wants to pin down domain terminology or a ubiquitous language, record an architectural decision, or when another skill needs to maintain the domain model.

mattpocock/edit-article

Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.

mattpocock/git-guardrails-claude-code

Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.

mattpocock/grilling

Grill the user relentlessly about a plan or design. Use when the user wants to stress-test a plan before building, or uses any 'grill' trigger phrases.

mattpocock/grill-me

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

mattpocock/grill-with-docs

Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.

mattpocock/handoff

Compact the current conversation into a handoff document for another agent to pick up.

mattpocock/implement

Implement a piece of work based on a PRD or set of issues.

mattpocock/implement-spec

Implement a specification in code.

mattpocock/improve-codebase-architecture

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

mattpocock/loop-me

Grill me about specs for the workflows I want to build, within this workspace.

mattpocock/migrate-to-shoehorn

Migrate test files from `as` type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace `as` in tests, or needs partial test data.

mattpocock/obsidian-vault

Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.

Skills relacionados