capture-research

name	capture-research
description	현재 세션의 조사/분석/연구/평가 결과를 Obsidian vault ($VAULT_ROOT/001-INBOX/)에 한국어 마크다운 문서로 저장. frontmatter 자동 생성, vis hybrid search로 Related Notes 자동 추가. 외부 URL/YouTube 요약은 범위 밖.
allowed-tools	["Bash(echo:*)","Bash(ls:*)","Bash(find:*)","Bash(head:*)","Bash(tail:*)","Bash(lsof:*)","Bash(curl:*)","Bash(vis:*)","Bash(python3:*)","Bash(date:*)","Read","Write","Edit"]
when_to_use	Use when the user wants to save the current session's analysis, research, evaluation, comparison, or strategic recommendation as a detailed Korean Obsidian note in the vault's 001-INBOX folder. The input is the CURRENT SESSION CONTEXT (previous assistant turns or user-specified topic), NOT an external URL or YouTube video. Trigger phrases (Korean): "이 내용을 obsidian에 저장해줘", "vault에 저장", "분석 결과를 obsidian 문서로", "조사 결과 정리", "이번 세션 결과 저장", "세션 산출물 문서화", "이 내용을 자세히 작성해줘 (vault에)" Trigger phrases (English): "save this analysis to vault", "research to vault", "capture session to obsidian" Do NOT invoke for: - External URL summaries (use obsidian:summarize-article) - YouTube video summaries (use obsidian:summarize-youtube) - Adding Related Notes to existing files (use obsidian:related-contents) - Adding tags to existing files (use obsidian:add-tag)
argument-hint	[--brief|--standard|--detailed] [저장할 주제 힌트]
arguments	["length_mode","content_hint"]

Capture Session Research to Obsidian Vault

실행 모델 (필수)

~/.Codex/templates/delegation.md 변형 A 적용 (model="sonnet", run_in_background=false, args=skill 호출 인자, 옵션=--brief|--standard|--detailed)

main context에서 직접 실행 금지.

현재 세션의 조사/분석/연구/평가/비교/권고 결과를 Obsidian vault의 001-INBOX/ 폴더에 자세한 한국어 마크다운 문서로 저장합니다.

Inputs

• $length_mode: 길이 모드 — --brief (1-2KB), --standard (5-10KB), --detailed (15-30KB, 기본값)
• $content_hint: 저장할 주제 힌트 (선택). 없으면 세션 최근 assistant turn을 후보로 제시 후 사용자 확인

Goal

• 한국어 제목의 .md 파일이 $VAULT_ROOT/001-INBOX/에 저장됨
• frontmatter가 기존 vault 패턴과 일관 (title/aliases/tags hierarchical/created/author/source)
• 본문에 표·코드블록·wikilink 자연스럽게 포함 (기존 vault 2-3개 이상 연결)
• ## Related Notes 섹션에 vis hybrid search + rerank top 5 wikilink (1줄 컨텍스트)
• 저장 전 사용자가 frontmatter와 파일명 검토하고 승인

범위 (중요)

다루는 것: 세션 최근 turn의 분석·연구·평가·비교·결정·전략 권고. Codex가 정리한 도구 비교표, 아키텍처 권고, 로드맵, trade-off.

다루지 않는 것:

상황	사용할 skill
외부 URL 요약	obsidian:summarize-article
YouTube 영상 요약	obsidian:summarize-youtube
기존 vault 파일에 Related Notes 추가	obsidian:related-contents
기존 vault 파일 태그 추가	obsidian:add-tag

Steps

1. 입력 파악

• $content_hint 있으면 → 저장 주제 확정
• 없으면 세션 최근 2-3 turn 요약을 사용자에게 제시:

  "다음 내용을 저장할까요?\n[요약 2-3 문장]\n\n다른 주제면 알려주세요."

• $length_mode 기본 --detailed

Success criteria: 저장 주제 + 길이 모드 확정.

Human checkpoint: 주제 모호 시 확인 후 진행.

2. Vault 컨텍스트 학습

echo "${VAULT_ROOT:?VAULT_ROOT 환경변수 미설정}"
INBOX="$VAULT_ROOT/001-INBOX"

find "$INBOX" -maxdepth 2 -name "*.md" -type f -print0 2>/dev/null \
  | xargs -0 ls -t 2>/dev/null | head -5 \
  | while read f; do echo "--- $(basename "$f") ---"; head -20 "$f"; echo ""; done

수집: tags 계층, aliases 패턴, source 형식, 커스텀 필드.

Success criteria: 최소 3개 기존 파일 frontmatter 샘플 확보.

3. Frontmatter 초안 생성

---
title: "한국어 제목 — 핵심 구분"
aliases:
  - 동일 개념 다른 표현
  - 영문 검색 alias
created: YYYY-MM-DD
author: msbaek
source: "session 분석 (YYYY-MM-DD, 프로젝트명)"
tags:
  - ai/tools/Codex
  - ai/Codex/memory
  - knowledge-management/second-brain
related: []
---

Rules:

• tags hierarchical (/), 기존 vault tag 2개 이상 재사용
• aliases 2-3개 (한국어 + 영문)
• created = date +%Y-%m-%d
• author 항상 msbaek
• source는 세션 컨텍스트 (URL 아님)
• related: [] 빈 배열 (Related Notes는 본문 섹션)

Success criteria: YAML valid, 필수 필드, 기존 tag 2개 이상 재사용.

4. 파일명 생성

• 한국어 dash-separated, 최대 80자
• 핵심 키워드 3-5개 연결
• 충돌 시 -2, -3 suffix

