모범 사례
효과적이고 유지보수 가능한 Agent Skills를 만들기 위한 가이드라인입니다.
개요
잘 설계된 스킬은 도움이 되는 AI 어시스턴트와 답답한 AI 어시스턴트의 차이입니다. 신뢰할 수 있게 작동하는 스킬을 만들려면 이러한 모범 사례를 따르세요.
핵심 원칙
1. 모호하지 않고 구체적으로
좋음:
"제목에 문장 대문자 사용. 첫 번째 단어와 고유명사만 대문자로."
나쁨:
"적절한 대문자 사용."
2. 예시 제공
말만 하지 말고 보여주세요. 예상 동작의 구체적인 예시를 포함하세요.
좋음:
날짜 형식 지정 시:
- 이렇게 작성: "January 15, 2024"
- 이렇게 작성하지 않음: "01/15/24" 또는 "15 Jan 2024"
3. 범위 명확히 정의
스킬이 다루는 것과 다루지 않는 것을 명시적으로 기술하세요.
좋음:
이 스킬이 다루는 것:
- React 컴포넌트 설계
- 상태 관리
- 성능 최적화
이 스킬이 다루지 않는 것:
- 백엔드 API 설계
- 데이터베이스 스키마
- DevOps/배포
4. 일관된 구조 사용
AI가 정보를 빠르게 찾을 수 있도록 콘텐츠를 예측 가능하게 구성하세요.
권장 섹션:
- 맥락/개요
- 가이드라인
- 해야 할 것과 하지 말아야 할 것
- 예시
- 참고자료
5. 집중 유지
하나의 스킬 = 하나의 도메인. 모든 것을 다루려고 하지 마세요.
좋음: "React Component Guidelines" 나쁨: "Complete Web Development Guide"
일반적인 실수
과도한 설계
가치를 제공하지 않는 복잡성을 추가하지 마세요:
- 서로 모순되는 너무 많은 규칙
- 드물게 발생하는 엣지 케이스
- 중복 정보
불충분한 명시
중요한 세부사항을 모호하게 두지 마세요:
- 핵심 개념에 대한 예시 누락
- "적절하게"와 같은 모호한 언어
- 엣지 케이스에 대한 안내 없음
충돌하는 지시사항
가이드라인이 서로 모순되지 않도록 하세요:
문제:
"응답을 간결하게 유지" 그리고 "상세한 설명 제공"
해결책:
"응답을 간결하게 유지. 복잡한 주제의 경우 확장 가능한 섹션에 상세한 설명 제공."