heydeer
Comece grátis
Ensine seu código ao HeyDeer

Skills

Uma skill guarda um procedimento reutilizável, como a forma de verificar o controle de acesso de uma rota, no formato aberto Agent Skills. Uma verificação do repositório cita as skills de que precisa, e o HeyDeer as segue ao executar essa verificação.

Adicionar uma skill

  1. Crie uma pasta em .agents/skills/. O nome da pasta é o nome da skill, como api-auth.
  2. Adicione um SKILL.md à pasta. Como o formato Agent Skills exige, ele começa com um frontmatter que repete o name e traz uma description de quando usar a skill.
  3. Escreva o procedimento abaixo do frontmatter.
  4. Liste a skill em skills em cada verificação que precisar dela.

.agents/skills/api-auth/SKILL.md

---
name: api-auth
description: How route handlers authenticate and authorize requests.
  Use when checking a route's access control.
---
# Checking a route's access control

1. Find the handler in src/routes/ and the middleware its router
   applies.
2. requireAuth() from src/auth/middleware.ts must run before the
   handler reads the request.
3. Routes under /admin also need requireRole('admin').
4. A handler that takes an :orgId parameter calls
   assertMember(user, orgId) before its first query.

Routes listed in src/routes/public.ts are public by design.
  • Os nomes das skills usam letras minúsculas, dígitos e hifens simples, com até 64 caracteres.
  • Cada skill é uma pasta com um SKILL.md. O HeyDeer carrega a pasta inteira da forma descrita pelo formato Agent Skills, incluindo os arquivos a que o SKILL.md se refere.
  • O HeyDeer lê as skills do pull request, então um pull request pode adicionar ou alterar as skills que a própria revisão dele usa. Consulte O que um pull request pode alterar.

Listar skills em uma verificação

Adicione os nomes das skills em skills no frontmatter da verificação, como um único nome ou uma lista:

.agents/checks/route-auth.md

---
files: "src/routes/**"
skills: [api-auth]
---
Every new or changed route handler checks authentication and
authorization before it reads the request.
  • As skills são orientações. Se uma skill listada estiver ausente, o HeyDeer ainda executa a verificação a partir das instruções dela.
  • Uma verificação aplicável que lista um nome de habilidade inválido é inválida. O HeyDeer ignora essa verificação, a indica em Observações da revisão e continua a revisão.

Já usa .claude/skills?

Adicione um link simbólico para que as mesmas skills também fiquem em .agents/skills. Você não precisa movê-las:

mkdir -p .agents
ln -s ../.claude/skills .agents/skills
git add .agents/skills