moyu

Visão geral do skill moyu

O que o skill moyu faz

O skill moyu funciona como uma barreira de edição para mudanças em código: ele orienta o modelo a manter-se dentro do escopo pedido pelo usuário, evitar abstrações desnecessárias e preferir o menor diff seguro possível. Se você quer um skill para Code Editing que resista ao excesso de engenharia, moyu foi criado exatamente para isso.

Quem deve usá-lo

Use o skill moyu quando a precisão importa mais do que a completude: corrigir um bug, alterar um arquivo, enxugar um diff ou responder a um pedido do tipo “por favor, toque só em X”. Ele é especialmente útil para revisores, mantenedores e agentes trabalhando em bases de código já consolidadas, onde limpeza extra pode aumentar o risco.

Por que ele se destaca

O grande diferencial é o viés forte para a contenção. O skill desencoraja explicitamente novas dependências, reescritas amplas, validações extras, testes, comentários e camadas auxiliares, a menos que o usuário tenha pedido isso. Isso torna o moyu muito forte para edições do mundo real, em que o perigo não é deixar uma funcionalidade passar, mas mudar coisa demais.

Como usar o skill moyu

Instale e ative o moyu

Instale o skill moyu no diretório de skills do seu agente e garanta que seu fluxo de trabalho de código o carregue antes da edição. Uma instalação típica fica assim: npx skills add uucz/moyu --skill moyu. Para melhores resultados, ative-o em tarefas em que o prompt já sinaliza contenção, como “atualize apenas esta função” ou “mantenha a mudança mínima”.

Dê ao skill um briefing restrito

O skill moyu funciona melhor quando seu prompt nomeia exatamente o arquivo, a função, o comportamento ou a saída que precisa mudar. Entradas fortes parecem com: “Em src/auth.ts, corrija apenas o bug de refresh do token; não refatore nem adicione novos arquivos.” Pedidos fracos como “melhore a autenticação” deixam espaço demais para expansão e anulam o propósito de usar o moyu.

Leia os arquivos certos primeiro

Comece por SKILL.md, depois inspecione os arquivos que você realmente pretende editar e qualquer contexto próximo que explique convenções locais. Como este repositório é propositalmente enxuto, não há scripts extras nem diretórios de suporte para orientar você; o valor central está no próprio texto do skill. Isso significa que o melhor fluxo é: ler o skill, definir a menor superfície editável e então executar.

Trabalhe do jeito que o moyu espera

Ao usar o moyu para Code Editing, peça primeiro a correção mínima e só itere se o resultado ainda não atingir o alvo. Se precisar ampliar a mudança, faça isso em uma segunda solicitação, em vez de expandir a primeira. Isso mantém os diffs pequenos, facilita a revisão e se alinha à regra do skill de “mudar apenas o que foi pedido”.

FAQ do skill moyu

O moyu é um assistente de programação completo?

Não. O skill moyu não foi feito para maximizar amplitude; ele existe para limitar escopo e evitar edições desnecessárias. Se você quer refatoração ampla, scaffolding ou ajuda de arquitetura, um prompt geral de programação pode ser mais adequado do que o skill moyu.

Quando eu não deveria usar o moyu?

Não use o moyu quando a tarefa realmente exigir coordenação entre vários arquivos, novas abstrações ou limpeza sistêmica. Se o trabalho é “deixar a arquitetura mais limpa” ou “adicionar a suíte de testes que está faltando”, a contenção do skill pode virar limitação, não benefício.

O moyu é bom para iniciantes?

Sim, se a pessoa iniciante quer edições mais seguras e menos mudanças-surpresa. O guia do moyu é especialmente útil para quem tende a pedir demais ao modelo ou aceitar diffs grandes demais. Ele ensina um padrão valioso: peça a menor mudança que resolva o problema.

Qual é a diferença em relação a apenas dizer ao modelo para ter cuidado?

Um prompt comum pode pedir cautela, mas o skill moyu incorpora essa preferência como uma política de edição reutilizável. Isso faz diferença quando você precisa repetidamente de comportamento de diff mínimo em várias tarefas, e não só em prompts pontuais.

Como melhorar o skill moyu

Deixe o pedido menor e mais explícito

A forma mais eficaz de melhorar a saída do moyu é remover ambiguidades antes da primeira edição. Inclua o caminho exato do arquivo, o comportamento exato que deve ser preservado e a mudança exata que você quer. Por exemplo: “Edite apenas components/Button.tsx; mantenha os props inalterados; corrija só o estilo de disabled.”

Diga o que não pode mudar

O skill fica mais forte quando você diz claramente o que deve ficar intocado. Mencione coisas como “sem novos arquivos”, “sem novas dependências”, “não altere a forma da API” ou “não reescreva a função inteira”. Isso ajuda o moyu a ficar alinhado com a intenção real do usuário, em vez de otimizar para uma melhoria mais ampla, porém indesejada.

Revise o primeiro diff e depois aperte o cerco

Se o primeiro resultado ainda estiver grande demais, devolva as partes excessivas e peça uma passagem mais restrita. Modos de falha comuns são limpeza extra, abstrações adicionadas ou código defensivo que não foi solicitado. O melhor fluxo com o moyu é iterativo: restringir, revisar e enxugar de novo até o diff corresponder ao pedido.