pua

Visão geral da skill pua

O que a pua realmente faz

A pua skill é uma camada de tom e comportamento para o trabalho de agentes: ela empurra o modelo para um estilo de execução de alta pressão e alta autonomia quando a sessão mostra frustração, falhas repetidas, passividade ou entregas de baixa qualidade. Na prática, a pua tem menos a ver com adicionar novas ferramentas e mais com mudar a forma como um agente planeja, verifica, escala problemas e se comunica enquanto trabalha.

Para quem a pua é indicada

A pua é indicada para usuários que querem mais capacidade de execução em fluxos de coding, debugging, deployment ou research e que se sentem confortáveis com uma voz agressiva, em estilo de gestão. Ela funciona melhor para operadores que já conhecem seu ambiente e querem que o agente pare de enrolar, investigue mais a fundo, valide mais e feche os ciclos de forma proativa.

O problema real que a pua resolve

A maioria das pessoas que considera usar pua não está procurando entretenimento; quer um agente que não desista cedo, que não pare na primeira resposta plausível e que não declare conclusão sem evidência. A skill foi feita para cenários de “tenta mais”, “verifica melhor” e “assume a responsabilidade pelo resultado”.

O que diferencia a pua de um prompt comum

Um prompt comum pode pedir rigor uma vez. A pua adiciona um padrão operacional reutilizável: escalonamento diante de falhas, voz de liderança baseada em flavor, roteamento de metodologia por tipo de tarefa, convenções de exibição e memória basal opcional de longo prazo via ~/.pua/evolution.md. Isso dá mais estrutura do que uma instrução solta do tipo “seja mais proativo”.

Principais trade-offs antes de instalar

O maior benefício de pua for Workflow Automation é aumentar a pressão por conclusão e validação. O principal custo está no tom: esta pua skill é intencionalmente dura, carregada de papel e culturalmente estilizada. Se você quer pair programming calmo, orientação amigável para iniciantes ou linguagem corporativa neutra, provavelmente não é uma boa opção.

Como usar a skill pua

Onde a pua entra no seu fluxo de trabalho

Use a pua como um modificador de sessão quando o agente estiver travado, entregando abaixo do esperado ou passivo demais. Ela é mais útil depois de falhas repetidas, reclamações de qualidade ou feedbacks vagos como “isso não está bom o suficiente”, porque o repositório coloca esses gatilhos no centro do funcionamento.

O que ler primeiro antes de adotar a pua

Comece por skills/pua/SKILL.md para entender a lógica de gatilhos, a troca de flavor e o roteamento por tipo de tarefa. Depois leia skills/pua/references/display-protocol.md para o formato de saída, skills/pua/references/methodology-router.md para o mapeamento entre tarefa e método, e skills/pua/references/flavors.md se você se importa mais com personalização de tom do que com pressão bruta de execução.

Os arquivos de apoio mais importantes da pua

Se você pretende usar pua skill de forma séria, os arquivos mais relevantes para a decisão são:

• skills/pua/references/agent-team.md para regras de delegação em multiagentes
• skills/pua/references/evolution-protocol.md para comportamento basal persistente
• skills/pua/references/p7-protocol.md, skills/pua/references/p9-protocol.md e skills/pua/references/p10-protocol.md para caminhos de escalonamento
• os arquivos de metodologia, como skills/pua/references/methodology-alibaba.md e skills/pua/references/methodology-huawei.md, para restrições de estilo de execução

Como a pua é acionada na prática

As evidências no repositório mostram que a pua foi feita para ativar com sinais como falhas repetidas, “stop spinning”, “you broke it”, “why does this still not work”, /pua e linguagem semelhante de frustração. Isso significa que o uso da pua não é simplesmente “ative para toda tarefa”; ela é mais forte quando a conversa ao redor já indica perda de ritmo ou falta de senso de dono.

Que tipo de entrada a pua precisa para funcionar bem

A pua funciona melhor quando seu pedido inclui:

