메뉴
사용자 자연어 질의를 받아 의도를 분류하고 적절한 검색층으로 라우팅한다. lookup(키워드/의미)은 Grep + Dataview, 관계/경로 탐색은 services/graph/query_graph.py 의 고정 Cypher 템플릿. 자연어 → Cypher 자동 생성 절대 금지. 결과는 LLM 컨텍스트로 주입 가능한 요약 + 출처 wikilink 리스트. 사용자가 "찾아줘", "어디 있어", "관계가 뭐야", "/query <질문>" 같은 형태로 호출하면 발동.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
매일 외부 자료 5 건을 검색·요약해 vault/02_wiki/digests/YYYY-MM-DD.md 로 저장하고 Slack 통지(선택). vault/positioning.md (사용자 관심사·금기) + 기존 topics 를 컨텍스트로 사용. 수동 호출은 "/daily-digest" 또는 daily-digest routine (매일 07:00 KST) 만. 자동 발사 금지.
vault/02_wiki/ 전체를 검사해 SCHEMA.md 위반·orphan·stale·반각공백·끊긴 wikilink·duplicate id 를 검출하고 리포트를 vault/02_wiki/_lint/YYYY-MM-DD.md 에 저장한다. 사용자가 "lint 해줘", "위키 검사해줘" 같은 요청을 하거나 weekly-lint routine이 호출할 때 발동한다.
vault/02_wiki/topics/ 의 reviewed/published 페이지 1건 또는 .claude/queue/graph.txt 의 누적 변경분을 Neo4j 그래프에 upsert 한다. services/graph/ingest_graph.py 를 호출하며 dry-run 옵션 지원. PostToolUse hook 이 큐를 채우고 sleep-maintenance routine 또는 사용자가 명시적으로 호출했을 때 발동한다. graph_synced_at frontmatter 를 갱신한다.
vault/02_wiki/_drafts/ 의 draft 1건을 사람 승인 후 vault/02_wiki/topics/ 또는 decisions/ 로 승급한다. 승급 전 lint 동등 검사를 수행해 ERROR 가 있으면 거부한다. status 를 draft → reviewed 로 갱신하고 index.md 에 등록하며 log.md 에 기록한다. 사용자가 명시적으로 "/compile <draft_path>" 라고 호출했을 때만 발동한다 (자동 호출 금지).
세션 종료(Stop hook) 시 자동 호출. 그 세션에서 vault/02_wiki/ 가 변경됐다면 모순 검사 (덮어쓴 결정·CONTRADICTS 신규 등) 수행. 모순 발견 시 exit 2 로 세션 종료 차단 (사람 검토 강제). log.md 에 정정 메모 1 줄 append. 사용자가 명시적으로 "/evening-reflect" 로 호출해도 발동.
vault/01_raw/ 의 새 파일 1건을 읽어 vault/02_wiki/_drafts/ 에 토론형 wiki draft 1개를 생성한다. raw는 절대 수정하지 않으며, 결과는 사람이 검토할 수 있도록 draft 상태로만 남긴다. raw에 새 파일이 추가됐거나 사용자가 명시적으로 "이거 ingest 해줘" 같은 요청을 한 경우에 발동한다.
| name | query |
| description | 사용자 자연어 질의를 받아 의도를 분류하고 적절한 검색층으로 라우팅한다. lookup(키워드/의미)은 Grep + Dataview, 관계/경로 탐색은 services/graph/query_graph.py 의 고정 Cypher 템플릿. 자연어 → Cypher 자동 생성 절대 금지. 결과는 LLM 컨텍스트로 주입 가능한 요약 + 출처 wikilink 리스트. 사용자가 "찾아줘", "어디 있어", "관계가 뭐야", "/query <질문>" 같은 형태로 호출하면 발동. |
| disable-model-invocation | false |
| allowed-tools | ["Read","Grep","Glob","Bash(rg:*)","Bash(find vault:*)","Bash(python3 services/graph/query_graph.py:*)"] |
자연어 질의를 받아 3 가지 의도 분류 후 적절한 검색층에 위임. 답변 합성 직전까지가 본 Skill 의 책임이며, 최종 답은 메인 세션이 사용자에게 보여준다 (이 Skill 은 후보 + 출처만 모아줌).
question (필수): 자연어 한 줄. 예시: "GraphRAG 가 뭐였지", "Anthropic 이 어떤 기술 쓰지", "raw 정리 정책 어디 적혔어"mode? (선택): local | graph | auto. 미지정 시 자동 분류| 의도 | 신호 키워드 | 라우팅 |
|---|---|---|
| lookup | "어디", "뭐였지", "뭐야", "찾아줘", "정의", "어떻게 적혔어" | local (Grep + Dataview) |
| relation | "관계", "경로", "→", "어떤 X 쓰지", "왜 그게 X 와", "연결" | graph (Cypher 템플릿) |
| complex | "X 의 Y 와 어떤 차이", "전체 그림", "summary" | both (local → graph 보완) |
매칭 안 되면 기본은 local.
vault/02_wiki/self/ 본문 인용 — frontmatter 만 표시[[slug]] 또는 raw 경로로 출처 명시mode 인자 우선local 분기:
rg -l --type md '<question 핵심 키워드>' vault/02_wiki/topics vault/02_wiki/decisions
# 또는 자세히
rg --type md -C 2 '<키워드>' vault/02_wiki/topics
graph 분기:
python3 services/graph/query_graph.py --listpython3 services/graph/query_graph.py <template> --param key=value --env .envboth 분기:
[[slug]] 또는 vault/02_wiki/topics/<slug>.md 명시sources frontmatter 의 raw)/compile 등)사용자: /query GraphRAG 가 뭐였지
Claude: [의도] lookup (키워드 "뭐였지")
[local] rg 'GraphRAG' vault/02_wiki/topics
→ 2 건: [[graphrag-poc-with-neo4j]], [[2do-brain-architecture]]
[출처] frontmatter id 2 건, sources raw 1 건
답변 후보:
- [[graphrag-poc-with-neo4j]] — Neo4j + 고정 Cypher 로 인과 경로 추출·검증
- [[2do-brain-architecture]] — 전체 5층 청사진 중 L3 (그래프 층)
자세히 보려면 vault/02_wiki/topics/2026-05-17-graphrag-poc-with-neo4j.md 열기.
사용자: /query Anthropic 이 어떤 기술 쓰지
Claude: [의도] relation (키워드 "어떤 X 쓰지")
[graph] query_graph.py causal_path --param company_canonical=Anthropic
→ (Neo4j 미기동 → dry-run, Cypher 만 출력)
Neo4j 미기동 상태입니다. docker compose up -d 후 다시 호출하세요.
또는 local 검색으로 대체: [[2do-brain-architecture]] 의 "Claude Code 메커니즘" 섹션 참조.