--- name: analyze-docs description: 프로젝트의 특정 문서 묶음을 분석하여 _posts/ 에 블로그 포스트를 작성합니다. disable-model-invocation: true allowed-tools: Bash, Read, Write, Edit, Glob, Grep, Task argument-hint: "<문서 경로 또는 glob 패턴>" --- # 문서 분석 및 블로그 포스트 작성 분석 대상: `$ARGUMENTS` ## 1단계: 대상 문서 수집 인자로 전달된 경로에서 문서를 수집합니다. ### 인자 형태별 처리 | 인자 형태 | 예시 | 처리 | | --------- | ------------------- | ------------------------ | | 디렉토리 | `/path/to/docs` | 하위 모든 문서 파일 수집 | | glob 패턴 | `/path/**/*.md` | 패턴에 맞는 파일 수집 | | 파일 목록 | `file1.md file2.md` | 지정된 파일만 수집 | ### 문서 파일 탐색 ```bash # 디렉토리인 경우 문서 파일 찾기 find $ARGUMENTS -type f \( -name "*.md" -o -name "*.mdx" -o -name "*.txt" -o -name "*.rst" \) | head -30 # 파일 수 확인 find $ARGUMENTS -type f \( -name "*.md" -o -name "*.mdx" \) | wc -l ``` ## 2단계: 문서 내용 분석 ### 2.1 전체 문서 읽기 수집된 모든 문서를 읽고 내용을 파악합니다: - 각 문서의 제목과 핵심 내용 - 문서 간의 관계와 흐름 - 공통 주제 또는 기술 키워드 추출 ### 2.2 주제 분류 문서들을 분석하여 블로그 포스트로 작성할 주제를 도출합니다: | 분류 기준 | 포스트 유형 | | --------------- | ------------------------- | | 기술 스택 설명 | 기술 소개/비교 포스트 | | 설계 문서 | 아키텍처/설계 결정 포스트 | | 트러블슈팅 기록 | 문제 해결 포스트 | | API/기능 명세 | 튜토리얼/가이드 포스트 | | 회의록/회고 | 회고/인사이트 포스트 | | 학습 노트 | TIL/학습 정리 포스트 | ### 2.3 핵심 내용 추출 각 주제별로 다음을 정리: - **배경**: 왜 이 기술/방법을 선택했는지 - **내용**: 핵심 개념과 구현 방법 - **결과**: 적용 결과와 배운 점 - **코드**: 참고할 만한 코드 예제 ## 3단계: 포스트 구성안 제시 사용자에게 작성할 포스트의 구성안을 제시하고 확인합니다: ``` 제안 포스트 목록: 1. <제목 1> - 주제: ... - 참조 문서: ... - 예상 분량: ... 2. <제목 2> - 주제: ... - 참조 문서: ... - 예상 분량: ... ``` 확인 사항: - 포스트 개수와 주제가 적절한지 - 추가/제외할 주제가 있는지 - 포스트 톤앤매너 (기술 블로그, 회고, 튜토리얼 등) - slug 이름 (파일명) ## 4단계: MDX 포스트 작성 `_posts/.mdx` 파일을 작성합니다. ### Frontmatter 형식 ```yaml --- title: "<포스트 제목>" date: "" description: "<한줄 요약>" tags: ["<태그1>", "<태그2>", ...] --- ``` ### 포스트 유형별 본문 구조 #### 기술 소개/비교 포스트 ```markdown # <제목> ## 배경 왜 이 기술을 도입했는지, 어떤 문제를 해결하려 했는지 ## 핵심 개념 기술의 주요 개념 설명 ## 적용 방법 실제 프로젝트에 적용한 방법과 코드 예제 ## 비교/장단점 다른 대안과의 비교, 장단점 분석 ## 마무리 정리 및 추천 사용 사례 ``` #### 문제 해결 포스트 ```markdown # <제목> ## 문제 상황 어떤 문제가 발생했는지 구체적으로 설명 ## 원인 분석 문제의 근본 원인 파악 과정 ## 해결 방법 단계별 해결 과정과 코드 ## 결과 해결 후 개선된 점 ## 배운 점 이 경험에서 얻은 인사이트 ``` #### 회고 포스트 ```markdown # <제목> ## 프로젝트 개요 프로젝트 간략 소개 ## 잘한 점 성공적이었던 부분 ## 아쉬운 점 개선이 필요한 부분 ## 배운 점 기술적/비기술적 학습 ## 다음 단계 향후 계획 ``` ### 작성 규칙 - 한국어로 작성 - 기술 용어는 영문 유지 - 원본 문서의 사실을 기반으로 작성 (창작 금지) - 코드 예제는 원본에서 발췌하거나 단순화 - 독자가 컨텍스트 없이도 이해할 수 있도록 작성 - 내부 기밀이나 민감 정보 제외 - **MDX 파싱 안전성**: 코드 블록 외부에서 `<`, `>`, `{`, `}` 문자는 반드시 백틱(`` ` ``)으로 감싸거나 `\`로 이스케이프 (예: `HashSet` → `` `HashSet` ``) ## 5단계: 이미지 디렉토리 생성 생성된 포스트의 slug에 맞는 이미지 디렉토리를 생성합니다: ```bash mkdir -p public/images/posts// ``` ## 6단계: 결과 보고 ``` 분석 문서 수: N개 생성된 포스트: M개 ``` | 파일 | 제목 | 태그 | | ------------------- | ------ | ------ | | `_posts/.mdx` | <제목> | <태그> |