• a tarefa exata e a definição de concluído
• o que já falhou e quantas vezes
• restrições atuais, como repo, branch, runtime ou permissões
• o que conta como prova, como build, test, curl, screenshots ou diffs
• se você quer execução solo ou decomposição em multiagentes

Sem esse contexto, a skill pode aumentar a pressão e a verbosidade sem melhorar os resultados.

Como escrever um prompt de pua melhor

Um prompt fraco é: “Use pua and fix this.”
Um prompt mais forte, no estilo pua guide, é: “Use pua on this failing API route. We already tried two fixes and both broke auth. Root-cause it, verify with the project test command, check similar routes for the same defect class, and do not mark done without evidence.”

Esse prompt funciona melhor porque traz histórico de falhas, escopo, comportamento esperado e requisitos de validação — exatamente os elementos que esta skill foi feita para impor.

Como transformar um objetivo vago em uso eficaz da pua

Se o seu objetivo inicial é “fazer o deployment funcionar”, converta isso em:

1. ambiente-alvo e sintoma da falha
2. tentativas já feitas
3. limites que você não pode mudar
4. prova de sucesso
5. se o agente deve inspecionar riscos adjacentes

Isso importa porque a pua recompensa explicitamente um fechamento mais amplo, como verificar módulos semelhantes e impactos downstream, e não apenas corrigir o primeiro problema visível.

Como a pua roteia por tipo de tarefa

A skill tem opiniões claras sobre seleção de metodologia. Tarefas de debug tendem a seguir análise de causa raiz e raciocínio adversarial; trabalho de feature tende para simplificação e pressão por entrega; revisão muda o foco para critério e redução. Esse roteamento é uma das partes mais úteis e menos óbvias do repo, porque dá um motivo concreto para instalar pua em vez de reaproveitar um prompt genérico do tipo “seja mais rígido”.

Como o modelo de equipe muda o uso da pua

pua for Workflow Automation fica mais interessante se você trabalha com setups multiagente. O repo inclui um modelo de equipe em quatro camadas, de P10 a P7, com orientação clara de delegação sobre quando o P8 deve executar diretamente e quando deve criar subagentes no estilo P7. Se você só usa um único assistente em uma caixa de chat, essa parte é menos relevante.

Quais sinais de qualidade a pua espera antes de concluir

A skill puxa fortemente para fechamento observável: build/test passando, health checks, verificação direta e varredura de impacto. Se o seu ambiente não consegue executar comandos nem expor evidências, espere menos valor da pua, porque boa parte da disciplina dela vem justamente de se recusar a marcar algo como “done” sem ciclo fechado.

Observações práticas de setup para decidir instalar a pua

Não há um comando de instalação claramente exposto em SKILL.md, então sua decisão de pua install deve se basear menos em mecânica de pacote e mais em saber se o seu host suporta carregamento de skills e estado opcional em nível de usuário em ~/.pua/config.json e ~/.pua/evolution.md. Se a sua plataforma não consegue injetar estado de sessão nem persistir arquivos locais, parte do comportamento avançado da pua não vai se materializar.

FAQ da skill pua

A pua é uma boa opção para iniciantes?

Em geral, não. A pua skill parte do pressuposto de que você tolera linguagem mais crítica e sabe interpretar instruções de maior pressão. Iniciantes normalmente precisam mais de clareza e estrutura guiada do que de pressão.

A pua é só sobre tom?

Não. O tom é a parte visível, mas o valor mais profundo está na disciplina de execução: roteamento de metodologia, limiares de escalonamento, pressão por validação e protocolos explícitos de equipe. Se você tira o modelo de comportamento e mantém só a voz, perde a maior parte do valor prático.

Quando eu não devo usar a pua?

Não use pua em contextos emocionais sensíveis, coaching mais cuidadoso, textos de suporte voltados ao usuário final ou times que precisem de comunicação neutra. Também vale pular quando a tarefa é pequena e já está bem delimitada; o framework pode ser mais pesado do que o trabalho.

