Sistema de Skills

Aprimoramento dinâmico de prompts via arquivos markdown. Skills injetam instruções específicas de contexto quando acionadas por palavras-chave nas mensagens do usuário.

Configuração

[skills]
dir = "skills"
enabled = true

Formato do Arquivo de Skill

Skills são arquivos markdown com frontmatter similar ao YAML, armazenados no diretório de skills:

---
name: Code Review
description: Provides code review guidelines
triggers: review, code review, PR, pull request
---
When reviewing code, follow these guidelines:

1. Check for security vulnerabilities
2. Verify error handling
3. Assess readability and naming
4. Look for performance issues
5. Ensure tests are adequate

Campos do Frontmatter

Correspondência Híbrida

A ativação de skills usa um processo em duas etapas:

1. Correspondência de padrões — busca de palavras-chave inteiras, insensível a maiúsculas/minúsculas. Se qualquer gatilho aparecer como uma palavra completa na mensagem do usuário, a skill é uma candidata.
2. Confirmação por LLM — o modelo rápido valida se cada skill candidata é realmente relevante para a intenção do usuário. Isso previne ativações falsas por correspondências acidentais de palavras-chave.

A etapa de confirmação é fail-open: se a chamada ao LLM falhar ou expirar, todas as candidatas correspondidas por padrão são ativadas.

Injeção no Prompt do Sistema

Quando skills são carregadas, o prompt do sistema é aprimorado com:

1. Available Skills — lista todos os nomes e descrições de skills
2. Active Skills — corpo completo de cada skill correspondida
3. Known Facts — fatos armazenados (injetados abaixo das skills)

## Available Skills
- Code Review: Provides code review guidelines
- DevOps: Infrastructure and deployment help

## Active Skill: Code Review
When reviewing code, follow these guidelines:
...

## Known Facts
### user
- name: David

Skills Dinâmicas

Além de skills estáticas do sistema de arquivos, o aidaemon suporta gerenciamento de skills em tempo de execução através da ferramenta manage_skills e registros opcionais.

Ações da Ferramenta manage_skills

Auto-Promoção

Uma tarefa em segundo plano roda a cada 12 horas, avaliando procedimentos frequentemente usados para promoção automática em skills reutilizáveis.