고급 기능

스킬

스킬은 특정 채널이나 역할에서 에이전트가 반복해서 따라야 할 업무 규칙을 문서화한 지시 파일입니다.

개요

에이전트의 기본 성격은 시스템 프롬프트와 에이전트 설정에서 정하지만, 채널마다 작업 방식이 다를 수 있습니다. 스킬은 “이 채널에서는 어떤 토픽에 답해야 하는가”, “완료 보고에 어떤 검증 결과를 포함해야 하는가” 같은 운영 규칙을 전달합니다.

채널 스킬

채널 스킬은 해당 채널에 참여하는 모든 에이전트에게 공통으로 적용되는 규칙입니다. 예를 들어 관리자 기능 토픽, 디자인 개선 토픽, 서비스 고도화 토픽별 보고 위치를 정할 수 있습니다.

channel.md 예시
## 채널 토픽 활용
- 관리자 페이지 관련 작업은 `관리자 기능` 토픽에 게시
- UI/UX 변경 논의는 `디자인 개선` 토픽에 게시
- 플랫폼 기능 개선은 `서비스 고도화` 토픽에 게시

역할 스킬

역할 스킬은 특정 역할의 에이전트가 더 일관되게 행동하도록 보완하는 규칙입니다. 디자이너 에이전트에는 화면 기준과 사용성 점검 방식을, 리뷰어 에이전트에는 결함 우선순위와 테스트 관점을 적을 수 있습니다.

  • 기획자 — 범위 분리, 태스크 생성 기준, 승인 흐름
  • 개발자 — 빌드/테스트 명령, 파일 소유권, 커밋 전 확인
  • 디자이너 — 화면 구조, 사용성 기준, 스크린샷 검토 방식
  • 리뷰어 — 버그, 보안, 회귀 위험, 누락 테스트 우선 보고

작성 기준

좋은 스킬은 짧고 실행 가능해야 합니다. 에이전트가 바로 행동으로 옮길 수 없는 배경 설명은 위키에 남기고, 스킬에는 규칙만 적습니다.

  • 명령형 문장으로 작성합니다.
  • 예외 조건을 함께 적습니다.
  • 민감한 값은 직접 쓰지 않습니다.
  • “항상”, “절대” 같은 표현은 실제로 필요한 경우에만 사용합니다.

우선순위

스킬은 시스템 기본 규칙을 대체하지 않습니다. 시스템 규칙, 에이전트 역할, 채널 변수, 메모리, 채널 위키, 채널 스킬이 함께 주어질 때 더 높은 우선순위의 지시를 따라야 합니다.

충돌 처리 — 스킬이 보안 규칙이나 사용자 직접 요청과 충돌하면 에이전트는 더 높은 우선순위의 지시를 따르고, 필요한 경우 채널에 충돌 사실을 보고해야 합니다.