프로그레시브 디스클로저 : 토큰을 절약하면서 스킬 성능 높이기
목차
스킬에 정보를 많이 넣으면 좋을까요?
반드시 그렇지는 않습니다. 너무 많은 정보는 토큰을 낭비하고, AI의 집중력을 떨어뜨립니다.
이 글에서는 필요한 정보만 필요한 시점에 제공하는 프로그레시브 디스클로저 기법을 알아봅니다.
프로그레시브 디스클로저란?
프로그레시브 디스클로저가 뭔가요? 이름이 어려워요.
회사 교육 자료를 생각해봐. 신입 교육에서 모든 내용을 한꺼번에 주면 머리가 터지잖아?
맞아요, 필요할 때 하나씩 주는 게 낫죠.
그게 바로 프로그레시브 디스클로저야! 기본 정보만 먼저 주고, 상세 정보는 필요할 때 불러오는 거지.
SKILL.md = 핵심 정보만 (요약)
knowledge/ = 상세 정보 저장 (필요시 로드)
결과: 토큰 절약 + 집중력 향상
knowledge 폴더 활용
상세 정보는 knowledge 폴더에 분리합니다.
스킬 구조:
skills/my-skill/SKILL.md - 핵심만
skills/my-skill/knowledge/*.md - 상세 정보
💡 폴더 구조 예시
~/.claude/skills/code-reviewer/
├── SKILL.md # 핵심 지침
└── knowledge/
├── typescript.md # TS 리뷰 상세 규칙
├── react.md # React 리뷰 상세 규칙
├── security.md # 보안 체크리스트
└── performance.md # 성능 최적화 가이드
SKILL.md에서 knowledge 참조
---
name: code-reviewer
description: 코드 리뷰 전문가
---
# 코드 리뷰 스킬
## 역할
코드 품질을 검토하는 전문가입니다.
## 기본 규칙
1. 가독성 확인
2. 버그 가능성 점검
3. 보안 이슈 확인
## 상세 가이드
- TypeScript 파일: `knowledge/typescript.md` 참조
- React 컴포넌트: `knowledge/react.md` 참조
- 보안 검토: `knowledge/security.md` 참조
**중요**: 해당 유형의 코드를 리뷰할 때만 관련 knowledge 파일을 읽으세요.
토큰 효율 비교
토큰 절약이 왜 중요한가요?
두 가지 이유가 있어.
① 비용 - 토큰이 많으면 API 비용 증가
② 성능 - 불필요한 정보가 많으면 AI가 핵심을 놓칠 수 있어
| 방식 | 토큰 사용 | 집중력 |
|---|---|---|
| 모든 정보를 SKILL.md에 | 매번 전체 로드 (높음) | 정보 과다로 분산 |
| knowledge 분리 | 필요한 것만 로드 (낮음) | 핵심에 집중 |
언제 사용할까?
💡 프로그레시브 디스클로저가 유용한 경우
- 다양한 유형 처리 - 파일 유형별, 언어별 다른 규칙
- 긴 참조 문서 - 코딩 컨벤션, 스타일 가이드
- 조건부 정보 - 특정 상황에서만 필요한 지침
- 업데이트 잦은 정보 - 자주 바뀌는 내용은 분리
💡 굳이 분리 안 해도 되는 경우
- 전체 내용이 200줄 미만
- 모든 정보가 항상 필요
- 스킬이 단일 목적만 수행
SKILL.md가 500줄을 넘으면 분리를 고려하세요. 그 이전에는 한 파일로 관리해도 괜찮습니다!
실전 예제
knowledge/typescript.md
# TypeScript 코드 리뷰 상세 가이드
## 타입 검사
1. any 타입 사용 지양
2. unknown 선호
3. 제네릭 적극 활용
## 인터페이스 vs 타입
- 확장 가능성 있으면 interface
- 유니온/인터섹션 필요하면 type
## 엄격 모드 설정
- strict: true 권장
- noImplicitAny: true 필수
... (상세 내용 계속)
SKILL.md의 참조 방식
## 언어별 상세 가이드
TypeScript 파일을 리뷰할 때:
→ `knowledge/typescript.md` 파일을 읽고 해당 규칙을 적용하세요.
JavaScript 파일을 리뷰할 때:
→ `knowledge/javascript.md` 파일을 읽고 해당 규칙을 적용하세요.
프로그레시브 디스클로저 = 필요한 정보를 필요한 시점에
SKILL.md = 핵심 지침만 (200줄 이내 권장)
knowledge/ = 상세 정보 분리 저장
효과 = 토큰 절약 + AI 집중력 향상
👉 settings.json 이해하기 : 스킬 권한과 동작 설정 마스터하기
똑똑한 정보 제공으로 효율과 품질을 모두 챙기세요!
Less is More! 📚
댓글
댓글 쓰기