FILENAME="한국어-키워드1-키워드2-키워드3.md"
FULLPATH="$INBOX/$FILENAME"
if [ -e "$FULLPATH" ]; then
  BASE="$(basename "$FILENAME" .md)"
  N=2
  while [ -e "$INBOX/${BASE}-${N}.md" ]; do N=$((N+1)); done
  FILENAME="${BASE}-${N}.md"
  FULLPATH="$INBOX/$FILENAME"
fi

Success criteria: 80자 이내, 충돌 없음.

5. 본문 작성

모드	크기	구조
--brief	1-2KB	TL;DR + 핵심 결론 2-3개 + 1 표
--standard	5-10KB	TL;DR + 3-5 섹션 + 표 1-2개 + 코드 1-2개
--detailed	15-30KB	TL;DR + 배경 + 진단 + 다차원 비교 + 갭/솔루션 + 로드맵 + anti-pattern + 트러블슈팅 + 결론 + 참고자료

Rules:

• 본문 한국어, 기술 용어 영어 그대로
• 표: pipe-markdown, 코드블록: 언어 명시
• wikilink [[Note-Name]]로 기존 vault 문서 최소 2-3개 연결
• 섹션 번호 매김
• U-shaped attention: TL;DR 맨 앞, 결론 맨 끝

Human checkpoint: --detailed라도 주제 간단 시 15KB면 충분 — 억지 늘림 금지.

Success criteria: 모드별 적정 길이, 필수 요소 포함.

6. vis daemon 자동 처리 + Related Notes 검색

# 6a. daemon 확인
if ! lsof -nP -iTCP:8741 -sTCP:LISTEN >/dev/null 2>&1; then
  vis serve
fi

# 6b. 인덱스 준비 대기 (최대 60초)
for i in {1..12}; do
  STATUS=$(curl -s "http://localhost:8741/health" 2>/dev/null \
    | python3 -c "import sys,json; d=json.load(sys.stdin); print(f\"indexed={d.get('indexed')}\")" 2>/dev/null || echo "loading")
  echo "[${i}/12] $STATUS"
  [[ "$STATUS" == *"indexed=True"* ]] && break
  sleep 5
done

# 6c. hybrid search + rerank (2-4 query, 다양성)
parse_results() {
  python3 -c "
import sys, json, os
d = json.load(sys.stdin)
VR = os.environ.get('VAULT_ROOT','')
for r in d.get('results', [])[:8]:
    p = r['path'].replace(VR, '').lstrip('/')
    print(f\"{r['score']:.3f}|{p}|{r.get('snippet','')[:120]}\")
"
}

for Q in "핵심 키워드 1" "핵심 키워드 2" "다른 각도 키워드"; do
  echo "=== Q: $Q ==="
  curl -s --get --data-urlencode "query=$Q" \
    "http://localhost:8741/search?search_method=hybrid&rerank=true&top_k=8" \
    | parse_results
done

Rules 선별 기준:

• self(생성 중 파일) 제외
• daily notes(notes/dailies/, dailies/) 제외
• 점수 < 1.0 skip
• 카테고리 다양성 (한 주제만 5개 X)

Success criteria: 5개 후보, 각 점수 > 1.0 또는 명확히 관련.

7. Related Notes 섹션 추가

## Related Notes

- [[Note-Name-1]] — 1줄 컨텍스트 (왜 관련, 어떤 측면)
- [[Note-Name-2]] — ...
- [[Note-Name-3]] — ...
- [[Note-Name-4]] — ...
- [[Note-Name-5]] — ...

Rules:

• 정확히 5개
• 각 1줄 컨텍스트 필수
• wikilink는 .md 제외
• 실존 파일 검증

Success criteria: 5 wikilink, 모두 실존, 각 의미 있는 컨텍스트.

8. 사용자 검토 prompt → 저장

사용자에게 제시:

### 검토 요청
- 파일: $VAULT_ROOT/001-INBOX/<filename>.md
- frontmatter: title/aliases/tags/source
- 본문: ~XKB, N개 섹션
- Related Notes: [[a]], [[b]], [[c]], [[d]], [[e]]

Human checkpoint (필수):

• OK → Write tool 저장 + 경로 보고
• 수정 요청 → 해당 부분 수정 후 재확인 (최대 3회)
• 취소 → 저장 없이 종료

Success criteria: 사용자 승인, Write 성공, 경로 + 크기 보고.

Anti-Patterns (절대 금지)

Anti-pattern	이유
외부 URL을 입력으로 받아 저장	범위 밖 — obsidian:summarize-article
YouTube 영상 요약	범위 밖 — obsidian:summarize-youtube
frontmatter 100% 자동 저장	Step 8 human checkpoint 필수
001-INBOX 외 폴더에 저장	정책상 hardcoded, --dir 미지원
daily notes를 Related Notes에 포함	<when-creating-obsidian-document> 룰 위반
Related Notes ≠ 5개	정책상 정확히 5개
Related Notes 1줄 컨텍스트 생략	품질 저하
본문 영어 작성	한국어 기본 (기술 용어만 영어)
80자 초과 파일명	가독성/호환성
vis daemon 실패 시 Related Notes 생략 저장	Step 7 실패 = skill 전체 실패로 보고

좋은 예시 (참조)

$VAULT_ROOT/001-INBOX/Codex-세션-메모리-효율화-전략-Codex-mem-대안.md

• 26KB, 605줄, 11 섹션
• 11 hierarchical tags, 3 aliases
• 11 표 + 5 코드블록
• 5 Related Notes (각 1줄 컨텍스트)
• 8 wikilink (본문 + Related Notes)

이 파일 구조가 --detailed 모드의 기준입니다.