medium-ko-guide

Medium Korean Guide Converter

Medium 아티클을 한국어 마크다운으로 변환하는 skill입니다.

---

실행 방법

사용자가 다음 중 하나를 제공하면 변환을 시작합니다:

1. Medium URL
2. 저장된 HTML 파일 경로
3. 복사한 HTML 내용

---

3단계 파이프라인

Step 1: HTML 추출 (html-extractor agent)

Input: Raw HTML
Output: Structured JSON
Agent: html-extractor (model: haiku)

Task 도구로 html-extractor 에이전트를 호출:

• HTML에서 본문 콘텐츠 구조 추출
• 이미지 URL 및 캡션 보존
• 코드 블록, 리스트, 인용문 구조화

Step 2: 한국어 번역 (ko-translator agent)

Input: Structured JSON (English)
Output: Translated JSON (Korean)
Agent: ko-translator (model: sonnet)

Task 도구로 ko-translator 에이전트를 호출:

• 자연스러운 한국어로 번역
• 기술 용어 첫 등장 시 병기
• 코드, URL, 이미지는 원본 유지

Step 3: 마크다운 생성 (md-formatter agent)

Input: Translated JSON
Output: Final Markdown file
Agent: md-formatter (model: haiku)

Task 도구로 md-formatter 에이전트를 호출:

• YAML frontmatter 생성
• 깔끔한 마크다운 포맷팅
• 이미지 임베딩 (![caption](url))

---

JSON 스키마 정의

1단계 출력 (html-extractor → ko-translator)

{
  "metadata": {
    "title": "원본 영어 제목",
    "author": "저자명",
    "date": "발행일 (원본 형식)",
    "read_time": "읽기 시간"
  },
  "sections": [
    {
      "type": "heading",
      "level": 1,
      "content": "헤딩 텍스트"
    },
    {
      "type": "paragraph",
      "content": "단락 텍스트"
    },
    {
      "type": "image",
      "url": "https://miro.medium.com/...",
      "caption": "이미지 캡션 (있는 경우)",
      "alt": "대체 텍스트 (있는 경우)"
    },
    {
      "type": "code",
      "language": "python",
      "content": "코드 내용"
    },
    {
      "type": "blockquote",
      "content": "인용문 내용"
    },
    {
      "type": "list",
      "ordered": false,
      "items": ["항목1", "항목2"]
    }
  ]
}

2단계 출력 (ko-translator → md-formatter)

{
  "metadata": {
    "title": "원본 영어 제목",
    "title_ko": "한국어 번역 제목",
    "author": "저자명",
    "date": "YYYY-MM-DD",
    "source": "원본 Medium URL (있는 경우)"
  },
  "sections": [
    // 동일 구조, content가 한국어로 번역됨
    // image type은 url, caption, alt 모두 보존
  ],
  "glossary": [
    {"en": "latency", "ko": "지연 시간"},
    {"en": "throughput", "ko": "처리량"}
  ]
}