무엇을 하는가
/tip-ingest는 URL(블로그/공식 문서/X/Reddit)이나 GitHub Issue 제보를 분석해
FableIt 팁 스키마(MDX + 프론트매터)에 맞는 문서를 생성합니다. 주 사용자는 사이트
운영자(콘텐츠 파이프라인)지만, 누구나 "팁 정리 도구"로 쓸 수 있습니다.
핵심은 검증 상태 판정입니다 — 주장이 공식 문서와 일치하면 official, 커뮤니티
실측이면 community, 재현 조건이 불명확하면 unverified로 표기하고, 자기 보고
수치·공식 권고와 충돌하는 주장은 본문에 캐비어트로 승계합니다. 관련 가이드
카테고리(relatedGuides) 연결까지 만들어 사이트의 가이드 딥링크가 함께 렌더됩니다.
사용법
/tip-ingest <URL>
/tip-ingest --issue <GitHub Issue URL 또는 본문 붙여넣기>--issue 모드는 사이트의 팁 제보 Issue Form을 그대로 파싱합니다 (필드 id가 스키마와
대응).
동작 원칙
- 출처 필수: 원문 URL을 확보할 수 없는 팁은 생성하지 않습니다. Issue 제보의 본인 경험담은 Issue URL을 출처로 기록합니다
- 캐비어트 승계: 미검증 주장은 공식 사실처럼 승격하지 않고 "자체 보고 수치, 독립 검증되지 않음" 등을 본문에 명시합니다
- 사례와의 경계: 프롬프트 시연·결과물 중심 게시물은 팁이 아니라 사례입니다 —
판정 후
/case-ingest로 안내합니다 - FableIt 저장소 안에서 실행하면
web/content/tips/{slug}.mdx저장과pnpm validate:content실행까지 수행하고, 밖에서는 MDX만 출력합니다
잘 쓰는 팁
- X 등 접근이 차단된 URL은 본문을 붙여넣어 달라는 폴백 안내가 나옵니다
- 기존 팁과 주제가 겹치면 새 파일 대신 기존 팁 보강을 제안합니다
- 모델 수치(가격·전환일 등)는 하드코딩되지 않고
<Fact />컴포넌트로 들어갑니다 — 수치가 바뀌어도 팁 본문을 고칠 필요가 없습니다
관련 가이드
- 사고 제어: thinking과 effort — 팁의 단골 주제
- 안전·refusal 대응 — 문제 해결(troubleshooting) 팁의 배경