Pular para o conteúdo principal

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.