blog-posting-auto: Skill for Claude Code

/blog-pipeline

블로그 글 한 편을 6단계 서브에이전트 직렬 실행으로 생성하고 Notion에 발행하는 워크플로우. Researcher가 모은 사실을 Fact-Checker가 원본 URL 재방문으로 검증, downstream(Planner/Writer/Reviewer)은 verified.md만 사실 근거로 사용.

실행 순서

오케스트레이터(메인 세션)가 다음을 순서대로 수행:

0. 준비

1. RUN_ID + TODAY 생성: slug는 주제에서 한국어→영어 음차 또는 핵심 명사.

   RUN_ID="$(date +%Y%m%d-%H%M%S)-{slug}"
   TODAY="$(date +%Y-%m-%d)"
   mkdir -p workspace/$RUN_ID
   

   TODAY는 모든 서브에이전트 호출 시 prompt에 박아 전달 — Researcher 최신성 쿼리, Fact-Checker staleness 판정 기준.
2. workspace/{RUN_ID}/meta.json 초기 기록:

   {
     "run_id": "...",
     "topic": "...",
     "today": "YYYY-MM-DD",
     "started_at": "ISO-8601",
     "stages": {}
   }
   

3. .env 존재 + NOTION_DATABASE_ID 채워졌는지 확인. 없으면 사용자에게 알리고 Publisher 단계는 skip 옵션 안내.

1. Researcher

Agent(subagent_type="blog-researcher", prompt=<<<
RUN_ID: {RUN_ID}
TODAY:  {TODAY}      ← 최신성 쿼리 기준
TOPIC:  {사용자 입력 주제}

workspace/{RUN_ID}/research.md 생성.
모든 WebSearch 쿼리에 {TODAY 연도} 또는 "최신" 키워드 포함.
각 사실에 source-date 메타 부착.
>>>)

검증: workspace/{RUN_ID}/research.md 존재 + 4KB 이상 + 각 사실에 (source-date: ...) 메타 존재.

1.5. Fact-Checker

Agent(subagent_type="blog-fact-checker", prompt=<<<
RUN_ID: {RUN_ID}
TODAY:  {TODAY}      ← staleness 판정 기준 (TODAY-12개월 미만 출처만 통과)

workspace/{RUN_ID}/research.md의 각 주장을 원본 URL 재방문해 검증.
time-sensitive(가격·시간·정책·버전) 사실은 source-date 12개월 초과면 rejected (stale-source).
research.verified.md + research.rejected.md 생성.
>>>)

검증:

• research.verified.md 존재 + research.rejected.md 존재 (빈 파일이어도 OK)
• stdout 통계 라인 [fact-checker] ... verified=M rejected=N-M ratio=M/N% 캡처
• verified 비율 < 50% → 자동 RETRY: Researcher 재호출 (최대 2회). 그래도 50% 미만이면 사용자 결정 요청.
• verified 비율 ≥ 50%면 다음 단계 진행.

2. Planner

Agent(subagent_type="blog-planner", prompt=<<<
RUN_ID: {RUN_ID}

workspace/{RUN_ID}/research.verified.md를 읽고 plan.md 작성.
research.md는 참고만, verified에 없는 사실은 절대 사용 금지.
>>>)

검증: plan.md 존재 + 섹션 5개 이상.

3. Writer

Agent(subagent_type="blog-writer", prompt=<<<
RUN_ID: {RUN_ID}

plan.md 따라 draft.md 작성.
사실 출처는 research.verified.md만.
>>>)