243 lines
6.9 KiB
Markdown
243 lines
6.9 KiB
Markdown
# Token Efficiency Mode
|
||
|
||
AI 응답을 압축하여 컨텍스트 사용량을 30-50% 절감하는 효율화 모드입니다.
|
||
|
||
## 개요
|
||
|
||
Token Efficiency Mode 는 시각적 심볼과 약어 시스템을 활용하여 Claude 의 응답을 압축합니다.
|
||
**생성되는 코드의 품질이나 내용은 전혀 변경되지 않습니다**. 바뀌는 것은 설명 방식뿐입니다.
|
||
|
||
## 사용법
|
||
|
||
```bash
|
||
# 모드 활성화
|
||
「Token Efficiency Mode 로 응답해주세요」
|
||
「--uc 모드로」
|
||
「간결 모드로」
|
||
```
|
||
|
||
## 동작 원리
|
||
|
||
### 1. 심볼 체계
|
||
|
||
#### 로직 & 플로우
|
||
|
||
| 심볼 | 의미 | 사용 예시 |
|
||
| ---- | -------------------------- | ------------------------------ |
|
||
| → | ~로 이어지는, ~을 야기하는 | `auth.js:45 → 🛡️ 보안 위험` |
|
||
| ⇒ | ~로 변환 | `input ⇒ validated_output` |
|
||
| ← | 롤백, 되돌리기 | `migration ← rollback` |
|
||
| ⇄ | 양방향 | `sync ⇄ remote` |
|
||
| & | 그리고, 결합 | `🛡️ security & ⚡ performance` |
|
||
| \| | 또는, 구분 | `react\|vue\|angular` |
|
||
| : | 정의, 지정 | `scope: file\|module` |
|
||
| » | 다음, 시퀀스 | `build » test » deploy` |
|
||
| ∴ | 따라서 | `tests ❌ ∴ code broken` |
|
||
| ∵ | 왜냐하면 | `slow ∵ O(n²) algorithm` |
|
||
|
||
#### 상태 & 진행
|
||
|
||
| 심볼 | 의미 | 용도 |
|
||
| ---- | ---------- | ---------------- |
|
||
| ✅ | 완료, 성공 | 작업 정상 종료 |
|
||
| ❌ | 실패, 에러 | 즉시 대응 필요 |
|
||
| ⚠️ | 경고 | 리뷰 권장 |
|
||
| 🔄 | 진행 중 | 현재 활성 |
|
||
| ⏳ | 대기 중 | 나중에 실행 예정 |
|
||
| 🚨 | 긴급, 중요 | 고우선순위 |
|
||
|
||
#### 기술 도메인
|
||
|
||
| 심볼 | 분야 | 용도 |
|
||
| ---- | ------------ | -------------- |
|
||
| ⚡ | 성능 | 속도, 최적화 |
|
||
| 🔍 | 분석 | 검색, 조사 |
|
||
| 🔧 | 설정 | 셋업, 도구 |
|
||
| 🛡️ | 보안 | 보호, 안전성 |
|
||
| 📦 | 배포 | 패키지, 번들 |
|
||
| 🎨 | 디자인 | UI, 프런트엔드 |
|
||
| 🏗️ | 아키텍처 | 시스템 구조 |
|
||
| 🗄️ | 데이터베이스 | 데이터 지속성 |
|
||
| ⚙️ | 백엔드 | 서버 처리 |
|
||
| 🧪 | 테스트 | 품질 보증 |
|
||
|
||
### 2. 약어 시스템
|
||
|
||
#### 시스템 & 아키텍처
|
||
|
||
- `cfg` → configuration (설정)
|
||
- `impl` → implementation (구현)
|
||
- `arch` → architecture (아키텍처)
|
||
- `perf` → performance (성능)
|
||
- `ops` → operations (운영)
|
||
- `env` → environment (환경)
|
||
|
||
#### 개발 프로세스
|
||
|
||
- `req` → requirements (요구사항)
|
||
- `deps` → dependencies (의존성)
|
||
- `val` → validation (검증)
|
||
- `auth` → authentication (인증)
|
||
- `docs` → documentation (문서)
|
||
- `std` → standards (표준)
|
||
|
||
#### 품질 & 분석
|
||
|
||
- `qual` → quality (품질)
|
||
- `sec` → security (보안)
|
||
- `err` → error (에러)
|
||
- `rec` → recovery (복구)
|
||
- `sev` → severity (심각도)
|
||
- `opt` → optimization (최적화)
|
||
|
||
## 실제 비교 예시
|
||
|
||
### 예시 1: 에러 보고
|
||
|
||
**일반 모드 (92 자)**
|
||
|
||
```text
|
||
인증 시스템의 사용자 검증 함수 45 행에서 보안 취약점이 발견되었습니다.
|
||
```
|
||
|
||
**Token Efficient (39 자)**
|
||
|
||
```text
|
||
auth.js:45 → 🛡️ sec vuln in user val()
|
||
```
|
||
|
||
### 예시 2: 빌드 상황
|
||
|
||
**일반 모드 (145 자)**
|
||
|
||
```text
|
||
빌드 프로세스가 정상적으로 완료되었습니다. 현재 테스트를 실행 중이며, 그 후 배포를 진행합니다.
|
||
```
|
||
|
||
**Token Efficient (35 자)**
|
||
|
||
```text
|
||
build ✅ » test 🔄 » deploy ⏳
|
||
```
|
||
|
||
### 예시 3: 성능 분석
|
||
|
||
**일반 모드 (98 자)**
|
||
|
||
```text
|
||
성능 분석 결과, 알고리즘이 O(n²) 의 복잡도로 인해 처리가 느린 것으로 판명되었습니다.
|
||
```
|
||
|
||
**Token Efficient (42 자)**
|
||
|
||
```text
|
||
⚡ perf: slow ∵ O(n²) → optimize to O(n)
|
||
```
|
||
|
||
## 활용 시나리오
|
||
|
||
### ✅ 효과적인 상황
|
||
|
||
- **장시간 디버깅 세션**: 이력을 유지하면서 효율적으로
|
||
- **대규모 코드 리뷰**: 다수의 파일을 간결하게 분석
|
||
- **CI/CD 모니터링**: 실시간 상태 업데이트
|
||
- **프로젝트 진행 상황 보고**: 여러 작업 상태를 한눈에 정리
|
||
- **에러 추적**: 문제의 연쇄를 시각적으로 표현
|
||
|
||
### ❌ 피해야 할 상황
|
||
|
||
- 초보자에게 설명할 때
|
||
- 상세한 문서 작성
|
||
- 최초 요구사항 정의
|
||
- 비기술자와의 소통
|
||
|
||
## 구현 예시
|
||
|
||
### 디버깅 세션
|
||
|
||
```text
|
||
[14:23] breakpoint → vars: {user: null, token: expired}
|
||
[14:24] step → auth.validate() ❌
|
||
[14:25] check → token.exp < Date.now() ∴ expired
|
||
[14:26] fix → refresh() → ✅
|
||
[14:27] continue → main flow 🔄
|
||
```
|
||
|
||
### 파일 분석 결과
|
||
|
||
```text
|
||
/src/auth/: 🛡️ issues × 3
|
||
/src/api/: ⚡ bottleneck in handler()
|
||
/src/db/: ✅ clean
|
||
/src/utils/: ⚠️ deprecated methods
|
||
/tests/: 🧪 coverage 78%
|
||
```
|
||
|
||
### 프로젝트 상태
|
||
|
||
```text
|
||
Frontend: 🎨 ✅ 100%
|
||
Backend: ⚙️ 🔄 75%
|
||
Database: 🗄️ ✅ migrated
|
||
Tests: 🧪 ⚠️ 68% (target: 80%)
|
||
Deploy: 📦 ⏳ scheduled
|
||
Security: 🛡️ 🚨 1 critical
|
||
```
|
||
|
||
## 설정 옵션
|
||
|
||
```javascript
|
||
// 압축 레벨
|
||
--uc; // Ultra Compressed: 최대 압축
|
||
--mc; // Moderate Compressed: 중간 압축
|
||
--lc; // Light Compressed: 경량 압축
|
||
|
||
// 도메인 특화
|
||
--dev; // 개발용 압축
|
||
--ops; // 운영용 압축
|
||
--sec; // 보안용 압축
|
||
```
|
||
|
||
## 장점
|
||
|
||
1. **컨텍스트 절약**: 30-50% 의 토큰 절감
|
||
2. **시각적 이해**: 심볼로 직관적 파악
|
||
3. **정보 밀도 향상**: 같은 공간에 더 많은 정보
|
||
4. **이력 유지**: 더 긴 대화 이력 보존
|
||
5. **패턴 인식**: 시각적 패턴으로 문제 발견 용이
|
||
|
||
## 주의사항
|
||
|
||
- 이 모드는 **AI 의 응답 스타일**만을 변경합니다
|
||
- 생성되는 **코드의 품질**은 변하지 않습니다
|
||
- 필요 시 "일반 모드로 설명해주세요"로 전환 가능
|
||
- 초보자나 비기술자에게는 일반 모드를 권장
|
||
|
||
## 명령어 예시
|
||
|
||
```bash
|
||
# 활성화
|
||
「Token Efficient Mode on」
|
||
「간결하게 응답해주세요」
|
||
「--uc 로 분석」
|
||
|
||
# 비활성화
|
||
「일반 모드로 돌아가세요」
|
||
「자세히 설명해주세요」
|
||
「Token Efficient Mode off」
|
||
```
|
||
|
||
## 구현에 미치는 영향
|
||
|
||
| 항목 | 영향 |
|
||
| --------------- | -------------- |
|
||
| 생성 코드 품질 | 변경 없음 ✅ |
|
||
| 구현 정확성 | 변경 없음 ✅ |
|
||
| 기능성 | 변경 없음 ✅ |
|
||
| AI 설명 방식 | 압축됨 🔄 |
|
||
| 컨텍스트 사용량 | 30-50% 절감 ⚡ |
|
||
|
||
---
|
||
|
||
💡 **Pro Tip**: 장시간 작업 세션에서는 처음에는 일반 모드로 이해를 높이고, 그 후 Token Efficient Mode 로 전환하여 효율성과 컨텍스트 보존의 균형을 최적화할 수 있습니다.
|