tech-blog-postlisted
Install: claude install-skill Choi-jae-min/tech-blog-post
# Tech Blog Post
작업 중 쌓인 실전 경험을 **검색하는 사람이 찾아올 수 있는 글**로 바꾼다.
내부 기록용 학습 로그와 다른 점은 독자가 남이라는 것이다. 같은 문제를 검색해서 들어온 사람이
끝까지 읽고 문제를 해결할 수 있어야 하고, 검색엔진이 그 글을 그 문제의 답으로 인식할 수 있어야 한다.
독자를 위한 완결성과 검색엔진을 위한 구조, 둘 다 챙긴다.
## 진입 모드 판별 (가장 먼저)
이 스킬은 두 결로 불린다. 아래 단계로 들어가기 전에 어느 쪽인지 먼저 가른다.
**1) 명시적 블로그·포스팅 요청** — "블로그 글로 써줘", "포스팅해줘", "SEO 최적화해서", "상위노출"
등. 이 경우 파일을 원하는 게 분명하므로 저장 여부를 따로 묻지 않는다. 아래 0~6단계를 그대로
따라 SEO 최적화된 글을 만들고 기본값으로 `posts/{slug}.html`까지 저장한다.
**2) 일반 정리 요청** — "이 내용 정리해줘", "지금까지 한 거 정리해줘", "이거 정리해줘", "이 대화
정리해줘" 등. 파일을 원하는지 불분명하므로 **먼저 물어본다**:
> 정리한 결과를 파일로 저장할까요? **HTML(기본) / 마크다운 / 저장 안 하고 여기서 보여주기**
- **HTML(기본)** 또는 **마크다운**을 고르면 → 아래 단계를 따라 정리하고 6단계에서 그 형식으로 저장한다.
- **저장 안 함**을 고르면 → **파일을 만들지 않는다.** 6단계(파일 저장)·`posts/index.json` 갱신·
4-1단계(이미지 생성)·5-1단계(SEO 체크리스트)는 전부 건너뛰고, 내용 정리에 집중해 대화로 바로
보여주고 끝낸다. 파일로 안 남기는데 태그·메타 설명·slug 같은 SEO 부산물을 굳이 만들지 않는다.
사용자가 처음부터 형식을 지정했으면("HTML로 정리해줘", "md로 정리해줘") 다시 묻지 말고 그 형식으로
바로 저장한다. 저장 여부가 애매하면 묻는 쪽이 기본이다 — 사용자가 원치 않는 파일을 함부로 만들지 않는다.
## 0단계: 주제와 범위 확정
이 스킬은 날짜 단위가 아니라 **주제 단위**로 움직인다. 먼저 확정한다.
**주제**: 무엇에 대한 글인지. 사용자가 명시하지 않았으면 최근 대화나 작업에서 가장 완결된 하나의
문제/개념을 골라 제안하고 확인받는다. 여러 주제가 섞여 있으면 한 글에 욱여��지 말고 쪼갠다 —
검색엔진은 주제 하나에 집중한 글을 더 명확한 답으로 인식한다.
**범위**: 아래 둘 중 하나다. 사용자 말에서 명확하지 않으면 물어본다.
- **단일 세션형**: 지금 대화/오늘 작업에서 다룬 것만으로 충분히 완결된 글이 나오는 경우.
- **누적형**: "요즘 계속 붙잡고 있던", "지난 2주간" 처럼 여러 날에 걸친 작업을 한 편으로 묶는 경우.
이때는 대상 기간(YYYY-MM-DD ~ YYYY-MM-DD)을 사용자에게 확정받아 아래 수집 단계에 쓴다.
**타겟 키워드**: 사람들이 이 문제를 검색할 때 실제로 칠 법한 말(에러 메시지, 기술