moyu

Visión general de la skill moyu

Qué hace la skill moyu

La skill moyu es una barrera de contención para cambios de código: empuja al modelo a mantenerse dentro del alcance pedido por el usuario, evitar abstracciones innecesarias y preferir el diff más pequeño posible y seguro. Si buscas una skill para Code Editing que resista el sobre-diseño, moyu está pensada בדיוק para eso.

Quién debería usarla

Usa la skill moyu cuando te importe más la precisión que la amplitud: corregir un bug concreto, cambiar un solo archivo, recortar un diff o responder a una petición del tipo “por favor, toca solo X”. Es especialmente útil para revisores, mantenedores y agentes que trabajan en bases de código consolidadas, donde una limpieza extra puede introducir riesgo.

Por qué destaca

Su principal diferenciador es su sesgo fuerte hacia la contención. La skill desaconseja explícitamente nuevas dependencias, reescrituras amplias, validaciones extra, tests, comentarios y capas auxiliares, salvo que el usuario las haya pedido. Eso hace que moyu sea muy sólida para ediciones reales en las que el peligro no es quedarse corto, sino cambiar demasiado.

Cómo usar la skill moyu

Instala y activa moyu

Instala la skill moyu en el directorio de skills de tu agente y asegúrate de que tu flujo de trabajo de código la cargue antes de editar. Una instalación típica se ve así: npx skills add uucz/moyu --skill moyu. Para mejores resultados, actívala en tareas donde el prompt ya señale moderación, como “solo actualiza esta función” o “mantén el cambio al mínimo”.

Da a la skill un briefing acotado

La skill moyu funciona mejor cuando tu prompt nombra el archivo exacto, la función exacta, el comportamiento exacto o el resultado que debe cambiar. Entradas sólidas se ven así: “En src/auth.ts, corrige solo el bug de refresh del token; no refactorices ni añadas archivos nuevos.” Entradas débiles como “mejora auth” dejan demasiado margen para expandirse y van contra el objetivo de usar moyu.

Lee primero los archivos correctos

Empieza por SKILL.md, y luego revisa los archivos que realmente piensas editar y cualquier contexto cercano que explique las convenciones locales. Como este repositorio es deliberadamente ligero, no hay scripts extra ni directorios de soporte que te orienten; el valor central está en el propio texto de la skill. Eso significa que tu mejor flujo es: leer la skill, definir la superficie editable más pequeña y luego ejecutar.

Trabaja como espera moyu

Cuando uses moyu para Code Editing, pide primero la corrección mínima y luego itera solo si el resultado sigue sin dar en el blanco. Si necesitas más cambios, añádelos en una segunda solicitud en lugar de ampliar la primera. Así mantienes los diffs pequeños, facilitas la revisión y alineas el trabajo con la regla de la skill: “cambia solo lo que se pidió”.

Preguntas frecuentes sobre la skill moyu

¿moyu es un asistente de programación completo?

No. La skill moyu no busca maximizar el alcance, sino limitarlo y evitar ediciones innecesarias. Si quieres refactorización amplia, scaffolding o ayuda de arquitectura, un prompt general de programación puede encajar mejor que la skill moyu.

¿Cuándo no debería usar moyu?

No uses moyu cuando la tarea realmente requiera coordinación entre varios archivos, nuevas abstracciones o una limpieza sistémica. Si el trabajo es “haz la arquitectura más limpia” o “añade la suite de tests que falta”, la contención de la skill puede convertirse en una limitación en vez de una ventaja.

¿moyu es buena para principiantes?

Sí, si la persona principiante quiere ediciones más seguras y menos cambios sorpresa. La guía de moyu es especialmente útil para quienes tienden a pedirle demasiado al modelo o aceptan diffs demasiado grandes. Enseña un valor por defecto muy útil: pide el cambio más pequeño que resuelva el problema.

¿En qué se diferencia de simplemente decirle al modelo que tenga cuidado?

Un prompt normal puede pedir cautela, pero la skill moyu codifica esa preferencia como una política de edición reutilizable. Eso importa cuando necesitas de forma repetida un comportamiento de diff mínimo en distintas tareas, no solo en prompts puntuales.

Cómo mejorar la skill moyu

Haz la solicitud más pequeña y explícita

La forma más efectiva de mejorar el resultado de moyu es eliminar la ambigüedad antes de la primera edición. Incluye la ruta exacta del archivo, el comportamiento exacto que debe preservarse y el cambio exacto que quieres. Por ejemplo: “Edita solo components/Button.tsx; no cambies las props; solo corrige el estilo de disabled.”

Indica qué no debe cambiar

La skill rinde mejor cuando le dices qué debe dejar intacto. Menciona cosas como “sin archivos nuevos”, “sin dependencias nuevas”, “no cambies la forma de la API” o “no reescribas toda la función”. Eso ayuda a que moyu se alinee con la intención real del usuario en lugar de optimizar hacia una mejora más amplia pero no deseada.

Revisa el primer diff y luego afina

Si el primer resultado sigue siendo demasiado grande, devuelve las partes sobredimensionadas y pide una pasada más acotada. Los fallos más comunes son limpieza extra, abstracciones añadidas o código defensivo que no se pidió. El mejor flujo con moyu es iterativo: acota, revisa y vuelve a recortar hasta que el diff encaje con la solicitud.