python-anti-patterns

Visão geral

O que é python-anti-patterns?

python-anti-patterns é uma skill prática criada para ajudar desenvolvedores e equipes Python a identificar e evitar erros comuns de codificação. Ela oferece uma lista de verificação dos anti-padrões frequentes encontrados em bases de código Python, facilitando a identificação de problemas antes que cheguem à produção. Esta skill é especialmente útil para revisões de código, depuração, refatoração de código legado e para estabelecer padrões de codificação na equipe.

Quem deve usar esta skill?

• Desenvolvedores Python que desejam melhorar a qualidade do código
• Equipes que realizam revisões de código ou refatoração
• Educadores que ensinam boas práticas em Python
• Qualquer pessoa que mantenha ou depure projetos em Python

Problemas resolvidos pelo python-anti-patterns

• Reduz a dívida técnica ao destacar práticas inadequadas
• Ajuda a prevenir bugs sutis causados por erros comuns
• Facilita a revisão de código com uma lista de verificação pronta
• Apoia a integração de novos membros ao esclarecer o que evitar no código Python

Como usar

Passos para instalação

1. Instale a skill usando o comando abaixo:

   npx skills add https://github.com/wshobson/agents --skill python-anti-patterns
   

2. Após a instalação, comece revisando o arquivo SKILL.md para acessar a lista completa de anti-padrões em Python.

Revisando e aplicando a lista de verificação

• Utilize a lista durante as revisões de código para identificar problemas precocemente.
• Consulte os exemplos fornecidos para cada anti-padrão, como evitar lógica dispersa de timeout/retry e cenários de retry duplo.
• Centralize o tratamento de erros e a lógica de retry conforme recomendado para melhorar a manutenibilidade.

Adaptando ao seu fluxo de trabalho

• Integre a lista de verificação ao processo de revisão de código da sua equipe.
• Use como recurso didático para a integração de novos desenvolvedores.
• Aplique as recomendações ao refatorar ou depurar código existente.

Arquivos sugeridos para explorar

• SKILL.md: Lista principal e orientações de uso
• Skills relacionadas: Para padrões positivos, consulte python-design-patterns

Perguntas frequentes

Quando devo usar o python-anti-patterns?

Use esta skill antes de mesclar código, ao depurar bugs difíceis de encontrar ou ao refatorar código legado em Python. Também é útil para ensinar boas práticas e definir padrões na equipe.

Quais tipos de anti-padrões são abordados?

A skill cobre problemas como lógica duplicada de timeout/retry, retry duplo em múltiplas camadas e outras armadilhas comuns que podem causar bugs ou dificultar a manutenção.

Posso usar esta skill em qualquer projeto Python?

Sim, python-anti-patterns é agnóstico dentro do ecossistema Python e pode ser aplicado a qualquer base de código Python.

Esta skill substitui orientações positivas de design?

Não, python-anti-patterns foca no que evitar. Para padrões recomendados e arquitetura, consulte a skill python-design-patterns.

Onde posso encontrar mais detalhes ou exemplos?

Abra a aba Files para explorar toda a árvore de arquivos, incluindo o SKILL.md com listas detalhadas e exemplos de código.