blog-writinglisted
Install: claude install-skill eddmpython/eddmpython
# 토탈 블로그 작가 파이프라인
제목, 검색 약속, 본문, 이미지가 질문 하나에 같은 답을 하게 만든다. 블로그는 강의 요약문이 아니라
검색과 공유 링크에서 한 편만 열어도 완결되는 독립 지식 원문이다. 강의 슬라이드는 완성된 블로그를
참조하며 강의 시간과 차시가 글의 깊이를 줄이지 못한다. 독자가 실제로 보는 화면, 누르는 버튼,
실행하는 명령, 확인하는 결과를 중심으로 쓴다. 개념어와 비유는 구체적인 설명을 대신할 수 없다.
## 1. 정본부터 읽기
작업 전에 다음 파일을 순서대로 읽는다.
- `CLAUDE.md`
- `blog/product-marketing.md`
- `blog/PIPELINE.md`의 1절부터 4절
- 해당 카테고리 폴더의 `원장.md`
- `skills/specs/operation/blogCopy.md`
- 고칠 글과 그 글이 설명하는 실제 코드, 문서, 화면
정확한 제품 동작을 확인할 수 없으면 단정하지 말고 뺀다. 저장소 안에 초안 메모나 임시 파일을 만들지
않는다.
## 2. 검색 약속과 독자를 함께 고정하기
초안보다 먼저 다음 네 답을 작업 메모에 적는다.
- 이 글을 여는 사람은 지금 무엇을 하려는가
- 그 사람은 어떤 말을 아직 모르는가
- 읽고 나서 처음 누르거나 실행할 것은 무엇인가
- 성공하면 화면이나 터미널에 무엇이 보이는가
네 답 중 하나라도 비어 있으면 자료를 더 확인한다.
이어서 다음 네 값을 정한다.
- `primaryKeyword`: 독자가 실제로 찾을 두 단어 이상의 검색어
- `searchIntent`: explanation, how-to, troubleshooting, comparison 중 하나
- `title`: 검색어와 문제, 질문, 결과 후크를 함께 담은 15자 이상 60자 이하 문장
- `summary`: 검색어, 읽어서 얻는 결과, 다룰 범위를 담은 한두 문장
제목에서 제품명을 지워도 독자의 문제가 남아야 한다. 제목, summary, 도입 두 문단에 핵심 검색어의
주요 단어가 모두 들어가야 한다. 제목만 크게 약속하고 본문에서 답하지 않는 후크는 쓰지 않는다.
## 3. 주제 하나를 정하고 기승전결을 잡는다
`order.json`은 공개 목록 순서만 제공한다. 강의 시간, 차시, 슬라이드 수를 글 분량과 목차의 상한으로
쓰지 않는다. 강의 운영표도 글쓰기 지시서가 아니다. 초안보다 먼저 다음 여덟 줄을 적는다.
- 질문에 대한 직접 답
- 반드시 풀어 쓸 용어와 정의
- 그렇게 동작하는 이유와 내부 관계
- 입력, 행동, 출력이 모두 있는 완성 예제
- 비슷한 선택지와 다른 점
- 실패 사례 또는 경계값과 복구
- 독자가 결과를 확인할 기준
- 적용 범위와 적용하면 안 되는 범위
빈 줄이 있으면 초안을 쓰지 않고 실제 코드, 화면, 공식 문서, 실행 결과를 더 확인한다. 분량은 목표가 아니다. 한 편은 주제 하나에 답하고, 그 주제를 끝까지 답했으면 짧아도 된다.
글자 수 하한은 쓰지 않는다. 하한에 미달할 때 가장 싼 해가 같은 사실의