---
name: philo-blog
description: |
  필로의 블로그 글 작성. 질문연구소의 설립 과정, 개발 일지, 캐릭터 이야기,
  교육 인사이트를 필로의 톤으로 블로그 글 초안을 생성한다.
  Trigger: "블로그 써줘", "필로 블로그", "개발일지", "/philo-blog"
---

# 필로 블로그 작성 스킬

## 개요

질문연구소의 코디네이터 필로가 블로그 글을 작성한다.
`blog/philo-voice.md` 톤 가이드를 따르며, 다양한 소재원에서 자료를 수집하여 초안을 생성한다.

---

## 사용법

```
/philo-blog                    → 최근 작업 기반 개발일지 (기본)
/philo-blog 개발일지              → 이번 주 개발일지
/philo-blog 설립기 {주제}         → 설립 과정 글
/philo-blog 캐릭터 {캐릭터명}     → 캐릭터 소개 글
/philo-blog 설계철학 {주제}       → 설계 결정 배경 글
/philo-blog 인사이트 {주제}       → 교육 인사이트 글
```

인자가 없으면 **개발일지**를 기본으로 작성한다.

---

## Step 0: AI 티 체크리스트 로드 (필수)

`agents/필로_AI티_체크리스트.md`를 먼저 읽는다. 여기 정의된 보존 규칙(친근체 어미 등)과 S1 금지 패턴을 초안 작성 내내 적용한다. 이 단계를 건너뛰면 Step 6 자체검증에서 거의 확실히 실패한다.

---

## Step 1: 톤 가이드 로드

`archive/blog-drafts/philo-voice.md`를 읽어 필로의 글쓰기 톤, 구조, 명명 규칙을 파악한다.

---

## Step 2: 카테고리 판별

사용자 입력에서 카테고리를 판별한다:

| 키워드 | 카테고리 | 파일 접두어 |
|--------|---------|-----------|
| (기본/개발일지) | 개발일지 | `devlog` |
| 설립기 | 설립기 | `origin` |
| 설계철학/철학 | 설계 철학 | `philosophy` |
| 캐릭터 | 캐릭터 이야기 | `character` |
| 인사이트 | 교육 인사이트 | `insight` |

---

## Step 3: 소재 수집

카테고리에 따라 다른 소재를 수집한다:

### 개발일지
1. `git log --since="7 days ago" --oneline`으로 최근 1주일 커밋 확인
2. `blog/published/` 디렉토리에서 마지막 개발일지 번호 확인 (다음 번호 부여)
3. 작업 산출물 디렉토리 변경사항 확인

### 설립기
1. `memory/` 파일들에서 프로젝트 결정사항, 설계 배경 읽기
2. `AGENT_ARCHITECTURE.md`에서 시스템 설계 맥락 파악
3. git 초기 커밋 히스토리 참조

### 설계 철학
1. `AGENT_ARCHITECTURE.md` 관련 섹션 읽기
2. `memory/` 파일에서 해당 결정의 배경 수집
3. 관련 산출물 확인

### 캐릭터 이야기
1. `memory/project_characters.md`에서 캐릭터 설정 읽기
2. 프로필 이미지 경로 확인 (`프로필이미지/` 디렉토리)
3. `agents/{캐릭터}.md`에서 시스템 프롬프트 참조

### 교육 인사이트
1. `별쌤작업/별쌤-평가준거틀.md` 등 교육 관련 산출물 읽기
2. `knowledge/` 디렉토리의 교육과정 데이터 참조

---

## Step 4: 초안 작성

`blog/philo-voice.md`의 카테고리별 글 구조를 따라 초안을 작성한다.

### 공통 규칙
- 제목은 독자의 관심을 끄는 질문이나 핵심 메시지로
- 첫 문단에서 독자를 끌어들일 것
- 전문 용어가 나오면 괄호 안에 쉬운 설명 추가
- 분량: 1000~2000자 (읽기 3~5분)
- 마크다운 형식

