request-refactor-plan

Acerca de request-refactor-plan

request-refactor-plan es una habilidad de planificación en idioma chino (traducida) proveniente de la colección mattpocock-skills-zh-cn (ruta obsoleta), que entrevista al usuario para elaborar un plan de refactorización detallado dividido en pequeños commits, el cual luego se guarda como un issue de GitHub. El problema que aborda es que las refactorizaciones a gran escala son arriesgadas si se realizan en pasos grandes; esta habilidad impone pasos incrementales y siempre funcionales, siguiendo el consejo de Martin Fowler de hacer que cada paso de refactorización sea lo más pequeño posible para poder ver siempre que el programa funciona.

El procedimiento (los pasos son opcionales) es el siguiente: pedir al usuario que describa el problema y las soluciones posibles; explorar el repositorio para verificar sus afirmaciones y comprender el estado actual; proponer opciones alternativas; entrevistar exhaustivamente al usuario sobre la implementación; definir con precisión el alcance, incluyendo qué se cambiará y qué no; verificar la cobertura de pruebas en el área afectada y preguntar sobre los planes de pruebas si es escasa; dividir la implementación en un plan de pequeños commits que mantengan siempre el códigobase en estado funcional; y finalmente crear un issue de GitHub utilizando una plantilla proporcionada con secciones para Enunciado del problema, Solución, Commits, Documento de decisiones, Decisiones de pruebas, Fuera del alcance y Otras notas opcionales. La plantilla evita deliberadamente rutas de archivos concretas y fragmentos de código, ya que estos se vuelven obsoletos rápidamente.

Está dirigida a desarrolladores y líderes técnicos que planifican refactorizaciones o redactan RFCs de refactorización y desean contar con un plan riguroso, basado en entrevistas e incremental de forma segura, registrado como un issue duradero. Su funcionamiento consiste en la exploración del repositorio más la creación de issues, sin realizar operaciones destructivas o sensibles.

Preguntas frecuentes

¿Qué crea esta habilidad?

Un plan de refactorización detallado, registrado como un issue de GitHub, utilizando una plantilla que incluye Enunciado del problema, Solución, Commits, Documento de decisiones, Decisiones de pruebas, Fuera del alcance y Otras notas opcionales.

¿Cómo mantiene segura la refactorización?

Divide el trabajo en pequeños commits, cada uno de los cuales mantiene el códigobase en estado funcional, siguiendo las directrices de Martin Fowler de hacer que cada paso de refactorización sea lo más pequeño posible.

¿El plan hace referencia a archivos o código específicos?

No. La plantilla omite intencionalmente rutas de archivos concretas y fragmentos de código, ya que estos se vuelven obsoletos rápidamente; se centra en decisiones, módulos, interfaces y comportamiento.

¿Qué hace respecto a las pruebas?

Verifica la cobertura de pruebas en el área afectada y, si esta es insuficiente, pregunta al usuario sobre sus planes de pruebas, registrando posteriormente las decisiones relacionadas con las pruebas en el issue.

¿Cuáles son los requisitos previos?

Un repositorio para explorar y entrevistar, además de la capacidad de crear un issue de GitHub con el plan finalizado.

Todos los archivos

2 archivosSKILL.md1.5 KBViewagents/openai.yaml0.1 KBView