report-writinglisted
Install: claude install-skill aiskillstore/marketplace
# Report Writing
작업 완료 후 상세 리포트를 작성하는 스킬입니다.
## Core Principle
> **"작업의 '무엇'과 '왜'를 기록하여 6개월 후에도 추적 가능하게"**
## 파일명 규칙 (필수)
```
docs/reports/YYYY-MM-DD-<제목>-report.md
```
예시:
- `2024-12-24-path-renaming-report.md`
- `2024-12-20-security-audit-report.md`
- `2024-12-15-migration-complete-report.md`
## 리포트 구조
### 필수 섹션
```markdown
# 🔄 [작업 제목] 리포트
**작성일**: YYYY-MM-DD
**작업자**: [작업자명]
**스킬 사용**: [사용한 스킬 목록]
---
## 📋 변경 개요
| 항목 | 내용 |
|------|------|
| **변경 사유** | [왜 이 작업이 필요했는지] |
| **변경 내용** | [무엇을 변경했는지] |
| **영향 범위** | [어디에 영향을 미치는지] |
| **상태** | ✅ 완료 / 🔄 진행중 / ❌ 실패 |
---
## 🔧 변경된 파일 목록
### 📝 수정된 파일
| # | 파일 | 변경 내용 | 변경 유형 |
|---|------|----------|----------|
| 1 | `파일경로` | 변경 설명 | 🔧 Refactor |
---
## 🔍 상세 변경 내역
### 파일명
\`\`\`diff
- 이전 내용
+ 변경된 내용
\`\`\`
---
## ✅ 검증 완료
\`\`\`bash
# 검증 명령어 및 결과
\`\`\`
---
## 📌 후속 작업
- [ ] 후속 작업 1
- [ ] 후속 작업 2
```
## 변경 유형 분류
| Prefix | 이모지 | 설명 |
|--------|--------|------|
| Feature | ✨ | 새로운 기능 추가 |
| Fix | 🐛 | 버그 수정 |
| Refactor | 🔧 | 코드 리팩토링 |
| Docs | 📚 | 문서 변경 |
| Performance | ⚡ | 성능 개선 |
| Security | 🔒 | 보안 관련 |
| Breaking | 💥 | 호환성 깨짐 |
| Delete | 🗑️ | 파일/기능 삭제 |
## Before/After 패턴
복잡한 변경에는 Before/After 비교 포함:
```markdown
### Before/After 구조
\`\`\`
Before After
────────────────── ──────────────────
.old-folder/ .new-folder/
├── files/ ├── files/ ✏️
└── config/ └── config/
\`\`\`
```
## 영향도 분석 섹션