ingest
새롭게 추가된 원본 파일(sources/ 하위)을 탐색하고, 내용을 요약한 뒤 사용자 인터뷰를 거쳐 wiki/ 폴더에 인제스트 및 인덱스/로그를 자동 동기화합니다.
SKILL.mdskills/ingest/SKILL.md
GitHubIngest (지식 수집 및 위키 인제스트)
Overview
이 스킬은 sources/ 폴더 내에 수석님이 새로 스크랩하거나 추가한 원본 파일을 감지하여 읽고, 핵심 요약 및 엔티티를 정제한 뒤 사용자(수석님)와의 3가지 인터뷰 질문 대화를 통해 최종적으로 wiki/ 지식 저장소에 연동하는 워크플로우를 자동화합니다.
Dependencies
없음
Quick Start
수석님이 "방금 저장한 글 인제스트해줘" 또는 /ingest라고 요청하면 작동을 시작합니다.
Workflow
1. 신규 소스 감지 및 본문 분석
sources/하위 디렉토리(insights/,academic/,meetings/,business/)에서 최근에 생성되거나 변경된 마크다운(*.md) 파일을 탐색합니다. (README.md, AGENTS.md 및 시스템 파일 제외)- 해당 원본 파일을 읽고 내용을 분석합니다. (주의:
sources/내의 원본 파일은 불변이며 절대 수정하지 않습니다.)
2. 소스 1차 요약 생성
- 수집한 파일의 본문을 분석하여 다음 3가지 항목을 먼저 정제해 사용자에게 보여줍니다.
- 핵심 주장 (Key Claims)
- 언급된 엔티티 (사람, 도구, 조직)
- 다루는 개념 (Concepts)
3. 사용자 목적성 인터뷰 (인터랙션)
- 분석 결과와 함께 사용자에게 아래 3가지 인터뷰 질문을 명확하게 건넵니다.
- "이 글을 왜 캡처했어?"
- "지금 하고 있는 일과 어떻게 연결돼?"
- "이걸로 뭘 해보고 싶어?"
- 사용자의 답변을 기다립니다.
4. 위키(wiki/) 지식 연동 및 색인/로그 업데이트
- 사용자의 답변이 입력되면 아래 4가지 작업을 순차적으로 실행합니다.
- 소스 요약 파일 생성:
wiki/Source_<적절한이름>.md파일을 생성합니다. 상단에 YAML Frontmatter를 규격에 맞춰 작성하고, 인터뷰 답변(수집 목적, 업무 연결성, 실행 계획)과 소스 1차 요약을 기록합니다. - 개념/엔티티 파일 생성/업데이트: 소스에서 도출된 핵심 개념이나 엔티티가 기존
wiki/에 존재하는지 확인하고, 해당 문서를 업데이트하거나 새 개념 문서(wiki/Concept_<개념명>.md)를 생성하여 양방향 링크([[WikiLink]])를 연결합니다. - 색인(index.md) 동기화: 신규 생성된 위키 페이지들을
wiki/index.md에 한 줄 설명(120자 이내)과 함께 추가합니다. - 로그(log.md) 기록: 이번 인제스트 오퍼레이션 내역(CREATE, UPDATE)을 타임라인 순으로
wiki/log.md에 추가합니다.
- 소스 요약 파일 생성:
Common Mistakes
- 소스 원본 수정 금지:
sources/안의 파일 내용을 수정하거나 변경 로그에 기록되지 않은 다른 조작을 가하면 안 됩니다. - 단선 인덱스 미준수:
index.md에 여러 줄의 요약을 적지 않도록 한 줄(120자) 제약을 반드시 준수해야 합니다.