stancsz/skills-flow

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.

O que é skills-flow?

O skills-flow é uma ferramenta inspirada em aprendizado de máquina que aplica o conceito de gradiente descendente para otimizar habilidades de agentes de IA. Ele opera em um ciclo de execução, avaliação e refinamento, treinando um arquivo SKILL.md e scripts associados em um conjunto de cenários rotulados. O objetivo é atingir uma taxa de sucesso predefinida em uma divisão de dados separada para validação. Essa abordagem é útil para desenvolvedores que desejam criar e refinar sistematicamente habilidades de agentes (como para Claude Code, Cursor, Codex) de forma iterativa e orientada a dados, garantindo que a habilidade generalize bem para novos exemplos.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add stancsz/skills-flow

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

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

Documentação

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

  1. Executar: O agente executa a habilidade em um conjunto de cenários de treinamento.
  2. Avaliar: Os resultados são comparados com os resultados esperados (rótulos).
  3. Refinar: Com base no feedback da avaliação, o SKILL.md e os scripts são ajustados automaticamente.
  4. 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âmetroDescrição
--train-dirDiretório com cenários rotulados (JSON/YAML).
--skill-fileCaminho para o arquivo SKILL.md a ser treinado.
--target-rateTaxa de sucesso alvo (ex: 0.95 para 95%).
--val-splitFraçã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

Habilidades Relacionadas