Sobre o projeto

# Habilidade PUA — Habilidade de Agente de Codificação de IA de Alta Proatividade Este é um plugin de habilidade para agentes de codificação de IA (como Claude Code, OpenAI Codex CLI, etc.) que usa táticas de gestão de desempenho simuladas de empresas de tecnologia (como Alibaba, ByteDance, Huawei, Amazon, Google, etc.) — versão chinesa como PUA, versão inglesa como PIP — para forçar a IA a esgotar todas as soluções possíveis ao encontrar problemas, em vez de desistir facilmente ou transferir a culpa. ## Principais Funcionalidades - **Táticas PUA**: Faz a IA temer desistir e continuar tentando - **Metodologia de Depuração**: Dá à IA a capacidade de não desistir, fornecendo etapas sistemáticas de solução de problemas - **Imposição de Proatividade**: Faz a IA investigar problemas ativamente, em vez de esperar passivamente por instruções ## Plataformas Suportadas Suporta Claude Code, OpenAI Codex CLI, pi coding agent, Trae, Cursor, Kiro, CodeBuddy, OpenClaw, Google Antigravity, OpenCode, VSCode (GitHub Copilot), entre outros. ## Versões em Vários Idiomas Oferece versões em chinês (padrão), inglês (versão PIP) e japonês, cada uma com arquivos de habilidade independentes e culturalmente adaptados. ## Métodos de Instalação ### Vercel Skills CLI (Geral) ```bash npx skills add tanweai/pua --skill pua-en ``` ### Claude Code Suporta instalação via mercado ou instalação manual a partir do código-fonte do desenvolvedor, exigindo registro manual do plugin. ### OpenAI Codex CLI Recomenda-se instalação com um clique (git clone + symlink), com suporte a atualizações via git pull. ### Outras Plataformas Cada plataforma tem instruções de instalação correspondentes, como arquivos de regras .mdc para Cursor e arquivos de instrução para VSCode Copilot. ## Cenários de Uso Adequado para todos os tipos de tarefas, como depuração, implementação, configuração, implantação, operação, integração de API, processamento de dados, etc. É acionado quando a IA apresenta os seguintes padrões de preguiça: - Transferir problemas para o usuário ("verifique...", "sugiro fazer manualmente...") - Ajustar repetidamente o mesmo código/parâmetros sem gerar novas informações - Pular a verificação e alegar conclusão diretamente - Dar apenas sugestões sem fornecer código/comandos - Esperar passivamente por instruções do usuário ## Testes de Referência No teste de persistência de depuração (6 cenários), o uso desta habilidade aumentou o número de chamadas de ferramentas em 56%-100% e a quantidade de problemas encontrados em 50%. Por exemplo, no cenário de revisão de configuração, sem a habilidade, erros de configuração do Redis e riscos de segurança de curinga CORS foram omitidos; com ela, esses problemas foram identificados por meio de listas de verificação proativas. ## Aviso Declaração oficial: nem todos os modelos passaram no teste, e ainda não foi estabelecido um aumento de produtividade por meio desta avaliação.