O que legacy-support-adjudication-skill faz?
Uma habilidade profissional para agentes de revisão de código que precisam decidir se a lógica de compatibilidade reversa ainda é necessária ou se tornou dívida técnica removível.
Visão Geral
Esta habilidade permite que um agente de revisão de código avalie se trechos de código legado, originalmente introduzidos para manter compatibilidade reversa, ainda são relevantes. O agente analisa fatores como versões mínimas suportadas, deprecações, padrões de uso e histórico de alterações para recomendar a remoção ou manutenção dessas lógicas.
Como Funciona
O agente segue um processo estruturado:
- Identificação: Localiza trechos de código marcados com comentários ou padrões típicos de compatibilidade reversa (e.g.,
if (version < X)ou@deprecated). - Análise: Verifica a versão mínima atualmente suportada, datas de deprecação, e se a lógica ainda é acionada em cenários comuns.
- Decisão: Recomenda remover a lógica se as condições de compatibilidade não forem mais aplicáveis, ou mantê-la se ainda houver risco de quebra.
- Documentação: Gera um relatório com as decisões e justificativas.
Plataformas Suportadas
- Claude Code
- Cursor
- Codex
- Qualquer agente que suporte SKILL.md
Exemplo de Uso
# O agente pode ser invocado com:
review-legacy-support --path /src/legacy
Heurísticas Principais
| Condição | Ação Recomendada |
|---|---|
| Versão mínima suportada é maior que a versão alvo da lógica | Remover |
| Lógica está deprecated há mais de 2 versões | Remover |
| Uso da lógica é raro ou inexistente em logs | Remover |
| Lógica é necessária para cenários de downgrade | Manter |
Limitações
- Esta habilidade não modifica o código automaticamente; apenas fornece recomendações.
- A precisão depende da qualidade dos metadados de versão e deprecação no código.
Contribuição
Contribuições são bem-vindas! Envie PRs para melhorar heurísticas ou adicionar suporte a novas plataformas.
Licença
MIT