O que skills-flow faz?
Gradiente descendente para habilidades de agente. Um ciclo executar→avaliar→refinar no estilo de aprendizado de máquina que treina um SKILL.md + scripts em cenários rotulados até atingir uma taxa de sucesso alvo em uma divisão de validação.
Visão Geral
O skills-flow é uma ferramenta de linha de comando que trata o desenvolvimento de habilidades de agentes de IA como um problema de otimização. Em vez de depender de ajustes manuais, ele automatiza o processo de melhoria contínua usando um loop iterativo semelhante ao treinamento de modelos de aprendizado de máquina.
Como Funciona
- Executar: O agente executa a habilidade em um conjunto de cenários de treinamento.
- Avaliar: Os resultados são comparados com os resultados esperados (rótulos).
- Refinar: Com base no feedback da avaliação, o SKILL.md e os scripts são ajustados automaticamente.
- Repetir: O ciclo se repete até que a taxa de sucesso na divisão de validação atinja o alvo.
Plataformas Suportadas
- Claude Code
- Cursor
- Codex
- Outros agentes compatíveis com SKILL.md
Instalação
pip install skills-flow
Uso
skills-flow --train-dir ./cenarios --skill-file ./SKILL.md --target-rate 0.95
Parâmetros
| Parâmetro | Descrição |
|---|---|
--train-dir | Diretório com cenários rotulados (JSON/YAML). |
--skill-file | Caminho para o arquivo SKILL.md a ser treinado. |
--target-rate | Taxa de sucesso alvo (ex: 0.95 para 95%). |
--val-split | Fração dos dados para validação (padrão: 0.2). |
Exemplo de Cenário
{
"input": "Crie uma função que calcule o fatorial.",
"expected": "def fatorial(n):\n if n == 0:\n return 1\n else:\n return n * fatorial(n-1)"
}
Licença
MIT