클로드스킬마트스킬 둘러보기바로 쓰는 문장영상으로 배우기터미널 사용법스킬이 뭐예요?
 
← 목록으로

AgentDB 성능 최적화

AgentDB 벡터 DB의 메모리와 검색 속도를 양자화·HNSW·캐시·배치 설정으로 튜닝하는 가이드 스킬.

개발·코딩중급★ 349⑂ 27AI 점수 7/10마지막 업데이트: 2026. 7. 28.

무엇을 해주나

  • AgentDB(agentic-flow의 reasoningbank 어댑터) 설정을 목적에 맞게 잡아줍니다.
  • 양자화 4종(binary 32배, scalar 4배, product 8~16배, none)의 메모리·정확도 트레이드오프를 비교해 선택을 돕습니다.
  • HNSW 파라미터(M, efConstruction, efSearch)를 데이터 규모별로 추천합니다.
  • 캐시 크기, LRU 히트율 모니터링, 배치 삽입/병렬 검색, 패턴 통합(consolidation)·프루닝 방법을 정리합니다.
  • "최대 속도 / 균형 / 최대 정확도 / 모바일" 4가지 즉시 적용 가능한 설정 레시피와 트러블슈팅 항목을 제공합니다.

이런 분께 추천

  • AgentDB 또는 agentic-flow 기반 에이전트 메모리를 운영 중인 개발자
  • 벡터 수가 수십만~수백만 개로 늘어나 검색 지연·메모리 사용량이 문제인 경우
  • 엣지/모바일처럼 메모리 제약이 있는 환경에 벡터 검색을 얹어야 하는 경우

활용 예시

  1. "1M 벡터로 3GB를 쓰고 있는데 줄여줘" → binary 양자화 + cacheSize 2000 + hnswM 32 설정을 제안받고 96MB 수준으로 축소.
  2. "검색이 150ms 걸린다" → HNSW efSearch/k 조정과 캐시 확대, npx agentdb@latest stats로 히트율 확인 절차 안내.
  3. "문서 100개를 넣는데 1초씩 걸린다" → 개별 삽입 대신 배치 패턴 구성 코드로 교체.

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/spencermarx/open-code-review/HEAD/.claude/skills/agentdb-optimization/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 spencermarx/open-code-review 의 .claude/skills/agentdb-optimization 폴더를 내 ~/.claude/skills/agentdb-performance-optimization/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/spencermarx/open-code-review.git && mkdir -p ~/.claude/skills && cp -r open-code-review/.claude/skills/agentdb-optimization ~/.claude/skills/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 엽니다.
  2. 저장소를 클론합니다: git clone https://github.com/spencermarx/open-code-review.git
  3. 스킬 폴더를 만듭니다: mkdir -p ~/.claude/skills
  4. 스킬을 복사합니다: cp -r open-code-review/.claude/skills/agentdb-optimization ~/.claude/skills/
  5. 사전 준비: Node.js 18 이상, AgentDB v1.0.7 이상(agentic-flow 경유)이 설치되어 있어야 합니다.
  6. Claude Code를 재시작하고 "AgentDB 메모리 사용량을 줄여줘" 같이 요청하면 스킬이 발동합니다.
  7. 실제 적용 전 npx agentdb@latest benchmark와 stats로 자신의 환경 수치를 먼저 측정하세요.
GitHub에서 원본 보기 ↗라이선스: Apache-2.0