블로그 글을 작성한다. 사용자에게 주제/분량/편집여부를 확인한 후 blog-content-writer를 호출하고, 편집이 필요하면 blog-editor를 순차 호출하여 최종본을 저장한다.

Blog Write

블로그 글을 작성하는 오케스트레이션 스킬이다. writer → editor 순차 파이프라인으로 동작한다.

Process

Step 1: 사용자 정보 수집

AskUserQuestion 도구로 다음을 한 번에 물어본다:

Q1. 주제

글의 주제를 자유 입력으로 받는다. 기획안이 있으면 경로를 함께 입력받는다.

옵션설명
직접 입력주제를 직접 입력
기획안 기반ideation 폴더의 기획안 경로를 입력하여 해당 주제로 작성

Q2. 분량

옵션설명
짧음 (~1000자)가벼운 인사이트, 정의형 콘텐츠
보통 (~2000자) (Recommended)표준 블로그 포스트
길음 (~3000자+)심층 가이드, 비교 분석

Q3. 편집 여부

옵션설명
편집 포함 (Recommended)writer 초안 → editor 리뷰/수정 → 최종본 저장
초안만writer 초안만 저장 (빠른 작성)

Q4. 콘텐츠 유형

옵션설명
How-to/가이드 (Recommended)단계별 실용 가이드
인사이트/트렌드업계 트렌드 분석 및 의견
사례 연구성공 사례 기반 콘텐츠
용어 해설/정의개념 설명 콘텐츠

Step 2: blog-content-writer 에이전트 호출

수집된 정보를 blog-content-writer 에이전트에게 전달한다:

  • subagent_type: general-purpose
  • prompt: 아래 내용을 포함하여 전달한다:
1당신은 blog-content-writer 에이전트입니다. 다음 파일을 먼저 읽고 그 지시에 따라 행동하세요:
2.claude/agents/blog-marketing/blog-content-writer.md
3
4작성 파라미터:
5- topic: {topic}
6- target_length: {target_length}
7- content_type: {content_type}
8- ideation_path: {ideation_path} (있는 경우)
9
10중요:
111. 파일을 직접 저장하지 마세요. 작성한 글 전체를 텍스트로 반환해주세요.
122. 문체는 반드시 "합니다", "해요", "할까요?" 등 해요/합니다체를 사용하세요. "~다", "~이다" 등의 다/이다체는 사용하지 마세요.
133. 본문에서 외부 자료(통계, 연구, 기사, 보고서 등)를 인용했다면, 글 말미에 "## 참고 자료" 섹션을 추가하고 인용한 자료를 모두 명시하세요. 웹 자료는 반드시 접속 URL을 포함하세요. 형식: 저자/기관명, "제목", 출처명, 발행일, URL (접속일: YYYY-MM-DD)

Step 3: blog-editor 에이전트 호출 (편집 포함 시)

사용자가 "편집 포함"을 선택한 경우에만 실행한다. writer 완료 후 순차적으로 호출한다.

  • subagent_type: general-purpose
  • prompt: 아래 내용을 포함하여 전달한다:
1당신은 blog-editor 에이전트입니다. 다음 파일을 먼저 읽고 그 지시에 따라 행동하세요:
2.claude/agents/blog-marketing/blog-editor.md
3
4편집 파라미터:
5- review_depth: standard
6
7편집할 초안:
8---
9{writer_output}
10---
11
12중요:
131. 팩트체크, SEO/AEO 7개 항목, Brand Voice 5대 원칙을 모두 검토하세요.
142. 편집 리뷰와 수정본을 모두 텍스트로 반환하세요. 파일을 직접 저장하지 마세요.
153. 반환 시 "## 편집 리뷰" 섹션과 "## 수정본" 섹션을 명확히 구분하세요.
164. 문체는 반드시 "합니다", "해요", "할까요?" 등 해요/합니다체를 사용하세요. "~다", "~이다" 등의 다/이다체가 있으면 수정하세요.
175. 인용 자료 검증: 본문에서 인용된 모든 자료가 글 말미 "## 참고 자료" 섹션에 빠짐없이 명시되어 있는지 확인하세요. 웹 자료에 접속 URL이 누락되어 있으면 보완하세요.

Step 4: 최종본 저장

편집 결과에서 수정본을 추출하거나, 초안만 모드인 경우 writer 결과를 그대로 사용하여 저장한다.

폴더 구조

