CommunityPesquisa e Análise de Dadosgithub.com

CodeSigils/py-review-skill

Habilidades portáteis de revisão de código Python para agentes compatíveis com agentskills.io — roteador mais habilidades focadas em segurança de tipos, tratamento de erros, antipadrões, async e estilo de código.

O que é py-review-skill?

Esta habilidade fornece um sistema de revisão de código Python modular e portátil, projetado para agentes compatíveis com agentskills.io. Ela inclui um roteador principal que orienta a revisão com base no contexto do projeto, como versão do Python, maturidade e ferramentas configuradas (pyright, ruff, etc.), e então carrega a habilidade focada mais adequada para revisar mudanças em áreas como segurança de tipos, tratamento de erros, antipadrões, padrões assíncronos e estilo de código. Isso garante que o agente gaste esforço de revisão apenas onde é mais relevante e impactante. O sistema funciona em qualquer plataforma que suporte agentes dinâmicos (como Claude Code, Cursor ou Codex) e é altamente adaptável, capaz de sugerir correções com base em evidências locais do código alterado, citando arquivo e linha para cada achado.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add CodeSigils/py-review-skill

Installed? Explore more Pesquisa e Análise de Dados skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Roteador de Revisão Python

Use esta habilidade primeiro para revisão de código Python. Oriente-se no contexto e, em seguida, carregue apenas as habilidades focadas que correspondem ao código alterado.

Antes de Revisar: Orientação

  1. Verifique a versão do Python a partir de pyproject.toml, setup.cfg, tox.ini, CI ou README.

    • Se >=3.10: carregue todas as habilidades principais relevantes, mas aplique cada regra apenas quando sua ressalva de Python/ferramenta corresponder.
    • Se 3.8-3.9: pule regras de sintaxe que exigem >=3.10.
    • Se desconhecido: assuma mínimo 3.10, mas formule achados sensíveis à versão de forma conservadora.
  2. Classifique a maturidade do projeto.

    • Ativo/greenfield: conjunto completo de regras é apropriado.
    • Legado maduro/manutenção apenas: priorize achados CRÍTICOS e ALTOS.
    • Automação/scripts: priorize segurança, correção, gerenciamento de recursos e erros claros.
  3. Verifique a cadeia de ferramentas.

    • Se o projeto usa pyright, não recomende configuração específica do mypy.
    • Se o projeto usa ruff, delegue achados de estilo/importação à sua configuração.
    • Se nenhuma ferramenta estiver configurada, faça sugestões de ferramentas com baixa severidade, a menos que o problema esteja relacionado à correção.
  4. Leia os arquivos exatos alterados antes de sinalizar problemas.

    • Cite arquivo e linha para cada achado.
    • Não emita achados genéricos sem evidência local.
    • Uma correspondência de regra é um sinal, não um veredito.

Roteamento

O código alterado toca...CarregarPular quando...
anotações, Any, casts, genéricos, protocolos, APIs públicaspy-type-safetya alteração é trivial e não tem superfície tipada
exceções, validação, limpeza, repetições, falhas em lotepy-error-handlingnenhum caminho de falha foi alterado
padrões, configuração, uso de recursos, limites ORM/API, lógica de I/O e negócios misturadapy-anti-patternsa alteração é apenas documentação/configuração
async def, loops de eventos, FastAPI/httpx/aio*, tarefas, cancelamentopy-async-patternso projeto/alteração é síncrono
formatação, nomes, importações, docstrings, configuração de lint/tipopy-code-stylea saída da ferramenta já cobre ou a revisão solicitou apenas correção

Nota de Portabilidade

A coluna "Carregar" informa quais regras da habilidade focada aplicar para cada tipo de alteração. Como você acessa essas regras depende do runtime do seu agente:

  • Carregamento dinâmico: Se seu agente suporta ativar habilidades no meio da sessão, torne a habilidade nomeada descoberta e ative-a quando a tabela de roteamento sinalizar seu escopo.
  • Checklist estático: Leia o arquivo SKILL.md da habilidade focada diretamente do diretório de habilidades e aplique suas regras como uma checklist de revisão.

Ambas as abordagens produzem o mesmo resultado de revisão. A tabela de roteamento é a árvore de decisão; a habilidade focada fornece o conjunto de regras.

Saída da Revisão

Lidere com bugs e riscos comportamentais. Mantenha achados apenas de estilo atrás de achados de correção. Para código legado, prefira problemas acionáveis de alto impacto em vez de conselhos amplos de modernização.

Habilidades Relacionadas