Communitygithub.com

spikesubingrui-design/u

U — 에이전트가 당신에 대해 기억하는 것이 Obsidian 그래프로 시각화됩니다. OpenClaw + gbrain 지식 그래프, 하나의 보관소, 중복 수집 제로.

u란 무엇인가요?

U는 OpenClaw의 memory_search와 gbrain의 Postgres 지식 그래프가 에이전트에게는 보이지만 인간에게는 보이지 않는 문제를 해결합니다. 이 스킬은 gbrain 위키를 Obsidian 볼트로 열고, OpenClaw의 memory/ 디렉토리를 심볼릭 링크로 연결하며, 선택적으로 gbrain export 명령어로 DB 페이지를 마크다운 파일로 변환하여 하나의 파일 세트를 세 가지 방식으로 인덱싱합니다. 이를 통해 사용자는 Obsidian의 그래프 뷰에서 에이전트가 기록한 메모, 프로젝트, 개념 간의 연결을 시각적으로 탐색할 수 있습니다. 또한, 분산 후보 추출 스크립트와 지식 큐레이션 헌법을 제공하여 유용한 지식만 선별하고 검색 파이프라인을 최적화합니다. Claude Code, Codex, Cursor 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, gbrain 및 Obsidian과의 완벽한 통합을 지원합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add spikesubingrui-design/u

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

U ——「당신」의 기억, 드디어 보이게 되다

문제: OpenClaw의 memory_search와 gbrain의 Postgres 그래프는 에이전트에게는 보이지만, 사람에게는 보이지 않습니다.
해법: Obsidian으로 gbrain wiki를 볼트로 열고, memory/ 일기를 심볼릭 링크로 연결하고, 선택적으로 gbrain export로 DB 페이지를 마크다운으로 변환합니다——하나의 파일 세트, 세 가지 인덱스.

이 스킬을 로드해야 하는 경우

  • 사용자가 Obsidian과 OpenClaw memory / gbrain을 연동하려고 할 때
  • 사용자가 "제2의 뇌 시각화", "memory 그래프", "점을 연결하여 면을 이루다", "Obsidian에서 에이전트가 쓴 기억을 보고 싶다"고 말할 때
  • 사용자가 이미 gbrain + ~/wiki(또는 유사한 마크다운 브레인 라이브러리)를 보유하고 있으며 GUI를 추가하려고 할 때

아키텍처 (한눈에 보기)

OpenClaw workspace/memory/*.md  ──symlink──►  ~/wiki/memory/     ◄── Obsidian 탐색
gbrain Postgres (426+ pages)   ──export──►  ~/wiki/**/*.md       ◄── Obsidian 그래프
Agent cron                     ──sync────►  Postgres + vectors   ◄── 백엔드 변경 없음

보안 제약 사항 (반드시 준수):

  • memory는 ~/wiki/.gitignore에 있어야 함 → gbrain sync는 git-diff 기반으로 작동하므로 일기가 중복으로 저장되지 않음
  • .obsidian/은 gbrain isSyncable에 의해 건너뛰어짐 (숨김 디렉토리)
  • alwaysUpdateLinks: true를 변경하지 마세요. Obsidian이 gbrain의 [[경로식]] 링크를 일괄적으로 다시 쓰는 것을 방지합니다.

Phase 0 — 경로 확인

변수기본값설명
WIKI_DIR~/wikigbrain git 저장소 루트
MEMORY_DIR~/.openclaw/workspace/memoryOpenClaw 일기 MD
GBRAIN_BINgbrainPATH 내 CLI

Phase 1 — 원클릭 설정 (권장)

bash skills/u/scripts/setup-vault.sh
# 또는 경로 지정:
WIKI_DIR=~/wiki MEMORY_DIR=~/.openclaw/workspace/memory bash scripts/setup-vault.sh

스크립트는 다음을 수행합니다: memory 심볼릭 링크 생성, .gitignore 작성, .obsidian/app.json 사전 설정 (wikilink + absolute + 자동 링크 변경 비활성화).

Phase 2 — DB 페이지 구체화 (선택 사항이지만 강력 권장)

Postgres에 디스크의 .md 파일보다 더 많은 페이지가 있는 경우 (일반적으로 MCP put_page가 DB에만 쓰는 경우):

gbrain export --dir "$WIKI_DIR"
cd "$WIKI_DIR" && git add -A && git commit -m "materialize gbrain pages for Obsidian"

구체화 후 Obsidian 그래프의 wikilink 해석율은 일반적으로 ~28%에서 **84%**로 상승합니다 (README 동일 기준).

Phase 3 — Obsidian 열기

  1. Obsidian → Open folder as vault → WIKI_DIR 선택
  2. 왼쪽 Graph view: people / projects / concepts / synthesis 클러스터 보기
  3. memory/2026-MM-DD.md 열기 → 오른쪽 Backlinks → Unlinked mentions에서 해당 일기를 참조하는 gbrain 페이지로 이동

