에이전트 개발을 위한 RooCode VS Code 설정

VS Code에서 RooCode 최적화하기: 에이전트 개발 설정 완벽 가이드

RooCode는 VS Code에 멀티 에이전트 개발 기능을 추가합니다. 설치 및 인증 후, 채팅 인터페이스가 열리며 메시지 큐, 모드 선택, AI 모델 선택, 자동 승인 설정이 가능합니다. 프로젝트 인덱싱은 Qdrant 벡터 데이터베이스를 연결하여 파일 분석을 수행하며, LLM이 생성하는 편집의 정확도를 향상시킵니다.

설정은 논리적인 순서로 진행됩니다: 인덱싱부터 권한, 마켓플레이스, 알림, 프롬프트까지. 이렇게 하면 반복 작업을 최소화하고 워크플로우 속도를 높일 수 있습니다.

인덱싱 및 벡터 처리

벡터화 및 그래프 처리를 위한 공급자를 연결하세요. Qdrant 엔드포인트를 지정하면 인덱싱 결과가 저장됩니다. LLM은 프로젝트 컨텍스트를 받아 환각 없이 관련성 높은 변경사항을 생성합니다.

메인 창에서 인덱싱을 활성화하세요. 디렉토리 스캐닝을 통해 모델이 편집 중에 코드베이스를 참조할 수 있습니다.

자동 승인: LLM 작업 제어하기

LLM이 요청 수나 비용 제한 내에서 함수를 실행하도록 허용합니다. 콘솔 명령어(실행)의 경우 화이트리스트/블랙리스트를 구성하세요.

• 허용된 명령어: 필요할 때마다 추가하며, RooCode는 새로운 명령어에 대해 확인을 요청합니다.
• 제한: 자동 모드에서 토큰 과사용을 방지합니다.
• 위험한 작업: sudo나 시스템 호출은 수동 확인이 필요합니다.

이렇게 하면 자율성과 안전성을 균형 있게 유지할 수 있습니다.

MCP 서버 및 모드 마켓플레이스

git, 파일시스템, qdrant를 위한 준비된 MCP(Model Control Protocol) 서버를 설치하세요. 글로벌 서버는 마켓플레이스에서 제공되며, 프로젝트별 서버는 .roo에 로컬로 저장됩니다.

MCP 예시:

• mcp-git: CLI 없이 리포지토리 작업 수행
• mcp-filesystem: 파일 읽기/쓰기
• mcp-qdrant: 벡터 검색

모드는 작업을 위한 사전 구성된 에이전트입니다. 다운로드하여 맞춤 설정하세요.

알림 및 UI 설정

확인, 루프 중단, 완료에 대한 알림을 활성화하세요. 볼륨을 조정할 수 있습니다.

UI 옵션:

• 디버깅 로직을 위해 모델 추론 확장
• Ctrl+Enter로 전송(실수로 Shift+Enter 누르는 것 방지)
• 백그라운드 편집—창 깜빡임 없이 편집

프롬프트 및 실험적 기능

내장 프롬프트를 편집하세요. Enhance는 쿼리를 재구성하며, 문서 우선 및 TDD를 강제합니다.

다음 프롬프트의 향상된 버전을 생성하세요(향상된 프롬프트만 답변하세요 — 대화, 설명, 도입 텍스트, 글머리 기호, 자리 표시자, 따옴표는 포함하지 마세요).

향상 시 다음을 준수해야 합니다:
- 사용자의 원래 의도와 제약 조건을 유지하세요; 의미를 바꾸는 새로운 요구사항을 추가하지 마세요.
- 명확성, 구조, 구체성, 테스트 가능성을 개선하세요; 모호성과 약한 표현을 제거하세요.
- **문서 우선** 및 **TDD**를 기본 실행 워크플로우로 명시적으로 강제하세요:
  1) 프로젝트 문서와 `memory-bank/`를 단일 진실 공급원(예: productContext, activeContext, systemPatterns)으로 삼아 읽고 의존하는 것으로 시작하세요.
  2) 요청이 논리/아키텍처/동작 변경을 암시한다면, 프로덕션 코드 작성 전에 관련 문서/사양을 업데이트하세요(또는 RFC 초안 작성).
  3) 엄격한 TDD(Red → Green → Refactor)를 따르세요: 실패하는 테스트를 먼저 작성하고, 통과하는 최소한의 코드를 구현한 후, SOLID/DRY 원칙에 따라 리팩터링하세요.
- 새로운 동작과 결정을 반영하기 위해 `memory-bank/`(최소한 activeContext/progress 및 영향받는 컨텍스트 문서) 업데이트를 요구하세요.
- 요청에 맞는 명확한 완료 정의(테스트 통과, 문서 업데이트, 동작 검증)를 포함하세요, 불필요한 범위를 추가하지 마세요.

향상할 프롬프트는 다음과 같습니다:

${userInput}

실험적: 모드/스킬을 위한 슬래시 명령어.

스킬: 구조 및 카테고리

스킬은 마크다운 형식의 에이전트 지침입니다. 글로벌(~/.roo/skills)이나 프로젝트(.roo/skills)에 배치하세요.

스킬 구조:

---
name: mcp-time
description:
context:
compatibility:
---

# <제목>

## 도구
| 도구 | 용도 |
|------|---------|
| | |

## 사용 시기

## 사용 효과 및 모범 사례

#### ❌ 나쁜 사례 (시간 환각)

#### ✅ 좋은 사례 (시간 확인)

### 디버깅 전략

## 사용 이유

## CLI 대안
| MCP 작업 | CLI 동등 명령어 |
|------------|----------------|
| | |
| | |
| | |
| | |

카테고리:

• mcp-*: MCP 서버(git, 파일시스템, qdrant, redis).
• cli-*: 콘솔 명령어(docker, systemd, sudo).
• usr-*: 작업용 맞춤형.

예시 세트:

• cli-database, cli-docker, mcp-git, mcp-memory, mcp-playwright.

핵심 요약

• Qdrant를 통한 인덱싱으로 수동 복사-붙여넣기 없이 컨텍스트 인식 편집 가능.
• 자동 승인 + 제한으로 자율 모드에서 LLM 남용 방지.
• 스킬로 성공률 향상, CLI 호출 최소화.
• 프롬프트의 TDD로 테스트 가능한 변경 보장.
• 백그라운드 편집으로 에이전트 편집 중 집중력 유지.

— Editorial Team