지식 캡처
대화와 노트를 구조화되고 링크 가능한 Notion 페이지로 변환하여 쉽게 재사용할 수 있도록 합니다.
빠른 시작
- 캡처할 내용(결정, 사용 방법, FAQ, 러닝, 문서)과 대상 독자를 명확히 합니다.
reference/에서 올바른 데이터베이스/템플릿(팀 위키, 사용 방법, FAQ, 결정 로그, 러닝, 문서)을 식별합니다.Notion:notion-search→Notion:notion-fetch로 Notion에서 이전 컨텍스트를 가져옵니다(업데이트/링크할 기존 페이지).- 데이터베이스 스키마를 사용하여
Notion:notion-create-pages로 페이지를 초안합니다. 요약, 컨텍스트, 소스 링크, 태그/소유자를 포함합니다. - 허브 페이지 및 관련 레코드에서 링크합니다. 소스가 변경됨에 따라
Notion:notion-update-page로 상태/소유자를 업데이트합니다.
워크플로우
0) Notion MCP가 연결되지 않아 MCP 호출이 실패하면, 일시 중지하고 설정합니다:
- Notion MCP 추가:
codex mcp add notion --url https://mcp.notion.com/mcp
- 원격 MCP 클라이언트 활성화:
config.toml에서[features].rmcp_client = true설정 또는codex --enable rmcp_client실행
- OAuth로 로그인:
codex mcp login notion
로그인 성공 후, 사용자는 codex를 다시 시작해야 합니다. 답변을 마치고 다시 시도할 때 1단계를 계속할 수 있도록 사용자에게 알리세요.
1) 캡처 정의
- 목적, 독자, 최신성, 새 페이지인지 업데이트인지 질문합니다.
- 콘텐츠 유형을 결정합니다: 결정, 사용 방법, FAQ, 개념/위키 항목, 러닝/노트, 문서 페이지.
2) 대상 위치 찾기
reference/*-database.md가이드를 사용하여 올바른 데이터베이스를 선택합니다. 필수 속성(제목, 태그, 소유자, 상태, 날짜, 관계)을 확인합니다.- 여러 후보 데이터베이스가 있으면 사용자에게 어떤 것을 사용할지 묻습니다. 그렇지 않으면 기본 위키/문서 DB에서 생성합니다.
3) 추출 및 구조화
- 대화에서 사실, 결정, 행동 및 근거를 추출합니다.
- 결정의 경우 대안, 근거 및 결과를 기록합니다.
- 사용 방법/문서의 경우 단계, 사전 요구 사항, 자산/코드 링크 및 엣지 케이스를 캡처합니다.
- FAQ의 경우 간결한 답변과 심화 문서 링크가 있는 Q&A 형태로 작성합니다.
4) Notion에서 생성/업데이트
- 올바른
data_source_id로Notion:notion-create-pages를 사용합니다. 속성(제목, 태그, 소유자, 상태, 날짜, 관계)을 설정합니다. reference/의 템플릿을 사용하여 콘텐츠를 구조화합니다(섹션 헤더, 체크리스트).- 기존 페이지를 업데이트하는 경우
Notion:notion-update-page를 통해 가져온 후 편집합니다.
5) 연결 및 표시
- 허브 페이지, 관련 사양/문서 및 팀에 대한 관계/백링크를 추가합니다.
- 미래의 독자를 위해 간단한 요약/변경 로그를 추가합니다.
- 후속 작업이 있으면 관련 데이터베이스에 작업을 생성하고 링크합니다.
참조 및 예제
reference/— 데이터베이스 스키마 및 템플릿 (예:team-wiki-database.md,how-to-guide-database.md,faq-database.md,decision-log-database.md,documentation-database.md,learning-database.md,database-best-practices.md).examples/— 실제 캡처 패턴 (예:decision-capture.md,how-to-guide.md,conversation-to-faq.md).