Phase 4 — 검증 체크리스트

  • ls -la $WIKI_DIR/memory에 심볼릭 링크가 표시됨
  • cd $WIKI_DIR && git status에 memory/*.md가 나타나지 않음
  • 그래프에 연결선이 있음 ([[projects/foo]]가 해석되었음을 의미)
  • gbrain 페이지를 편집하고 저장한 후 git status에 변경 사항이 표시됨 (cron이 sync+embed 수행)

Phase 5 — 점을 연결하여 면을 이루기: 승화 후보 (선택 사항, v1.1)

그래프를 볼 수 있게 된 이후의 다음 문제: 일기에서 반복적으로 언급되는 주제를 어떻게 그래프 페이지로 만들까? 두 가지 잘못된 접근 방식이 흔히 보입니다—— 에이전트가 스스로 기록해야 한다고 판단하여 바로 페이지를 쓰는 경우 (잘못되어도 감독할 사람이 없어 그래프에 계속 남음); 또는 아무도 쓰지 않는 경우 (그래프가 항상 일기보다 뒤처짐). distill-candidates.py는 중간 경로를 따릅니다: 제안만 하고, 쓰지 않음.

python3 skills/u/scripts/distill-candidates.py --dry-run

실행하면 MEMORY_DIR에서 최근 14일 간의 일기를 스캔하고, WIKI_DIRS (기본값 people,companies,projects,concepts)에 있는 기존 페이지의 title/aliases를 기반으로 단어 목록을 작성한 후, "2일 이상에 걸쳐 반복적으로 나타나는" 주제를 찾아 distill-inbox.md 파일을 볼트 루트에 씁니다: A 구역은 기존 페이지에 반영되지 않은 주제, B 구역은 반복적으로 나타나지만 아직 페이지가 없는 후보입니다. --dry-run 없이 실행해야 실제로 파일이 생성됩니다; 파일이 생성되더라도 distill-inbox.md와 .distill_heartbeat.json 두 파일만 생성되며, memory/ 또는 그래프 페이지는 절대 건드리지 않습니다.

특정 후보를 수락한 후에는 사용자(또는 에이전트)가 해당 페이지를 업데이트하거나 새로 생성해야 합니다——이 단계는 의도적으로 사람에게 맡겨져 있으며, 이를 건너뛰는 것이 자동 기억 시스템에서 가장 함정이 되기 쉬운 부분입니다.

선택적으로 cron에 연결하여 큐가 매일 자동으로 새로고침되도록 할 수 있습니다 (여전히 제안만):

# OpenClaw
openclaw cron create --no-agent --script skills/u/scripts/distill-candidates.py "0 3 * * *"

Phase 6 — 큐레이션 헌법: 유용한 그래프, 예쁜 퇴적물이 아님 (v1.2)

큐 (Phase 5)가 "누가 검수할 것인가"를 해결했다면, 이제 "어떤 기준으로 쓸 것인가"가 남습니다. 방치하면 볼트의 두 번째 죽음의 방식은: 페이지는 계속 쌓여가고, 하나하나 완전해 보이지만, 미래의 실제 질문에 단 하나도 적중되지 않는——겉보기에는 완벽한 지식 포인트의 퇴적물이 되는 것입니다.

references/knowledge-curation.md는 그래프를 작성하는 에이전트를 위한 시스템 프롬프트로, 페이지를 생성/수정/분류하기 전에 먼저 읽어야 합니다. 핵심 판단 기준은 한 문장: 지식 페이지는 미래의 실제 질문에 적중되어 연결될 때에만 유용합니다.

  • 수집 삼문 (하나라도 '아니오'면 페이지 생성 금지): 행동을 바꾸는가? 다시 질문될 것인가? 모델 자체 지식보다 나은가?
  • 분류 루브릭: 각 디렉토리별 판단 기준 + 긍정/부정 예시, "에이전트 분류 불확실" 문제 해결
  • 밀도 기준: 추가보다 재작성 우선; 처음 세 줄이 중요; 모든 페이지에 "이 페이지가 답변할 수 있는 질문" 섹션 포함 (2–5개의 실제 질문)
  • ⭐ 질문-답변 환류: 에이전트가 좋은 답변을 종합했을 때 일기에 ⭐page-candidate: <제안 제목> (한국어 ⭐후보페이지: 도 가능) 한 줄을 기록, v1.2의 distill-candidates.py가 이를 큐 B 구역 최상단에 제안; 페이지 생성 후 ⭐를 ✅로 변경하면 더 이상 목록에 나타나지 않음. 큐를 우회한 직접 페이지 생성을 금지합니다.
  • D 구역 재구성 후보: 스크립트가 자동으로 "업데이트 패치로 가득 찬" 증식 페이지를 스캔, 수락 후 헌법 §5 템플릿에 따라 밀도 높은 단일 페이지로 재융합 (검증: 30% 이상 단축 + 정보 손실 제로)
  • 고급 (직접 연결 필요, 헌법 §6에 방법 있음): 검색 로그 miss→페이지 생성 신호, 45일 제로 히트→폐기 제안, 월간 모순 검사

헌법을 에이전트 명령어 (AGENTS.md / CLAUDE.md)에 연결하는 것은 한 줄이면 됩니다:

위키 페이지 생성/수정 전 skills/u/references/knowledge-curation.md를 먼저 읽으세요 (수집 삼문+루브릭+밀도 기준); 추가보다 재작성 우선.

Phase 7 — 검색 파이프라인: "두 가지 병합"에서 진정한 리콜로 (v1.3)

큐레이션 헌법이 "무엇을 쓸 것인가"를 해결했지만, 아직 절반이 남았습니다: "검색 가능한가". 실제 측정 결과: memory_search (키워드)와 gbrain query (벡터)를 단순히 병합하고, 점수별로 정렬한 후 top20을 자르는 방식은 실제 질문 ("XX는 누구인가"와 같은 완전한 문장)에 대해 10개 테스트 케이스 중 0개 적중, MRR 0. 근본 원인: 벡터 엔진은 다중 단어 중국어/의문문에 대해 직접적으로 제로 결과를 반환하며, 동일한 엔터티를 단일 단어로 쿼리하면 0.7+ 점수에 도달할 수 있습니다.

scripts/recall.mjs는 6단계 파이프라인으로 재작성되었으며, 동일한 평가 세트에서 0/10에서 10/10 (MRR 0→0.75)으로 개선되었습니다:

  1. 쿼리 정규화——원문 + 의문사 제거 핵심 문장 + 사용자 위키의 title/aliases로 구축된 엔터티 테이블에서 실질어 추출 + CJK 접두사 n-gram
  2. 이중 엔진 분업——키워드 엔진은 느리므로, 원문+2개 실질어만 전송; 벡터 엔진은 빠르므로, 모든 변형 전송
  3. RRF 융합 (k=60)——서로 다른 엔진의 점수는 비교할 수 없지만 순위는 비교 가능하므로 정규화 불필요
  4. 시간 감쇠 + 빈도——콘텐츠 카테고리별 반감기 설정, 하한 0.5로 강한 적중이 묻히는 것 방지
  5. MMR 중복 제거 (λ=0.7)——top-K가 유사한 중복 조각으로 채워지는 것 방지
  6. 단일 홉 그래프 확장——적중 페이지의 아웃링크 페이지를 할인하여 함께 가져오기
bun scripts/recall.mjs "<쿼리 또는 전체 질문>"

동반 평가 도구 scripts/recall-eval.mjs——"더 정확해진 느낌"은 결론이 아니며, 숫자를 확인해야 합니다. ops/recall-eval.example.jsonl (가상 예시)에서 시작하여 사용자의 실제 질문으로 교체:

bun scripts/recall-eval.mjs --eval ops/recall-eval.jsonl

recall.mjs의 매개변수를 변경하기 전에 먼저 평가 세트를 실행하세요. 감에 의존하지 마세요. 전체 설계 동기와 각 단계의 "이유"는 references/retrieval-pipeline.md를 참조하세요.

선택 사항: 정기적으로 평가 세트의 건강 상태를 확인하는 cron을 설정, 통과율이 임계값 아래로 떨어질 때만 경고하고, 모두 정상이면 조용히 유지——임베딩 만료, 엔진 중단, 매개변수 변경 등 스스로 알리지 않는 조용한 성능 저하를 방지합니다.

에이전트 작성 규율 (AGENTS.md 메모리 브리징과 일관성 유지)

사용자가 Obsidian에서 마크다운을 수동으로 편집한 후:

  • gbrain 측: link-maintenance / auto-ingest cron이 sync --no-embed + embed --stale 실행
  • memory 측: workspace/memory/에 있으며, memory_search에 의해 인덱싱됨, memory를 wiki git에 커밋하지 마십시오

문제 해결

증상처리
그래프가 매우 비어 있고, 많은 링크가 떠 있음gbrain export --dir $WIKI_DIR 실행
memory가 git에 나타남.gitignore에 memory가 포함되어 있는지 확인
Obsidian이 링크를 [text](path)로 변경useMarkdownLinks: false 확인
[[Naval Ravikant]]가 해석되지 않음표시 이름 링크; 대상 페이지에 frontmatter aliases 추가

관련 항목

  • skills/brain-ops — gbrain 작성 규칙
  • skills/memory-setup-openclaw — memory_search 설정
  • skills/planning-with-files — 긴 작업을 memory에 저장

상세 아키텍처와 mermaid 다이어그램은 references/architecture.md를 참조하세요.

관련 스킬