| name | skill-gates |
| description | Gerencia os skill gates do Ravi. Use quando precisar:
- Entender por que uma tool carrega uma skill automaticamente
- Listar regras default e overrides de skill gates
- Criar novas regras para tools, grupos ou comandos shell
- Sobrescrever, desativar ou resetar gates existentes
- Usar o CLI `ravi skill-gates`
|
Skill Gates
Skill gates fazem uma chamada de tool falhar de forma controlada quando a sessão ainda não carregou a skill necessária. A falha entrega o conteúdo da skill, marca a skill como carregada na sessão e pede retry da tool original.
CLI
Use ravi skill-gates para gerenciar regras. Não edite JSON em settings.
ravi skill-gates list
ravi skill-gates show image
ravi skill-gates set image ravi-system-image
ravi skill-gates disable image
ravi skill-gates reset image
Regras
Existem dois níveis:
- Defaults em código: cobrem grupos Ravi conhecidos, como
image, tasks, sessions, skill-gates.
- Overrides no DB: tabela
skill_gate_rules, usada para criar regras novas, sobrescrever defaults ou desativar defaults.
Um override com o mesmo id de um default muda esse default. Exemplo:
ravi skill-gates set image minha-skill-image
Para desativar um default:
ravi skill-gates disable image
Para remover o override e voltar ao default:
ravi skill-gates reset image
Criar Regra Customizada
Regras customizadas precisam de matcher explícito.
ravi skill-gates set linear linear-skill --pattern '^linear(?:[._]|$)'
ravi skill-gates set lookup lookup-skill --tool external_lookup
ravi skill-gates set github github --command-prefix 'gh issue'
Matchers disponíveis:
--pattern <regex>: regex contra grupo/tool normalizado.--group-regex <regex>: alias semântico de --pattern.--tool <name>: nome exato da runtime tool.--tool-prefix <prefix>: prefixo de runtime tool.--tool-regex <regex>: regex contra runtime tool.--command <command>: comando shell exato.--command-prefix <prefix>: prefixo de comando shell.--command-regex <regex>: regex contra comando shell bruto.
Comportamento no Runtime
O runtime consulta a tabela skill_gate_rules a cada resolução de gate e combina com os defaults em código. Ordem prática:
- Regras configuradas com matcher direto podem forçar ou desativar um gate.
- Overrides por
id alteram ou desativam defaults.
- Se nada configurado casar, os defaults em código continuam valendo.
Comandos de introspecção e carregamento de skills ficam isentos para evitar deadlock, como ravi skills show, ravi tools list e ravi sessions visibility.
