262 lines
6.7 KiB
Markdown
262 lines
6.7 KiB
Markdown
# 업무일지 표준화 템플릿
|
|
|
|
> 작성일: 2026-03-19
|
|
> 버전: v1.0
|
|
> 담당: 테크 리드
|
|
> 적용 대상: FE 팀 전원
|
|
|
|
---
|
|
|
|
## 개요
|
|
|
|
FE 팀원 개인이 매일 작성하는 업무일지의 표준 템플릿을 정의합니다.
|
|
일관된 형식으로 작성하면 AI 자동 요약 연동 및 주간 회고 자동화가 가능합니다.
|
|
|
|
---
|
|
|
|
## 일일 업무일지 템플릿
|
|
|
|
> 파일명 규칙: `YYYY-MM-DD_이름.md` (예: `2026-03-19_홍길동.md`)
|
|
> 작성 시점: 업무 종료 전 (17:30~18:00 권장)
|
|
|
|
```markdown
|
|
# 업무일지 - YYYY-MM-DD (요일)
|
|
|
|
**작성자**: 이름
|
|
**팀**: FE팀
|
|
**작성 시각**: HH:MM
|
|
|
|
---
|
|
|
|
## ✅ 오늘 완료한 일
|
|
|
|
<!-- 태스크 ID와 함께 작성하면 자동 연동 가능 -->
|
|
|
|
- [ ] [T0-X] 태스크 제목: 간략한 작업 내용
|
|
- [ ] [T0-X] 태스크 제목: 간략한 작업 내용
|
|
- [ ] (태스크 외) 코드 리뷰, 회의, 기타 업무
|
|
|
|
**완료 요약**: 오늘 주요 성과를 1~2문장으로 요약
|
|
|
|
---
|
|
|
|
## 📋 내일 예정 작업
|
|
|
|
- [ ] [T0-X] 태스크 제목: 예상 작업 내용
|
|
- [ ] [T0-X] 태스크 제목: 예상 작업 내용
|
|
|
|
**예상 완료 비율**: X% (태스크 단위 예상)
|
|
|
|
---
|
|
|
|
## 🚧 블로커 / 의존성
|
|
|
|
<!-- 진행을 막는 이슈나 다른 팀원의 작업 완료를 기다리는 항목 -->
|
|
|
|
| 블로커 내용 | 영향 태스크 | 해결 담당 | 예상 해결일 |
|
|
|-------------|-------------|-----------|-------------|
|
|
| 예: Copilot 라이선스 미할당 | T0-3 | 시니어 Dev | 2026-03-20 |
|
|
|
|
블로커 없음 시: `없음`
|
|
|
|
---
|
|
|
|
## 📝 메모 / 학습 기록
|
|
|
|
<!-- 오늘 배운 것, 참고할 링크, 팀 공유 사항 등 -->
|
|
|
|
- 참고 링크:
|
|
- 학습 내용:
|
|
- 팀 공유 사항:
|
|
|
|
---
|
|
|
|
## 🔢 시간 배분 (선택)
|
|
|
|
| 업무 분류 | 소요 시간 |
|
|
|-----------|-----------|
|
|
| 개발 | Xh |
|
|
| 코드 리뷰 | Xh |
|
|
| 회의 | Xh |
|
|
| 문서 작업 | Xh |
|
|
| 기타 | Xh |
|
|
| **합계** | **8h** |
|
|
```
|
|
|
|
---
|
|
|
|
## 주간 요약 템플릿
|
|
|
|
> 파일명 규칙: `YYYY-WXX_이름_주간요약.md` (예: `2026-W12_홍길동_주간요약.md`)
|
|
> 작성 시점: 금요일 업무 종료 전
|
|
|
|
```markdown
|
|
# 주간 업무 요약 - YYYY년 XX주차 (MM/DD ~ MM/DD)
|
|
|
|
**작성자**: 이름
|
|
**작성일**: YYYY-MM-DD
|
|
|
|
---
|
|
|
|
## 이번 주 완료 태스크
|
|
|
|
| 태스크 ID | 태스크명 | 완료일 | 비고 |
|
|
|-----------|---------|--------|------|
|
|
| T0-X | 태스크명 | MM/DD | - |
|
|
|
|
---
|
|
|
|
## 이번 주 주요 성과
|
|
|
|
1.
|
|
2.
|
|
3.
|
|
|
|
---
|
|
|
|
## 다음 주 계획
|
|
|
|
| 우선순위 | 태스크 ID | 태스크명 | 예상 소요 |
|
|
|----------|-----------|---------|-----------|
|
|
| 높음 | T0-X | 태스크명 | X일 |
|
|
| 중간 | T0-X | 태스크명 | X일 |
|
|
|
|
---
|
|
|
|
## 블로커 / 리스크
|
|
|
|
-
|
|
|
|
---
|
|
|
|
## 기술 메모 / 학습
|
|
|
|
-
|
|
```
|
|
|
|
---
|
|
|
|
## AI 자동 요약 연동 방안
|
|
|
|
### 1. 일일 요약 자동화 (Claude API 활용)
|
|
|
|
업무일지 원문을 Claude API에 전달하여 핵심 요약을 자동 생성합니다.
|
|
|
|
#### 프롬프트 템플릿
|
|
|
|
```
|
|
당신은 FE 팀의 업무일지를 요약하는 AI 어시스턴트입니다.
|
|
아래 업무일지를 다음 형식으로 요약해주세요:
|
|
|
|
[요약 형식]
|
|
- 오늘의 핵심 성과: (1~2문장)
|
|
- 주요 완료 태스크: (태스크 ID와 함께 3개 이내)
|
|
- 내일 예정: (1~2문장)
|
|
- 블로커 여부: (있음/없음, 있을 경우 간략 설명)
|
|
|
|
[업무일지 내용]
|
|
{work_log_content}
|
|
```
|
|
|
|
#### 연동 방식 (검토 결과)
|
|
|
|
| 방식 | 장점 | 단점 | 권장 여부 |
|
|
|------|------|------|-----------|
|
|
| Claude API 직접 연동 (서버 스크립트) | 자동화 완전, 커스터마이징 자유 | 구현 비용, API 키 관리 필요 | **권장** (Sprint 1 이후 구현) |
|
|
| GitHub Actions + Claude API | PR/커밋 이벤트 트리거 가능 | GitHub 의존성 | 권장 (CI 파이프라인과 통합) |
|
|
| Notion AI 내장 기능 | 별도 구현 불필요 | Notion 플랜 필요, 커스터마이징 제한 | Notion 선택 시 단기 대안 |
|
|
| ChatGPT/Claude 수동 붙여넣기 | 즉시 사용 가능 | 자동화 불가, 수작업 | Sprint 0 임시 방안 |
|
|
|
|
### 2. 주간 요약 자동화 방안
|
|
|
|
```
|
|
매주 금요일 18:00에 GitHub Actions가 실행:
|
|
1. 해당 주의 일일 업무일지 파일 5개 수집
|
|
2. 파일 내용을 Claude API에 일괄 전달
|
|
3. 주간 팀 요약 자동 생성
|
|
4. Slack #daily-log 채널에 자동 게시
|
|
```
|
|
|
|
#### 주간 요약 자동화 프롬프트
|
|
|
|
```
|
|
당신은 FE 팀의 주간 업무를 요약하는 AI 어시스턴트입니다.
|
|
아래는 이번 주 팀원들의 업무일지 모음입니다.
|
|
팀 관리자를 위한 주간 요약을 작성해주세요:
|
|
|
|
[요약 형식]
|
|
1. 이번 주 팀 주요 성과 (3~5개)
|
|
2. 완료된 주요 태스크 목록
|
|
3. 현재 진행 중인 블로커
|
|
4. 다음 주 팀 계획 요약
|
|
5. 팀원별 기여 요약 (간략)
|
|
|
|
[업무일지 목록]
|
|
{work_logs_combined}
|
|
```
|
|
|
|
### 3. 단계별 도입 계획
|
|
|
|
| 단계 | 시점 | 방식 | 상태 |
|
|
|------|------|------|------|
|
|
| Phase 1 | Sprint 0 (현재) | 수동 작성 + 수동 AI 요약 | ✅ 즉시 적용 |
|
|
| Phase 2 | Sprint 1 | GitHub Actions + Claude API 자동 요약 스크립트 | 📋 계획됨 |
|
|
| Phase 3 | Sprint 2 이후 | Slack 연동 자동 게시, 주간 리포트 대시보드 | 📋 계획됨 |
|
|
|
|
---
|
|
|
|
## 작성 규칙 및 가이드라인
|
|
|
|
### 필수 작성 항목
|
|
- ✅ 오늘 완료한 일 (최소 1개)
|
|
- ✅ 내일 예정 작업 (최소 1개)
|
|
- ✅ 블로커 여부 (없음이라도 명시)
|
|
|
|
### 선택 작성 항목
|
|
- 📝 메모 / 학습 기록
|
|
- 🔢 시간 배분
|
|
|
|
### 작성 팁
|
|
1. **태스크 ID 명시**: `[T0-X]` 형식으로 로드맵 태스크와 연결
|
|
2. **구체적 작성**: "개발함" 대신 "Copilot 설정 가이드 VSCode 섹션 완료"
|
|
3. **블로커 조기 공유**: 하루 이상 막히면 즉시 팀에 공유
|
|
4. **시간 기록 권장**: 주간 회고 시 실제 소요 시간 파악에 활용
|
|
|
|
---
|
|
|
|
## Confluence/Notion 등록 가이드
|
|
|
|
### Notion 사용 시
|
|
1. 팀 워크스페이스 > FE팀 > 업무일지 페이지 생성
|
|
2. 위 템플릿을 Notion 템플릿으로 저장
|
|
3. 매일 새 페이지 생성 시 템플릿 적용
|
|
|
|
### Confluence 사용 시
|
|
1. FE팀 Space > 업무일지 > YYYY-MM 폴더 구조
|
|
2. 페이지 템플릿으로 등록 (Space 관리자 권한 필요)
|
|
3. 매일 새 페이지 생성 시 템플릿 적용
|
|
|
|
### Git 기반 (권장 - 자동화 용이)
|
|
```
|
|
docs/
|
|
└── work-logs/
|
|
├── 2026-03/
|
|
│ ├── 2026-03-23_홍길동.md
|
|
│ ├── 2026-03-24_홍길동.md
|
|
│ └── weekly/
|
|
│ └── 2026-W12_홍길동_주간요약.md
|
|
└── templates/
|
|
├── daily-template.md
|
|
└── weekly-template.md
|
|
```
|
|
|
|
> Git 저장소에 업무일지를 저장하면 GitHub Actions를 통한 자동 요약 연동이 가장 용이합니다.
|
|
|
|
---
|
|
|
|
## 검토 이력
|
|
|
|
| 날짜 | 버전 | 변경 내용 | 작성자 |
|
|
|------|------|-----------|--------|
|
|
| 2026-03-19 | v1.0 | 최초 작성 | 테크 리드 |
|