AI 보조 시리즈형 교육 글(컬렉션)의 본문 구성·최소 분량·깊이·slug·00 챕터·품질 체크리스트를 표준화한다. design-patterns, cleanarchitecture, optimization 시리즈, C++ 성능 트랙, 장문 기술 튜토리얼, 커리큘럼형 블로그 포스트를 작성·보강할 때 사용한다. blog-post-writing 스킬 및 rules-that-must-be-followed와 함께 적용한다.
이 스킬은 AI로 생성·보완하는 교육 콘텐츠(블로그/시리즈형 글)의 품질을 일관되게 유지하기 위해 적용된다.
함께 따를 것
.cursor/rules/rules-that-must-be-followed.mdc: frontmatter, Mermaid, 알고리즘 주석, 링크 검증 등 전역 규칙.cursor/skills/blog-post-writing/SKILL.md 및 reference.md: 제목 형식·카테고리 접두어·날짜, 내부 링크(/post/...) 상세다음 순서를 지키되, 주제 성격에 따라 일부 절은 생략 가능하다.
collection_order(정수)로 컬렉션 내 페이지 순서를 지정한다. 숫자가 작을수록 앞에 오며, 첫 챕터·개요는 0을 쓴다.series_order는 사용하지 않는다. 사이트는 정렬 시 collection_order만 사용한다._index.md의 .Content)을 렌더하지 않고, 제목·설명·이미지만 사용한다. 따라서 시리즈/컬렉션 소개·커리큘럼·학습 방법·참고 자료는 _index.md가 아니라 00 챕터(예: 00-introduction, 00-curriculum-overview)에 두어야 독자가 실제로 볼 수 있다.collection_order: 0**을 두어 목록에서 맨 앞에 오게 한다.slug**를 명시한다. (Hugo 기본 경로에만 의존하지 않음)-), 공백·특수문자 없음, 영문만 사용.cpp-optimization, design-patterns).getting-started- + 컨텍스트(트랙/도메인) + 필요 시 -performance-tuning, -fundamentals 등 (예: getting-started-cpp-language-performance-tuning).NN-를 제거한 kebab-case를 기본으로 하고, 주제를 구체화할 필요가 있으면 보조 키워드를 하이픈으로 이어 붙인다 (예: abstraction-cost, optimization-flags-o2-o3-ofast).독자가 단순 암기가 아니라 판단·적용·비판을 할 수 있도록 다음을 반영한다.
-practice 글로 분리 권장.> "..." — Author Name, 『Book Title』(Year)</br> 규칙을 준수한다.java, cpp). 의사코드·구조 설명은 text 지정을 권장한다.본문과 코드의 균형: 교육 글은 설명·원칙·비교·판단 기준이 코드와 균형을 이뤄야 한다. 코드 블록만 연속해서 나열하지 않는다. 각 코드 블록 앞에는 그 코드가 다루는 개념·목적·왜 이 방식을 쓰는지를 문단으로 2문장 이상 서술한다. 필요 시 코드 뒤에는 요약·주의점·트레이드오프를 1~2문장으로 정리한다. 한 절 안에 코드 블록이 2개 이상일 경우, 블록 사이에 설명 문단을 두어 코드가 연속하지 않게 한다. (참고: 본문(문단·목록·표)이 전체 본문+코드 줄 수의 최소 40% 이상을 차지하도록 권장한다.)
글을 게시하기 전에 아래를 확인한다. (순서는 본문 구성 → 길이 → 깊이 → 시각 요소 순이다.)
본문 구성
전문가 양성
길이
깊이·인용
시각 요소
</br> 규칙을 지켰는가?text 지정을 권장했는가?