Em que a pua é diferente de dizer para um modelo “try harder”?

Uma instrução genérica como “try harder” aumenta a intensidade, mas normalmente não define como escolher métodos, quando escalar, que evidências coletar nem como coordenar subagentes. pua usage é mais estruturado do que isso, especialmente se você realmente ler os protocolos de referência.

A pua ajuda só com coding?

Não. O repositório descreve casos de uso em código, config, debug, deploy e research. Ainda assim, ela convence mais quando a tarefa tem verificações objetivas, porque é aí que a mentalidade de fechamento se torna mensurável.

Posso usar a pua sem os flavor packs em estilo corporativo?

Parcialmente. Você pode ignorar a maior parte do material de flavor e ainda se beneficiar das ideias de workflow. Mas a skill foi construída profundamente em torno da escolha de flavor, então usuários que não gostam desse enquadramento talvez prefiram extrair os protocolos em vez de adotar a pua skill completa como está.

Como melhorar a skill pua

Dê à pua uma definição de concluído mais precisa

A forma mais rápida de melhorar os resultados com pua é especificar a conclusão em termos mensuráveis. Bons exemplos: “tests pass”, “endpoint returns 200”, “migration is reversible” ou “scan similar handlers for the same bug pattern”. Isso se alinha ao viés embutido da skill em direção a validação e fechamento mais amplo.

Informe o histórico de falhas, não só o problema atual

Como a pua é sensível a gatilhos, ela fica mais útil quando você explica o que já falhou. “This is the third attempt”, “the last patch broke auth” ou “the issue reproduces only in staging” dão à skill uma base melhor para escalonamento e seleção de hipóteses.

Use o arquivo de referência certo para o trabalho

Não leia todas as referências sempre. Para debugging, priorize o roteamento de metodologia e as referências ligadas à validação. Para trabalho multiagente, vá direto para skills/pua/references/agent-team.md. Para ajuste de tom, use skills/pua/references/flavors.md. Para workflows pessoais de longa duração, consulte skills/pua/references/evolution-protocol.md.

Peça saídas ricas em evidência, não só confiança

Um modo comum de falha é receber linguagem de alta pressão sem melhora real na qualidade do raciocínio. Evite isso pedindo comandos executados, hipóteses descartadas, arquivos verificados e varreduras de risco adjacente. Isso força a pua skill a mostrar trabalho visível em vez de apenas narrar mais alto.

Mantenha a pua enxuta quando a tarefa for pequena

Outro modo de falha é processar demais um trabalho simples. Para uma correção de uma linha ou uma edição trivial, peça a disciplina da pua sem banners completos, roleplay ou estrutura de equipe. O próprio repo diferencia a densidade de saída conforme a complexidade da tarefa, e seguir isso ajuda a manter a skill útil em vez de teatral.

Itere depois da primeira saída da pua

Se a primeira resposta estiver performática demais, refine a instrução: peça menos slogans, mais análise de causa raiz, validação mais forte ou comparação explícita entre alternativas. Se estiver estreita demais, peça para inspecionar módulos semelhantes, efeitos upstream/downstream e edge cases faltantes — o tipo de pensamento “iceberg under the iceberg” que a skill promove.

Personalize a pua para o seu ambiente

O repositório sugere configuração local via ~/.pua/config.json e estado basal persistente via ~/.pua/evolution.md. Se o seu host suportar isso, defina o flavor preferido e preserve padrões de validação que já funcionaram. Isso torna pua for Workflow Automation mais consistente entre sessões, em vez de recomeçar do zero toda vez.

Entenda a pergunta central de adoção da pua

A pergunta real de instalação não é “A pua é esperta?”, e sim “Isso vai tornar meu agente mensuravelmente mais responsável no meu workflow?”. Se você precisa de mais senso de dono, verificação mais sistemática e melhor disciplina de escalonamento, pua tem estrutura real por trás. Se o que você quer principalmente é um companheiro de coding agradável, escolha algo mais leve.