moyu-fr

Visão geral da skill moyu-fr

moyu-fr é uma skill de proteção para edição de código voltada para agentes que tendem a exagerar na solução. Ela foi feita para quem quer a menor mudança correta possível, especialmente quando o pedido pode ser resolvido editando só as linhas solicitadas, em vez de reescrever arquivos, adicionar abstrações ou “melhorar” o código além do escopo.

Para que a skill moyu-fr serve

A skill moyu-fr é mais indicada para trabalho no estilo patch: correções cirúrgicas, refatorações pontuais, consertos rápidos de bugs e respostas a usuários que pedem explicitamente algo “simples”, “mínimo” ou “apenas altere X”. Ela ajuda a manter o agente alinhado com a verdadeira tarefa: fazer a mudança pedida e parar.

Por que esta skill é diferente

Ao contrário de um prompt genérico, a moyu-fr codifica regras explícitas contra o overengineering. Ela desencoraja camadas novas, dependências extras, código defensivo para casos impossíveis e documentação ou testes irrelevantes. Isso a torna útil quando a qualidade da saída é medida pela contenção, não pela amplitude.

Usuários ideais e casos em que ela não se encaixa

Use a moyu-fr para Code Editing quando o repositório ou a tarefa forem sensíveis ao tamanho do diff, à deriva arquitetural ou à limpeza desnecessária. Ela é uma escolha mais fraca se você realmente quer redesenho, expansão de funcionalidade, criação de testes ou uma modernização ampla da base de código, porque a skill é otimizada para minimizar mudanças.

Como usar a skill moyu-fr

Instale e confirme o caminho de ativação

Use o fluxo de instalação de skills do repositório para moyu-fr e depois confirme que o agente consegue detectar a skill a partir do seu pedido de edição. A decisão de moyu-fr install faz mais sentido quando o seu fluxo já inclui controle rígido de escopo e você quer que a skill atue automaticamente diante de sinais de overengineering.

Dê a ela um brief de edição estreito

O melhor padrão de moyu-fr usage é um pedido preciso, com limites claros. Boas entradas nomeiam o arquivo alvo, a mudança exata de comportamento e o que não pode mudar.

Exemplos de brief forte:

• “Edite src/auth.ts para corrigir a verificação de null em validateSession; não altere o tratamento de erros nem adicione helpers.”
• “Atualize somente a regex no exemplo de README.md; mantenha o restante do trecho inalterado.”

Entradas fracas são amplas:

• “Melhore o fluxo de autenticação”
• “Faça uma limpeza neste módulo”
• “Deixe isso mais robusto”

Esses prompts convidam à expansão, justamente o que a skill tenta evitar.

Leia os arquivos certos primeiro

Para um guia prático de moyu-fr, comece com SKILL.md e depois verifique quaisquer notas de repositório vinculadas ou arquivos específicos da tarefa mencionados pelo repositório. No formato atual desta skill, o principal sinal está no próprio corpo da skill, então o caminho de leitura mais útil é seguir as instruções, a árvore do repositório e os arquivos imediatos que você pretende editar. Se você não consegue dizer qual é o alvo exato e o diff mínimo aceitável, o prompt ainda está vago demais.

Use-a como filtro de contenção, não como motor de reescrita

A skill funciona melhor quando você já sabe o resultado desejado e quer bloquear excessos. Ela deve orientar as edições do agente para:

• mudanças mínimas de linha
• nenhuma abstração nova, a menos que seja solicitado
• nenhuma documentação, teste ou comentário extra, a menos que seja pedido
• nenhuma reescrita de arquivo quando um patch for suficiente

Perguntas frequentes sobre a skill moyu-fr

A moyu-fr é só para Code Editing?

Sim, o melhor encaixe da moyu-fr é Code Editing com controle rígido de escopo. Ela é menos útil para geração aberta, planejamento de arquitetura ou tarefas em que se espera material de apoio extra.

Em que ela difere de um prompt normal?

Um prompt normal pode dizer “mantenha simples”, mas a moyu-fr transforma essa preferência em um conjunto mais forte de regras operacionais. Isso importa quando o agente fica tentado a resolver problemas adjacentes, reescrever código ao redor ou adicionar polimento que nunca foi pedido.

A moyu-fr é amigável para iniciantes?

Sim, se o usuário conseguir descrever uma única mudança concreta. Ela é mais fácil de usar quando você consegue nomear o arquivo, o sintoma e o limite exato da edição. Iniciantes costumam ter mais dificuldade quando o pedido é amplo demais, e não porque a skill em si seja difícil.

Quando eu não devo usar a moyu-fr?

Não use quando você realmente precisar de refatoração, cobertura de testes, novas abstrações ou trabalho de endurecimento do sistema. Nesses casos, a contenção da skill pode ir contra o objetivo real e gerar uma saída tecnicamente mínima, mas incompleta.

Como melhorar a skill moyu-fr

Dê restrições mais apertadas desde o início

A melhor forma de melhorar a moyu-fr é dizer o que precisa ficar inalterado. Inclua nomes de arquivos, linhas-alvo e exclusões como “sem novas funções”, “sem comentários extras” ou “não toque na formatação fora deste bloco”. Essas restrições reduzem suposições e tornam o comportamento de edição mínima da skill mais confiável.

Peça o menor diff aceitável

Se você quer um resultado melhor de moyu-fr usage, descreva o sucesso em termos de diff:

• “Altere apenas uma condição de branch.”
• “Corrija a função existente em vez de criar um helper.”
• “Preserve a API pública atual.”

Isso diz ao agente como é o estado de “pronto” e evita aumento de escopo.

Fique atento aos modos de falha comuns

O principal modo de falha é a expansão acidental: validação extra, explicação extra ou limpeza que parece útil, mas altera mais do que foi pedido. Outro problema comum é subeditar quando o pedido realmente exige várias mudanças pequenas; nesse caso, especifique explicitamente o conjunto completo de edições necessárias para que a skill não pare cedo demais.

Itere com follow-ups mais estreitos

Se o primeiro resultado ainda estiver amplo demais, aperte a próxima instrução em vez de repetir o mesmo pedido. Por exemplo: “Mantenha a mesma lógica e ajuste apenas esta condição” é mais acionável do que “deixe menor”. Para a moyu-fr, entradas melhores geralmente significam menos graus de liberdade, não mais contexto.