| name | blog-agent-pipeline |
| description | Hugo 블로그 글을 끝까지 작성하는 멀티스테이지 파이프라인. Research(자료·링크 검증) → Draft(blog-post-writing 준수) → QA(메타·Mermaid·링크) → PublishPrep(draft 해제 전 최종 확인) 순으로 한 세션에서 순차 실행한다. **한 세션에서 전체 사이클을 자동 진행**할 때 사용한다. 단계별 작성 규칙 자체가 필요하면 `blog-post-writing`을 참고한다. |
블로그 작성 에이전트 파이프라인
이 스킬은 한 세션에서 아래 네 단계를 순서대로 수행하도록 지시한다. 각 단계가 끝날 때마다 짧은 단계 요약(산출물, 미해결 이슈, 다음 단계 입력)을 사용자에게 보고한다.
관계: 전역 규칙은 rules-that-must-be-followed가 우선한다. 초안 구조·경로·태그 전략은 blog-post-writing 및 reference.md를 따른다.
시작 전 함께 호출할 스킬 (매 파이프라인 실행 시)
작업을 시작하기 전에 아래 스킬/파일을 확인한다 (이미 세션에 있으면 생략 가능).
| 적용 조건 | 스킬/파일 | 용도 |
|---|
| 항상 | rules-that-must-be-followed | draft, tags, description, title, 날짜, 링크 검증, Mermaid |
| 항상 | blog-post-writing | 경로, frontmatter, 본문 구조, 검증 체크리스트 |
| 항상 | reference.md | 제목·날짜·접두어, Hugo 내부 링크 |
| 항상 | data/tags.yaml | tags 25개 이상 선정 |
컬렉션 index.md 등 내부 링크 편집 시 | reference.md의 Hugo 컬렉션 내부 링크 절 | 내부 링크 형식 |
| 컬렉션 글 작성 시 | collection-writing-standards | 이론 중심 작성 표준 |
| optimization·designpattern 등 교육 시리즈 글 | educational-content-writing | 품질 3원칙, 안티패딩 |
| 대상 포스트가 속한 컬렉션 | 아래 컬렉션별 스킬 표 참고 | 컬렉션 전용 규칙 |
컬렉션별 작성 스킬 (content/collection/<컬렉션>/ 글일 때)
일반 포스트 성격별 작성 스킬 (content/post/ 글일 때, 주제 성격으로 판단)
Stage 1 — Research
목적: 주제에 맞는 근거·용어·참고 자료를 모으고, 본문에 넣을 URL만 남긴다.
입력: 사용자가 제공한 주제, 컬렉션 유형(또는 일반 포스트), 선택 키워드.
산출물
- 검증된 링크 목록: 각 URL에 대해 HTTP(또는 WebFetch 등) 접근 가능함을 확인한 것만 포함. 404·5xx·차단 시 제외하거나 대체 URL 명시.
- 작성 메모: 목차 초안, 반드시 넣을 섹션, 인용·수치 출처, 피해야 할 주장.
- 경로 결정:
content/post/<연도>/ vs content/collection/<컬렉션>/<연도>/, 폴더명 YYYY-MM-DD-<slug> (컬렉션별 예외는 해당 스킬을 따름).
체크리스트
단계 종료 보고: 검증 링크 개수, 메모 요약, 선택한 콘텐츠 경로.
Stage 2 — Draft
목적: index.md 초안을 저장소에 생성하거나 갱신한다.
입력: Stage 1 산출물.
행동
- 터미널에서 오늘 날짜 확인 후
date / lastmod에 사용.
blog-post-writing의 Phase 2~4에 따라 폴더·index.md·에셋 생성.- Frontmatter:
draft: true, title ≤70자, description ~150자, tags ≥50 (영·한, data/tags.yaml 기반), categories 등 컬렉션 요구 필드 반영.
- 알고리즘 코드 블록이 있으면 전역 규칙대로 상단 주석 포함.
- Mermaid 사용 시
rules-that-must-be-followed 문법 준수.
- 본문에 넣는 모든 외부 링크는 추가 시점에 다시 접근 가능 여부 확인.
교육 시리즈·특수 컬렉션: educational-content-writing, 컬렉션별 작성 스킬(위 표) 등 적용 대상 스킬을 이 단계에서 함께 호출한다.
체크리스트 (초안 완료 시)
단계 종료 보고: 생성·수정한 파일 경로 목록, 미완료 에셋(이미지·워드클라우드 등) 여부.
Stage 3 — QA
목적: 규칙 위반·누락을 수정한다. 새 주장·새 링크 대량 추가는 하지 않는다 (필요 시 Research로 되돌리라고 사용자에게 안내).
입력: Stage 2에서 확정한 index.md 경로.
행동
blog-post-writing § Phase 5 체크리스트를 전항목 점검.- Mermaid 노드 ID·따옴표·
</br> 규칙 재확인.
- 본문·참고의 모든 외부 URL 재검증 (깨진 링크 제거 또는 대체).
- 적용 대상 컬렉션 스킬의 체크리스트(영화 리뷰 Act 구조, Vocabulary 섹션 등)가 있으면 전부 대조.
- 안티패딩 디덤프 패스(교육 글): 닫는 절을 종류별 1개로 정리하고, 중복 요약·답 없는 번호 리스트·작성자용 자기인증("게시 전 자가 점검" 등)·존재하지 않는 파일 참조를 삭제한다 (
educational-content-writing §2.5).
- 코드·수치 점검: 핵심 코드 블록이 컴파일 가능한지(주석뿐·미정의 타입 아님), "정량적"·"측정"을 표방한 글에 실제 수치 또는 실행 가능한 벤치가 있는지 확인한다 (
educational-content-writing §0/§4.4).
체크리스트
단계 종료 보고: 수정한 항목 요약, 남은 리스크(선택).
Stage 4 — PublishPrep
목적: 배포 직전 사람이 검토했다는 전제 하에 draft: false 전환만 안내하거나 수행한다.
원칙
- 사용자가 명시적으로 "배포해 줘 / draft 해제"를 요청하지 않으면
draft: true를 유지한다.
- 해제 시
lastmod를 터미널 오늘 날짜로 갱신한다.
체크리스트
단계 종료 보고: 최종 상태(draft 값), 권장 후속 작업(로컬 hugo 빌드 등).
오케스트레이션 규칙
- 사용자가 "Research만" 또는 "Draft부터"처럼 범위를 지정하면 해당 단계부터 시작한다.
- 기본은 1 → 2 → 3까지 자동 진행하고, 4는 사용자 요청 시에만 수행한다.
- 중간에 규칙과 충돌하면 전역 규칙을 따르고, 스킬과의 차이를 보고에 한 줄 명시한다.
- Stage 3(QA) 이후에도 점수 기반으로 반복 개선이 필요하면(임계값 도달까지 자동 재작성), 4단계 직선 진행 대신
post-quality-loop로 전환할 수 있다.
