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
-
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.
- Se
-
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.
-
Verifique a cadeia de ferramentas.
- Se o projeto usa
pyright, não recomende configuração específica domypy. - 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.
- Se o projeto usa
-
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... | Carregar | Pular quando... |
|---|---|---|
anotações, Any, casts, genéricos, protocolos, APIs públicas | py-type-safety | a alteração é trivial e não tem superfície tipada |
| exceções, validação, limpeza, repetições, falhas em lote | py-error-handling | nenhum caminho de falha foi alterado |
| padrões, configuração, uso de recursos, limites ORM/API, lógica de I/O e negócios misturada | py-anti-patterns | a alteração é apenas documentação/configuração |
async def, loops de eventos, FastAPI/httpx/aio*, tarefas, cancelamento | py-async-patterns | o projeto/alteração é síncrono |
| formatação, nomes, importações, docstrings, configuração de lint/tipo | py-code-style | a 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.mdda 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.