에이전트 개발 가이드 (Claude Code 서브에이전트)

무엇을 해주나

• Claude Code 서브에이전트 파일(agents/이름.md)의 표준 형식을 알려줍니다: name, description, model, color, tools 필드 규칙과 길이·문자 제약까지 정리되어 있습니다.
• 에이전트가 언제 호출되는지를 결정하는 description 안의 <example> / <commentary> 블록 작성법을 예시와 함께 제시합니다.
• 시스템 프롬프트(본문) 템플릿(핵심 책임 → 분석 절차 → 품질 기준 → 출력 형식 → 예외 상황)과 DO/DON'T 체크리스트를 제공합니다.
• AI에게 에이전트 설정을 자동 생성시키는 프롬프트 패턴, 검증 스크립트, 테스트 절차까지 이어지는 워크플로를 안내합니다.

이런 분께 추천

• Claude Code 플러그인이나 사내 자동화용 서브에이전트를 직접 만들려는 개발자
• 에이전트가 원하는 상황에서 자동 발동하지 않아 트리거 문구를 고치고 싶은 분
• 여러 에이전트를 팀 표준 형식으로 통일해 관리하려는 리드/플랫폼 담당자

활용 예시

1. "코드 리뷰 전용 에이전트 만들어줘" → 식별자 code-reviewer, tools: ["Read","Grep","Glob"], 리뷰 절차와 출력 형식이 포함된 파일 초안을 받습니다.
2. 기존 에이전트가 호출되지 않을 때 → description에 2~4개의 <example> 블록을 추가해 트리거 문구를 보강합니다.
3. 플러그인 배포 전 → scripts/validate-agent.sh로 형식을 검증하고 테스트 시나리오로 발동 여부를 확인합니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/Microck/ordinary-claude-skills/HEAD/skills_all/agent-identifier/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 Microck/ordinary-claude-skills 의 skills_all/agent-identifier 폴더를 내 ~/.claude/skills/agent-development/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.