# 로빙 명령어 구현 가이드

## 배경
- rb10408_test는 경량화 버전으로 명령어 미구현 상태
- rb10508_micro는 일부 명령어 구현됨
- 공통 명령어를 경량화를 유지하면서 구현해야 함

## 구현된 명령어 (rb10508_micro)
- `/memory` - 메모리 통계 조회
- `/digest` - 요약 생성
- `/news` - 뉴스 검색
- `/email` - 이메일 관련 기능

## 하이브리드 명령어 처리 아키텍처

### 1. 로컬 처리 명령어
빠른 응답이 필요하거나 로컬 데이터만 필요한 경우:
```python
# /memory - ChromaDB 직접 조회
async def _handle_memory(self, user_id: str) -> Dict[str, Any]:
    memory_stats = await self.memory_manager.get_memory_stats()
    return {"type": "memory_stats", "data": memory_stats}

# /help - 정적 응답
async def _handle_help(self) -> Dict[str, Any]:
    return {"type": "help", "data": HELP_TEXT}
```

### 2. 외부 서비스 호출 명령어
복잡한 처리나 외부 데이터가 필요한 경우:
```python
# /news - News 스킬 서비스 호출
async def _handle_news(self, query: str) -> Dict[str, Any]:
    return await self._call_external_service(
        self.skill_endpoints["news"],
        {"query": query}
    )

# /digest - Slack 스킬 서비스 호출
async def _handle_digest(self, channel: str) -> Dict[str, Any]:
    return await self._call_external_service(
        self.skill_endpoints["slack"] + "/digest",
        {"channel": channel}
    )
```

### 3. 명령어 라우팅 구조
```python
class CommandHandler:
    def __init__(self):
        self.local_commands = {
            "/help": self._handle_help,
            "/stats": self._handle_stats,
            "/memory": self._handle_memory
        }
        
        self.external_commands = {
            "/news": ("news", self._handle_news),
            "/digest": ("slack", self._handle_digest),
            "/email": ("email", self._handle_email)
        }
```

## 구현 시 고려사항

### 1. 메모리 효율성
- 로컬 명령어는 최소한의 메모리 사용
- 캐싱은 필요시에만 선택적 적용

### 2. 응답 속도
- 로컬 명령어: < 100ms
- 외부 서비스: Slack 3초 룰 준수

### 3. 에러 처리
```python
try:
    result = await handler(params)
except ServiceUnavailable:
    return {"error": "서비스를 일시적으로 사용할 수 없습니다."}
except Exception as e:
    logger.error(f"Command error: {e}")
    return {"error": "명령어 처리 중 오류가 발생했습니다."}
```

## 추가 구현 필요 명령어
- `/remind` - 리마인더 설정
- `/search` - 메모리 검색
- `/report` - 일일/주간 리포트

## 관련 파일
- `/home/heejae/rb10408_test/app/commands/handler.py` (생성 필요)
- `/home/heejae/rb10508_micro/app/commands/` (참고용)
- `/home/heejae/DOCS/skills-and-commands.md`