포스트마다 전용 폴더를 생성하고, 그 안에 마크다운 파일과 images/ 폴더를 함께 만든다:

1knowledges/marketing/blog-marketing/posts/{date}-{slug}/
2├── {date}-{slug}.md          ← 포스트 본문
3└── images/                   ← 본문에 삽입할 이미지 저장 폴더
  • {date}: 오늘 날짜 (YYYY-MM-DD)
  • {slug}: 제목에서 추출한 URL-friendly 슬러그 (한글 가능, 공백은 -로 치환)

저장 절차

  1. Posts/{date}-{slug}/ 폴더를 생성한다
  2. 해당 폴더 안에 images/ 하위 폴더를 생성한다
  3. 최종 마크다운 파일을 Posts/{date}-{slug}/{date}-{slug}.md로 저장한다

예시

1Posts/2026-02-27-신인-보험-설계사-이탈-AI-교육-전략/
2├── 2026-02-27-신인-보험-설계사-이탈-AI-교육-전략.md
3└── images/

Step 5: 결과 보고

사용자에게 보고한다:

  • 저장 경로
  • 편집 포함 시: 편집 리뷰 요약 (주요 수정 사항)
  • 다음 가능한 작업 안내

Important Notes

  • writer → editor는 반드시 순차적으로 실행한다 (editor는 writer의 결과가 필요함)
  • 각 에이전트에게 파일 저장을 하지 말 것을 명시한다 (이 스킬이 최종 파일을 저장함)
  • editor의 반환에서 "수정본" 섹션을 파싱하여 최종 저장본으로 사용한다
  • 편집 리뷰 내용은 사용자에게 요약하여 보고하되, 별도 파일로 저장하지 않는다
  • 문체: "합니다", "해요", "할까요?" 등 해요/합니다체로 작성한다. "~다", "~이다" 등의 경어체(다/이다체)는 사용하지 않는다. writer와 editor 에이전트 모두에게 이 문체 규칙을 전달한다.
  • 인용 표기: 본문에서 외부 자료(통계, 연구 결과, 기사, 보고서 등)를 인용한 경우, 글 말미에 ## 참고 자료 섹션을 두고 인용한 자료를 모두 명시한다. 형식은 아래와 같다:
    • 웹 자료: 저자/기관명, "제목", 출처명, 발행일, URL (접속일: YYYY-MM-DD)
    • 보고서/논문: 저자명, "제목", 발행기관, 발행일
    • 도서: 저자명, 『도서명』, 출판사, 출판연도
    • 인터넷에서 찾은 자료는 반드시 접속 URL을 포함하여 원문 확인이 가능하도록 한다. writer와 editor 에이전트 모두에게 이 규칙을 전달한다.

Example Usage

기본 사용

1/blog-write
2→ 주제: "보험 설계사의 영업 화법 개선 방법"
3→ 분량: 보통
4→ 편집: 포함
5→ 유형: How-to/가이드

결과: Posts/2026-02-27-보험-설계사-영업-화법-개선-방법/2026-02-27-보험-설계사-영업-화법-개선-방법.md

기획안 기반 작성

1/blog-write
2→ 주제: 기획안 기반 — ideation/2026-02-27-ai-education.md의 주제 1
3→ 분량: 길음
4→ 편집: 포함
5→ 유형: 인사이트/트렌드

빠른 초안 작성

1/blog-write
2→ 주제: "AI 롤플레이가 교육을 바꾸는 5가지 방법"
3→ 분량: 짧음
4→ 편집: 초안만
5→ 유형: 인사이트/트렌드

Quality Checklist

  • writer → editor 파이프라인이 순차적으로 실행되었는가
  • 각 에이전트가 파일을 직접 저장하지 않고 텍스트를 반환했는가
  • 편집 포함 시, 수정본이 정확히 추출되어 최종본으로 저장되었는가
  • 포스트 폴더(Posts/{date}-{slug}/)가 생성되고 그 안에 images/ 폴더가 함께 만들어졌는가
  • 마크다운 파일이 올바른 경로(Posts/{date}-{slug}/{date}-{slug}.md)에 저장되었는가
  • 사용자에게 편집 리뷰 요약이 보고되었는가
  • 인용한 자료가 글 말미 "참고 자료" 섹션에 빠짐없이 명시되었는가
  • 웹 자료에 접속 URL이 포함되어 원문 확인이 가능한가