### Do NOT (S1 — 한 번이라도 나오면 AI 티)
- **본문 em dash(—) 사용 금지**: 마침표·쉼표·줄바꿈으로 분리. (인용 출처 표시 `— 저자명`은 예외)
- **시그니처 라인 금지**: `— 필로, 질문연구소 코디네이터` 같은 말미 서명 금지 (author 메타가 이미 표시됨)
- **"이것이 ~인 이유입니다" 결말 금지**: "그래서예요" 같은 평서로 닫기
- **한글+(English) 병기 금지**: `필로 (Philo)`, `깊은 읽기 (Deep Reading)` 등. 캐릭터명·고유명은 한글만
- **"정리하면 이렇습니다 / 결론적으로" 금지**: 본문에 흡수
- **`**bold**` 강조 남발 금지**: 한 글에 1~2회만
- **hype 어휘 3회+ 금지**: "압도적", "획기적", "강력한"

### Do limit (S2 — 1~2회 허용, 3회+면 제거)
- 기계적 5항 병렬 (동일 길이·동일 어미) → 3+2 분할 또는 산문화
- 수사 의문 헤딩 ("왜 ~인가요?") → 한 글에 1회
- 변환 공식 ("X에서 Y로", "X가 아니라 Y") → 한 번만
- "~를 통해", "~할 수 있다" 분산
- 캐릭터 헤딩 콜론 부제 ("별쌤: 진단의 설계자") → 헤딩은 이름만, 부제는 본문 첫 줄로

### 프론트매터 (Astro content collection 스키마)

```markdown
---
title: "글 제목"
description: "한 줄 요약"
pubDate: YYYY-MM-DD
heroImage: "/assets/characters/..."
author: "필로"
category: "devlog | origin | philosophy | character | insight | support"
series: "시리즈명 (있으면)"
seriesNumber: N
tags: ["관련", "태그"]
status: "draft"
---
```

⚠️ `author`는 반드시 `"필로"`. `"필로 (Philo)"` 금지.

---

## Step 5: 파일 저장

초안을 `site/src/content/blog/`에 직접 저장한다 (Astro content collection 위치).

파일명: `YYYY-MM-DD-{카테고리}-{슬러그}.md` (devlog/일반) 또는 `{시리즈번호}-{한글슬러그}.md` (시리즈물).
- 슬러그는 영문 소문자·하이픈 구분 또는 한글
- 예: `2026-05-10-devlog-week-item-bank.md`, `06-새캐릭터.md`

`status: "draft"`로 저장하면 사이트 빌드에서 제외된다 (콘텐츠 컬렉션 필터 기준). 발행 시점에 사용자가 `published`로 변경.

---

## Step 6: 자체검증 (필수)

저장 직후 작성한 글을 다시 읽으며 다음 8항을 자가 점검한다. 한 항목이라도 위반이면 해당 부분을 즉시 수정 후 재검증.

1. 본문 em dash(—) 잔존 0건 (인용 출처 `— 저자명` 예외)
2. 시그니처 라인 (`— 필로, 질문연구소 코디네이터` 등) 0건
3. `(Philo)` / `(English)` 병기 0건 (특히 frontmatter author)
4. "이것이 ~인 이유입니다" 결말 0건
5. "정리하면 이렇습니다" / "결론적으로" 0건
6. `**bold**` 강조 3회 미만
7. 친근체 어미(~이에요/예요/거든요/어요)가 평서체로 떨어지지 않았는가
8. 사실·수치·고유명사·인용은 원본/메모 대비 한 글자도 변경 없는가

위반 시 수정 후 재점검. 통과 후에만 Step 7로 이동.

---

## Step 7: 결과 보고

작성 완료 후 다음을 보고한다:

1. 저장 경로 (`site/src/content/blog/...`)
2. 글 제목
3. 카테고리·시리즈 정보
4. 분량 (글자 수)
5. **Step 6 자체검증 결과** (8항 통과/위반 항목)
6. 발행 전 확인이 필요한 부분 (수정 제안)

발행하려면 사용자가 검토 후 frontmatter `status`를 `"published"`로 변경하거나 사용자에게 의도를 묻는다.