| name | blog-draft |
| description | Draft a blog post from ideas and resources. Use when users want to write a blog post, create content from research, or draft articles. Guides through research, brainstorming, outlining, and iterative drafting with version control. |
블로그 초안 작성 스킬
사용자 입력
$ARGUMENTS
진행하기 전에 사용자 입력을 반드시 고려해야 합니다. 사용자는 다음을 제공해야 합니다:
- 아이디어/주제: 블로그 포스트의 주요 개념 또는 테마
- 리소스: URL, 파일, 또는 참조할 자료 (선택 사항이지만 권장)
- 대상 독자: 블로그 포스트의 대상 (선택 사항)
- 톤/스타일: 격식체, 비격식체, 기술적 등 (선택 사항)
중요: 사용자가 기존 블로그 포스트의 업데이트를 요청하는 경우, 0-8단계를 건너뛰고 9단계에서 바로 시작하십시오. 먼저 기존 초안 파일을 읽은 다음 반복 프로세스를 진행합니다.
실행 흐름
다음 단계를 순서대로 따르십시오. 단계를 건너뛰거나 표시된 곳에서 사용자 승인 없이 진행하지 마십시오.
0단계: 프로젝트 폴더 생성
-
YYYY-MM-DD-short-topic-name 형식으로 폴더 이름을 생성합니다
- 오늘 날짜를 사용합니다
- 주제에서 짧고 URL 친화적인 슬러그를 만듭니다 (소문자, 하이픈, 최대 5단어)
-
폴더 구조를 생성합니다:
blog-posts/
└── YYYY-MM-DD-short-topic-name/
└── resources/
-
진행하기 전에 사용자에게 폴더 생성을 확인합니다.
1단계: 리서치 및 리소스 수집
-
블로그 포스트 디렉토리에 resources/ 하위 폴더를 생성합니다
-
제공된 각 리소스에 대해:
- URL: 핵심 정보를 가져와 마크다운 파일로
resources/에 저장합니다
- 파일: 읽고
resources/에 요약합니다
- 주제: 웹 검색을 사용하여 최신 정보를 수집합니다
-
각 리소스에 대해 resources/에 요약 파일을 생성합니다:
resources/source-1-[short-name].md
resources/source-2-[short-name].md
- 등
-
각 요약에는 다음이 포함되어야 합니다:
# Source: [Title/URL]
## Key Points
- Point 1
- Point 2
## Relevant Quotes/Data
- Quote or statistic 1
- Quote or statistic 2
## How This Relates to Topic
Brief explanation of relevance
-
사용자에게 리서치 요약을 제시합니다.
2단계: 브레인스토밍 및 명확화
-
아이디어와 조사된 리소스를 기반으로 다음을 제시합니다:
- 리서치에서 식별된 주요 테마
- 블로그 포스트의 잠재적 관점
- 다루어야 할 핵심 포인트
- 명확화가 필요한 정보의 공백
-
명확화 질문을 합니다:
- 독자에게 전달하고 싶은 주요 시사점은 무엇입니까?
- 리서치에서 강조하고 싶은 특정 포인트가 있습니까?
- 목표 길이는? (짧음: 500-800단어, 중간: 1000-1500, 긴: 2000+)
- 제외하고 싶은 포인트가 있습니까?
-
진행하기 전에 사용자 응답을 기다립니다.
3단계: 아웃라인 제안
-
다음을 포함하는 구조화된 아웃라인을 작성합니다:
# Blog Post Outline: [Title]
## Meta Information
- **Target Audience**: [who]
- **Tone**: [style]
- **Target Length**: [word count]
- **Main Takeaway**: [key message]
## Proposed Structure
### Hook/Introduction
- Opening hook idea
- Context setting
- Thesis statement
### Section 1: [Title]
- Key point A
- Key point B
- Supporting evidence from [source]
### Section 2: [Title]
- Key point A
- Key point B
[Continue for all sections...]
### Conclusion
- Summary of key points
- Call to action or final thought
## Sources to Cite
- Source 1
- Source 2
-
사용자에게 아웃라인을 제시하고 승인 또는 수정을 요청합니다.
4단계: 승인된 아웃라인 저장
-
사용자가 아웃라인을 승인하면 블로그 포스트 폴더에 OUTLINE.md로 저장합니다.
-
아웃라인이 저장되었음을 확인합니다.
5단계: 아웃라인 커밋 (git 저장소인 경우)
-
현재 디렉토리가 git 저장소인지 확인합니다.
-
예인 경우:
- 새 파일을 스테이징합니다: 블로그 포스트 폴더, 리소스, OUTLINE.md
- 커밋 메시지로 커밋합니다:
docs: Add outline for blog post - [topic-name]
- 원격에 푸시합니다
-
git 저장소가 아닌 경우 이 단계를 건너뛰고 사용자에게 알립니다.
6단계: 초안 작성
-
승인된 아웃라인을 기반으로 전체 블로그 포스트 초안을 작성합니다.
-
OUTLINE.md의 구조를 정확히 따릅니다.
-
다음을 포함합니다:
- 흥미로운 도입부와 도입 문구
- 명확한 섹션 헤더
- 리서치에서 나온 근거와 예시
- 섹션 간 자연스러운 전환
- 시사점이 있는 강력한 결론
- 인용: 모든 비교, 통계, 데이터 포인트, 사실적 주장은 원본 출처를 반드시 인용해야 합니다
-
초안을 블로그 포스트 폴더에 draft-v0.1.md로 저장합니다.
-
형식:
# [Blog Post Title]
*[Optional: subtitle or tagline]*
[Full content with inline citations...]
---
## References
- [1] Source 1 Title - URL or Citation
- [2] Source 2 Title - URL or Citation
- [3] Source 3 Title - URL or Citation
-
인용 요구사항:
- 모든 데이터 포인트, 통계 또는 비교에는 인라인 인용이 있어야 합니다
- 번호가 매겨진 참조 [1], [2] 등 또는 이름이 있는 인용 [Source Name]을 사용합니다
- 인용을 끝부분의 References 섹션에 연결합니다
- 예: "Studies show that 65% of developers prefer TypeScript [1]"
- 예: "React outperforms Vue in rendering speed by 20% [React Benchmarks 2024]"
7단계: 초안 커밋 (git 저장소인 경우)
-
git 저장소인지 확인합니다.
-
예인 경우:
- 초안 파일을 스테이징합니다
- 커밋 메시지로 커밋합니다:
docs: Add draft v0.1 for blog post - [topic-name]
- 원격에 푸시합니다
-
git 저장소가 아닌 경우 건너뛰고 사용자에게 알립니다.
8단계: 리뷰를 위해 초안 제시
-
사용자에게 초안 내용을 제시합니다.
-
피드백을 요청합니다:
- 전반적인 인상은?
- 확장 또는 축소가 필요한 섹션은?
- 톤 조정이 필요합니까?
- 누락된 정보가 있습니까?
- 특정 편집 또는 재작성이 필요합니까?
-
사용자 응답을 기다립니다.
9단계: 반복 또는 확정
사용자가 변경을 요청하는 경우:
- 요청된 모든 수정 사항을 기록합니다
- 다음 조정 사항과 함께 6단계로 돌아갑니다:
- 버전 번호 증가 (v0.2, v0.3 등)
- 모든 피드백 반영
draft-v[X.Y].md로 저장
- 7-8단계 반복
사용자가 승인하는 경우:
- 최종 초안 버전을 확인합니다
- 사용자가 요청하면 선택적으로
final.md로 이름을 변경합니다
- 블로그 포스트 작성 프로세스를 요약합니다:
- 생성된 총 버전 수
- 버전 간 주요 변경 사항
- 최종 단어 수
- 생성된 파일
버전 추적
모든 초안은 증분 버전 관리로 보존됩니다:
draft-v0.1.md - 초기 초안
draft-v0.2.md - 첫 번째 피드백 반영 후
draft-v0.3.md - 두 번째 피드백 반영 후
- 등
이를 통해 블로그 포스트의 진화를 추적하고 필요 시 되돌릴 수 있습니다.
출력 파일 구조
blog-posts/
└── YYYY-MM-DD-topic-name/
├── resources/
│ ├── source-1-name.md
│ ├── source-2-name.md
│ └── ...
├── OUTLINE.md
├── draft-v0.1.md
├── draft-v0.2.md (반복 시)
└── draft-v0.3.md (추가 반복 시)
품질을 위한 팁
- 도입 문구: 질문, 놀라운 사실, 또는 공감 가능한 시나리오로 시작합니다
- 흐름: 각 문단이 다음 문단으로 연결되어야 합니다
- 근거: 리서치 데이터로 주장을 뒷받침합니다
- 인용: 다음의 경우 항상 출처를 인용합니다:
- 모든 통계 및 데이터 포인트 (예: "According to [Source], 75% of...")
- 제품, 서비스, 접근 방식 간의 비교 (예: "X performs 2x faster than Y [Source]")
- 시장 동향, 연구 결과, 벤치마크에 대한 사실적 주장
- 인라인 인용 형식 사용: [Source Name] 또는 [Author, Year]
- 보이스: 전체적으로 일관된 톤을 유지합니다
- 길이: 목표 단어 수를 준수합니다
- 가독성: 짧은 문단과 적절한 곳에 글머리 기호를 사용합니다
- CTA: 명확한 행동 촉구 또는 생각을 자극하는 질문으로 마무리합니다
참고 사항
- 지정된 체크포인트에서 항상 사용자 승인을 기다립니다
- 기록을 위해 모든 초안 버전을 보존합니다
- URL이 제공될 때 최신 정보를 위해 웹 검색을 사용합니다
- 리소스가 부족한 경우 사용자에게 추가 자료를 요청하거나 추가 리서치를 제안합니다
- 대상 독자에 따라 톤을 조정합니다 (기술적, 일반적, 비즈니스 등)