Skills: Triggers e Ativação Automática

Última atualização: 2026-08-31

Um bom Skill deve ser como o ar — presente quando você precisa, fora do caminho quando não precisa. Triggers são o interruptor do "quando você precisa".

1. Tipos de trigger

(1) Trigger por palavra-chave

O método de gatilho mais comum, corresponde a palavras-chave na entrada do usuário:

triggers:
  - keyword: "review|revisar código"
  - keyword: "debug|depurar|solucionar"

(2) Trigger por tipo de arquivo

Ativa automaticamente com base na extensão ou caminho dos arquivos sendo manipulados:

triggers:
  - file_pattern: "**/*.py"
  - file_pattern: "src/components/**/*.tsx"

(3) Trigger por condição de contexto

Ativa com base no ambiente do projeto ou estado da conversa:

triggers:
  - context: "git_diff_available"
  - context: "test_failed"
  - context: "has_package_json"

2. Prioridade dos triggers

Quando múltiplos Skills correspondem simultaneamente, a seleção segue prioridade:

Prioridade da mais alta para a mais baixa:
1. Chamada manual explícita (usuário solicita explicitamente)
2. Correspondência exata de palavra-chave
3. Correspondência de condição de contexto
4. Correspondência difusa de tipo de arquivo
5. Skill de fallback padrão

(1) Configuração de prioridade

triggers:
  - keyword: "urgent fix"
    priority: 100
  - keyword: "fix"
    priority: 50

(2) Resolução de conflitos

Quando dois Skills competem:

Entrada do usuário: "review this Python file for bugs"

Resultados da correspondência:
├── Skill code-review (palavra-chave: "review") → Prioridade 80
├── Skill python-review (palavra-chave: "review" + arquivo: *.py) → Prioridade 90 ✅
└── Skill debug (palavra-chave: "bug") → Prioridade 70

Resultado: Selecionar python-review porque corresponde mais precisamente

3. Triggers combinados

(1) Combinação AND

Todas as condições devem ser atendidas simultaneamente:

triggers:
  - and:
      - keyword: "deploy"
      - context: "main_branch"

(2) Combinação OR

Qualquer condição atendida ativa:

triggers:
  - or:
      - keyword: "test"
      - file_pattern: "**/*test*.py"

(3) Exclusão NOT

Não ativa quando a condição é atendida:

triggers:
  - keyword: "refactor"
  - not:
      - context: "production_branch"

4. Prática de triggers

▶ Exemplo: Sistema de agendamento inteligente

Alice projetou um sistema de auto-trigger para a equipe:

# .claude/skills/auto-test.md
---
name: auto-test
triggers:
  - and:
      - file_pattern: "src/**/*.py"
      - context: "file_modified"
  - not:
      - file_pattern: "src/**/migrations/**"
---

Após modificar arquivos-fonte Python, executar testes automaticamente......

Bob comentou: "Com este sistema, a equipe não precisa se lembrar qual Skill chamar — basta trabalhar normalmente, e o suporte certo aparece automaticamente."

(1) Cenários comuns de trigger

❓ Perguntas Frequentes

P: Palavras-chave demais podem causar conflitos? R: Sim. Recomendamos 1-2 palavras-chave principais por Skill, evitando sobreposição em larga escala. Resolva conflitos com prioridade e precisão. P: Quais condições de contexto são suportadas? R: Varia por plataforma; as comuns incluem: git_diff_available, test_failed, branch_name, file_modified, has_config_file, etc. P: Posso desativar o auto-trigger de um Skill? R: Sim, configure auto_trigger: false; o Skill só poderá ser chamado manualmente.

📖 Resumo

• Três tipos de trigger: palavra-chave, tipo de arquivo, condição de contexto
• Regras de prioridade: manual > correspondência exata > correspondência difusa > fallback
• Triggers combinados: AND (todas devem ser atendidas), OR (qualquer uma é atendida), NOT (excluir)
• Princípio de design: Skills aparecem automaticamente quando necessário, não invadem quando desnecessários

📝 Exercícios

1. Básico (dificuldade⭐): Adicione dois tipos diferentes de triggers ao Skill code-review que você criou anteriormente.
2. Intermediário (dificuldade⭐⭐): Projete um trigger combinado que execute testes automaticamente quando arquivos de teste Python forem modificados, excluindo arquivos de migração.
3. Avançado (dificuldade⭐⭐⭐): Projete um sistema de agendamento de triggers em nível de equipe que gerencie prioridade e conflitos entre 5+ Skills.

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

Sobre Nós