moyu-ja

Visão geral da skill moyu-ja

moyu-ja é uma skill em japonês para edição de código que ajuda a IA a se manter estritamente mínima quando o pedido de mudança é bem delimitado. Ela é ideal para desenvolvedores que querem um diff pequeno e exato em vez de uma reescrita “prestativa”, especialmente quando já sabem o arquivo, a funcionalidade ou o intervalo de linhas de destino.

A verdadeira função da skill moyu-ja é controlar o escopo: editar só o que o usuário pediu, escolher a correção mais simples que funcione e parar quando a solicitação estiver ambígua ou puder se espalhar para arquivos não relacionados. Isso a torna útil para manutenção, correções de bugs e edições guiadas por revisão, em que o principal risco é o excesso de engenharia.

Seu diferencial principal é a contenção. A skill foi projetada para desencorajar abstrações extras, dependências extras, testes extras e documentação extra quando nada disso foi solicitado. Se você quer um modelo que preserve o design existente e mude o mínimo possível, moyu-ja é uma ótima escolha.

moyu-ja para edição de código

Use moyu-ja quando a tarefa for “mude isso, não aquilo”. Ela se encaixa em trabalhos de edição de código em que a saída mais segura é a menor possível: uma correção de uma linha, uma substituição pontual ou um patch restrito em um arquivo conhecido.

No que essa skill se destaca

• Manter as edições dentro do escopo informado pelo usuário
• Evitar refatorações desnecessárias e camadas extras de wrapper
• Preferir caminhos de código já existentes em vez de criar nova estrutura
• Pedir confirmação quando a solicitação estiver pouco especificada

Quando ela é uma má escolha

Se você quer limpeza arquitetural, refatoração ampla ou uma solução que reavalie o design ao redor, moyu-ja vai parecer conservadora demais. Ela não foi feita para pedidos do tipo “melhore o módulo inteiro enquanto estiver aí”.

Como usar a skill moyu-ja

Instale e ative moyu-ja

Instale a skill moyu-ja no seu ambiente de skills e depois invoque-a em tarefas de edição em que a contenção importa. Um comando típico de instalação neste repo é:

npx skills add uucz/moyu --skill moyu-ja

Use moyu-ja quando seu prompt contiver um pedido de edição claramente delimitado, como corrigir uma função, ajustar uma condição ou aplicar uma mudança mínima de comportamento.

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

O melhor uso de moyu-ja começa com um prompt que nomeia o alvo exato e o limite exato. Boas entradas dizem o que mudar, onde mudar e o que não pode mudar.

Padrão de prompt forte:

• “Em src/auth.ts, altere apenas a lógica de parsing do token. Não mexa na validação sem relação.”
• “Atualize este componente para lidar com entrada vazia, mas mantenha a estrutura atual e evite novos arquivos.”
• “Faça a menor correção possível para o caso com falha em PaymentForm; não adicione novas abstrações.”

Padrão de prompt fraco:

• “Melhore este código.”
• “Deixe mais limpo.”
• “Refatore este módulo.”

Leia a fonte na ordem certa

Para essa skill, comece com SKILL.md e depois inspecione a árvore do repo em busca de eventuais arquivos de orientação adjacentes vinculados ao repositório. Se o projeto incluir README.md, AGENTS.md, metadata.json ou pastas de suporte como rules/, resources/, references/ ou scripts/, leia essas partes apenas quando forem necessárias para esclarecer escopo e restrições.

O ponto principal é não superler. moyu-ja funciona melhor quando você identifica o mínimo de contexto necessário para editar com segurança e então para.

Fluxo de trabalho que traz melhores resultados

1. Identifique o arquivo exato e o comportamento a mudar.
2. Declare o resultado desejado em uma frase.
3. Acrescente restrições como “diff mínimo”, “sem novos arquivos” ou “sem nova dependência” quando isso importar.
4. Peça primeiro a menor correção aceitável.
5. Se o modelo fizer uma pergunta de esclarecimento, responda em vez de ampliar a tarefa.

Esse fluxo de trabalho combina com o guia moyu-ja: entrada precisa, escopo mínimo, sem adivinhação.

FAQ da skill moyu-ja

moyu-ja é só para fluxos de trabalho em japonês?

Não. O conteúdo da skill é japonês, mas o comportamento de edição que ela impõe é geral: manter o mínimo, manter o escopo e evitar mudanças desnecessárias. A skill moyu-ja continua útil mesmo se seu repositório e seus prompts estiverem em inglês.

Em que isso é diferente de um prompt normal?

Um prompt normal pode pedir edição cuidadosa, mas moyu-ja transforma essa disciplina no comportamento padrão. Isso importa quando o modelo é tentado a “ajudar” reescrevendo demais, adicionando abstrações ou mexendo em arquivos adjacentes.

moyu-ja é adequada para iniciantes?

Sim, se o objetivo for aprender a fazer edições menores e mais seguras. Ela é especialmente útil quando iniciantes tendem a corrigir demais o código ou a adicionar camadas extras que não são necessárias.

Quando não devo usar moyu-ja?

Não use moyu-ja quando a tarefa real for redesenho, limpeza em múltiplos arquivos ou uma rodada mais ampla de melhorias. Se você quer que o modelo reavalie a arquitetura, uma skill de programação mais expansiva é uma opção melhor.

Como melhorar a skill moyu-ja

Dê sinais de escopo mais precisos

A melhoria mais importante é especificar o limite da edição. Nomeie o arquivo, a função, o intervalo de linhas ou o comportamento exato. Quanto mais explícito for o limite, menor a chance de a skill extrapolar.

Declare as restrições que importam

Se você se importa em preservar o estilo de implementação, diga isso. Se não quer novas classes, novos helpers, novas dependências, comentários, testes ou documentação, diga isso diretamente. moyu-ja é mais forte quando o prompt transforma a regra de “fazer menos” em algo concreto.

Peça a menor correção aceitável

Um ciclo de melhoria útil com moyu-ja é pedir primeiro o patch mínimo viável e só expandir se ele falhar. Por exemplo, comece com “corrija este bug com o menor diff possível” e depois itere apenas se a primeira resposta não atender a um requisito real.

Fique atento aos modos de falha por excesso de engenharia

O principal modo de falha que essa skill foi criada para evitar é o escopo inchando: arquivos não relacionados sendo alterados, abstrações sendo adicionadas para uma correção pontual ou código defensivo sendo introduzido para cenários que o usuário nunca pediu. Se isso acontecer, restrinja o prompt ao ajuste exato e reafirme a proibição de trabalho extra.