Skip to main content

Por que uma skill

Seu time pode já manter as regras de segurança como uma skill de agente, para assistentes de código. Um agente personalizado pode seguir a mesma skill no code review: ele abre a skill quando a mudança pede, lê os arquivos de referência e cita a regra que cada apontamento aplica. Quando a skill muda na branch principal, o agente segue a versão nova sem mexer nas configurações. O exemplo é uma API de agendamento multi-tenant em que toda consulta precisa ficar restrita ao workspace de quem chama.

Passo 1 — A skill no repositório

.claude/skills/tenant-isolation/SKILL.md
.claude/skills/tenant-isolation/references/tenant-tables.md
O nome da pasta e o name precisam ser iguais, e description é obrigatório.

Passo 2 — Importe como agente

1

Abra as configurações do repositório

Escolha o repositório no seletor de escopo e vá em What to review → Custom agents → New agent.
2

Import from repository

A aba lista as skills encontradas na branch padrão. Clique em tenant-isolation.
3

Confira o resultado

O agente é criado desligado, com o nome Tenant isolation reviewer, a skill vinculada e estas instruções:

Passo 3 — Afine as instruções

Mantenha a referência à skill e acrescente que prova um apontamento precisa:
Instructions

Passo 4 — Opcional: um plugin

Se o seu gerenciador de tarefas está instalado como plugin, ligue-o em Tools → Plugins. Só ferramentas de leitura são oferecidas. Quando a descrição do pull request tem o link de um ticket, o agente pode ler o ticket e conferir a mudança contra o que ele pede.

Passo 5 — Comentários

Clique em Save.

Passo 6 — Try it

Rode o Try it num pull request que adiciona um endpoint. Confira:
  • Skills opened mostra .claude/skills/tenant-isolation e, quando o agente precisou, references/tenant-tables.md.
  • Os apontamentos mantidos citam uma regra da skill:
  • Os apontamentos descartados mostram o motivo. Uma observação geral de segurança que a skill não cobre é descartada como fora do foco do agente, que é o que você quer aqui.
Ligue o agente. Para pedir uma segunda opinião num pull request aberto mais tarde, comente @kody -v tenant-isolation-reviewer.

Checklist

  • O SKILL.md tem name igual ao da pasta e uma description
  • Os arquivos de referência ficam no máximo uma pasta abaixo da skill
  • As instruções dizem que prova um apontamento precisa
  • A severidade mínima combina com o quanto o agente deve falar
  • Testado num pull request com uma falha conhecida
Veja Skills & docs para a detecção e os orçamentos.