스킬

스킬 추가하기

1. .agents/skills/에 폴더를 만드세요. 폴더 이름이 api-auth처럼 스킬의 이름이 됩니다.
2. 폴더에 SKILL.md를 추가하세요. Agent Skills 형식에 따라 이 파일은 name을 반복하고 스킬을 언제 사용할지 설명하는 description을 담은 프런트매터로 시작해야 합니다.
3. 프런트매터 아래에 절차를 작성하세요.
4. 스킬이 필요한 각 검사의 skills 아래에 스킬을 나열하세요.

.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.

• 스킬 이름에는 소문자, 숫자, 단일 하이픈을 사용하며 최대 64자까지 가능합니다.
• 각 스킬은 SKILL.md가 있는 폴더입니다. HeyDeer는 Agent Skills 형식에서 설명하는 방식대로 SKILL.md가 참조하는 파일을 포함해 폴더 전체를 불러옵니다.
• HeyDeer는 풀 리퀘스트에서 스킬을 읽으므로, 풀 리퀘스트에서 자체 검토에 사용할 스킬을 추가하거나 변경할 수 있습니다. 풀 리퀘스트가 바꿀 수 있는 것을 참고하세요.

검사에 스킬 나열하기

검사 프런트매터의 skills 아래에 스킬 이름을 하나 또는 목록으로 추가하세요:

.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.

• 스킬은 참고 자료입니다. 나열된 스킬이 없더라도 HeyDeer는 검사의 지침에 따라 검사를 수행합니다.
• 변경된 파일과 일치하는 검사에 유효하지 않은 스킬 이름이 있으면 해당 검사는 유효하지 않습니다. HeyDeer는 해당 검사를 건너뛰고 검토 안내에 표시한 후 검토를 계속합니다.

이미 .claude/skills를 사용하고 있나요?

같은 스킬이 .agents/skills에도 있도록 심볼릭 링크를 추가하세요. 스킬을 옮길 필요는 없습니다:

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