O que skillrace faz?
Execução Concolica Aumentada por Raciocínio para Habilidades de Agentes de Codificação
Esta habilidade implementa uma técnica de execução concolica que combina raciocínio simbólico com execução concreta para melhorar a análise de código por agentes de IA. Ela permite que o agente explore múltiplos caminhos de execução simultaneamente, identificando bugs, inconsistências e comportamentos inesperados com maior profundidade.
A execução concolica funciona mantendo tanto valores concretos quanto restrições simbólicas para variáveis, permitindo que o agente raciocine sobre condições complexas e gere entradas de teste que cubram cenários críticos. O componente de 'raciocínio' destila as intenções do código-fonte em heurísticas que guiam a exploração dos caminhos, evitando explosão de estados e focando nas áreas mais relevantes.
Para usar o skillrace, basta integrar a habilidade ao seu agente de codificação (como Claude Code, Cursor ou Codex) e invocar o comando apropriado com o caminho do código a ser analisado. A ferramenta então instrumentará o código, executará com valores simbólicos e concretos, e reportará os resultados em formato estruturado.
Exemplo de uso:
skillrace analyze --target ./src/module.js --depth 5
Opções principais:
--target: Caminho para o arquivo ou diretório a ser analisado--depth: Profundidade máxima de exploração de caminhos (padrão: 3)--raciocinar: Ativa heurísticas de raciocínio para guiar a execução--saida: Formato do relatório (json, texto)
Plataformas suportadas:
- Claude Code
- Cursor
- Codex (OpenAI)
- Qualquer agente compatível com execução de código assistida
Como funciona:
- O código-alvo é instrumentado com ganchos que monitoram variáveis e condições.
- Durante a execução concreta, restrições simbólicas são coletadas para ramos condicionais.
- O módulo de raciocínio analisa as restrições e gera novos valores de entrada para explorar caminhos não cobertos.
- Os resultados (caminhos explorados, bugs encontrados, cobertura) são consolidados em um relatório.
Contribuições: Sinta-se à vontade para abrir issues ou pull requests no repositório oficial para melhorias, correções ou novas funcionalidades.
Licença: MIT