클로드-스킬(Claude Skills)로 만드는 조직 표준 기반 코딩 에이전트
AI
클로드-스킬(Claude Skills)로 만드는 조직 표준 기반 코딩 에이전트
두줄요약
Claude Skills로 사내 규약과 코딩 컨벤션을 모듈화한 코딩 에이전트 운영 방식을 소개했습니다. 점진적 컨텍스트 로딩과 훅 기반 활성화, Git 공유 전략을 정리했습니다.
문제 상황
- 사내 커스텀 라이브러리·통신 규약과 코딩 컨벤션을 코딩 에이전트에 일관되게 적용할 필요
- 신규 마이크로서비스의 기준 코드 부재와 LLM 출력 변동성에 따른 코드 리뷰 부담
- CLAUDE.md 및 rules 전체 로드에 따른 컨텍스트 낭비와 관리 복잡성
해결 방법
.claude/skills아래에 SKILL.md, 참조 파일, 스크립트를 포함한 작업 목적별 스킬 구성- 프론트매터 description 기반 자동 선택, 본문·참조 파일의 단계적 로딩 구조 활용
- 결정적 작업의 스크립트 분리와 UserPromptSubmit 훅 기반 스킬 활성화 리마인더 적용
구조와 흐름
- 기본 컨텍스트의 스킬 name·description 로드 후 요청 연관성에 따른 스킬 선택
- 선택된 SKILL.md 지침 로드 후 필요 시 참조 파일 추가 로드
- 스킬을 지식 단위, 서브 에이전트를 여러 스킬을 조합해 작업을 수행하는 주체로 구분
성능/운영 포인트
- SKILL.md 본문 간결화와 상세 정보의 1단계 깊이 참조 파일 분리
- 스킬 저장소의 Git·PR 기반 변경 관리와 심볼릭 링크 기반 개발 환경 배포
- skill-creator를 활용한 신규 스킬 기본 구조 생성과 점진적 팀 자산 확장
