moyu-ko

Visão geral da skill moyu-ko

Para que serve o moyu-ko

moyu-ko é uma skill de edição de código criada para impedir o overengineering antes mesmo que ele comece. Ela ajuda a IA a fazer a menor alteração correta, manter-se dentro do escopo pedido pelo usuário e evitar adicionar abstrações, testes, documentação ou dependências extras, a menos que isso tenha sido solicitado.

Quem deve instalar

Instale a moyu-ko skill se você costuma querer que a IA aplique correções em código existente, resolva um bug pontual ou faça uma mudança mínima sem reescrever tudo. Ela é uma ótima opção para equipes que valorizam diffs precisos, revisão mais rápida e baixa rotatividade na implementação.

O que a diferencia

Diferentemente de um prompt genérico que só diz “seja conciso”, moyu-ko codifica guardrails explícitos: editar apenas os arquivos solicitados, preferir a implementação mais simples e parar para perguntar quando o pedido estiver अस्पष्ट. Isso a torna especialmente útil como moyu-ko para Code Editing quando controlar o escopo importa mais do que refatorar de forma ampla.

Como usar a skill moyu-ko

Instale e ative

Use o fluxo padrão de instalação do diretório para a etapa de moyu-ko install e, depois, invoque a skill em uma tarefa que seja claramente um pedido de edição de código. Um bom gatilho é algo como: “Use moyu-ko para fazer apenas a menor alteração necessária para corrigir este bug em src/auth.ts.”

Dê uma tarefa bem delimitada à skill

O padrão de moyu-ko usage funciona melhor quando você especifica:

• o(s) arquivo(s) ou caminho(s) exato(s) a tocar
• a mudança de comportamento desejada
• o que não pode mudar
• quaisquer restrições conhecidas, como “sem novas dependências” ou “não adicionar testes”

Entrada mais forte:

Atualize src/cart.ts para que o desconto só se aplique a usuários logados. Não altere outras regras de preço nem crie novos arquivos.

Entrada mais fraca:

Melhore o fluxo de checkout.

Leia os arquivos certos primeiro

Para um fluxo de trabalho mais rápido com o moyu-ko guide, comece por SKILL.md e depois inspecione os arquivos que definem a superfície da mudança no seu repositório. Como este repositório de skill é propositalmente pequeno, o principal valor está em entender as regras de comportamento, não em sair procurando pastas de suporte extras.

Peça diffs mínimos

Quando quiser que a skill responda bem, peça explicitamente a menor edição possível e mencione qualquer limite rígido. Por exemplo:

Use moyu-ko para corrigir api.ts. Altere apenas a ramificação de validação, evite novos helpers e pergunte antes de tocar em qualquer outro arquivo.

FAQ da skill moyu-ko

O moyu-ko é só para edição de código?

Sim, esse é o uso previsto. A moyu-ko skill foi feita para edição disciplinada, não para planejamento amplo, trabalho de arquitetura ou scaffolding do zero. Se você precisa de um redesign, um prompt normal pode ser mais adequado.

Quando eu não devo usar o moyu-ko?

Não use moyu-ko quando você realmente quer que a IA explore várias abordagens, adicione testes de suporte ou limpe código adjacente como parte da tarefa. O valor dele está no controle de escopo, então pode ser uma escolha ruim para refatorações abertas.

Ela é amigável para iniciantes?

Sim, desde que você consiga descrever a mudança com clareza. As regras da skill são simples, mas ela funciona melhor quando o pedido já vem com limites. Iniciantes tendem a ter os melhores resultados quando informam o arquivo, o comportamento e a lista do que “não mexer”.

Em que ela difere de um prompt normal?

Um prompt normal pode pedir mudanças mínimas, mas moyu-ko faz disso o modo padrão de operação. Isso reduz a chance de reescritas acidentais, abstrações extras ou arquivos adicionais quando você queria apenas uma edição focada.

Como melhorar a skill moyu-ko

Dê instruções de escopo mais apertadas

O maior ganho de qualidade vem de reduzir a superfície de edição. Informe o arquivo exato, a menor parte a alterar e o resultado esperado. Quanto mais preciso for o pedido, menor a chance de moyu-ko travar pedindo esclarecimento ou editar além do necessário.

Inclua limites explícitos

Se algo precisa permanecer intocado, diga isso. Limites úteis incluem:

• “sem novas funções auxiliares”
• “sem novas dependências”
• “não altere APIs públicas”
• “mantenha o diff abaixo de 10 linhas, se possível”

Essas restrições ajudam moyu-ko for Code Editing a produzir uma saída mais fácil de revisar.

Espere perguntas quando a tarefa estiver ambígua

Um modo comum de falha é especificar pouco o alvo e esperar que o modelo deduza o resto. Se o pedido puder afetar outros arquivos ou exigir uma nova abstração, moyu-ko deve pausar e perguntar. Isso é uma funcionalidade, não um defeito.

Itere no primeiro patch, não no plano inteiro

Se a primeira saída vier ampla demais, aperte a instrução seguinte em vez de ampliar a tarefa. Por exemplo, peça “só a linha que faz o parse da entrada” em vez de “limpe o módulo”. Isso mantém o moyu-ko usage alinhado com o design de mudança mínima.