에이전트 메모리 스킬
이 스킬은 프로젝트 문서와 자동으로 동기화되는 영구적이고 검색 가능한 메모리 뱅크를 제공합니다. MCP 서버로 실행되어 장기 기억의 읽기/쓰기/검색을 가능하게 합니다.
사전 요구 사항
- Node.js (v18+)
설정
-
저장소 클론:
agentMemory프로젝트를 에이전트 작업 공간이나 병렬 디렉토리에 클론합니다.git clone https://github.com/webzler/agentMemory.git .agent/skills/agent-memory -
의존성 설치:
cd .agent/skills/agent-memory npm install npm run compile -
MCP 서버 시작: 헬퍼 스크립트를 사용하여 현재 프로젝트에 메모리 뱅크를 활성화합니다.
npm run start-server <project_id> <absolute_path_to_target_workspace>현재 디렉토리 예시:
npm run start-server my-project $(pwd)
기능 (MCP 도구)
memory_search
쿼리, 유형 또는 태그로 메모리를 검색합니다.
- 인자:
query(문자열),type?(문자열),tags?(문자열 배열) - 사용법: "모든 인증 패턴 찾아줘" ->
memory_search({ query: "authentication", type: "pattern" })
memory_write
새로운 지식이나 결정을 기록합니다.
- 인자:
key(문자열),type(문자열),content(문자열),tags?(문자열 배열) - 사용법: "이 아키텍처 결정 저장해줘" ->
memory_write({ key: "auth-v1", type: "decision", content: "..." })
memory_read
특정 메모리 내용을 키로 조회합니다.
- 인자:
key(문자열) - 사용법: "인증 설계 불러와줘" ->
memory_read({ key: "auth-v1" })
memory_stats
메모리 사용량에 대한 분석을 봅니다.
- 사용법: "메모리 통계 보여줘" ->
memory_stats({})
대시보드
이 스킬에는 메모리 사용량을 시각화하는 독립형 대시보드가 포함되어 있습니다.
npm run start-dashboard <absolute_path_to_target_workspace>
접속 주소: http://localhost:3333
사용 시기
이 스킬은 개요에 설명된 워크플로우나 작업을 실행할 때 적용 가능합니다.
제한 사항
- 이 스킬은 작업이 위에서 설명한 범위와 명확히 일치할 때만 사용하십시오.
- 출력을 환경별 검증, 테스트 또는 전문가 검토를 대체하는 용도로 사용하지 마십시오.
- 필요한 입력, 권한, 안전 경계 또는 성공 기준이 누락된 경우 중단하고 명확히 설명을 요청하십시오.