Work Tracker

매일 출퇴근 시점에 업무 컨텍스트를 자동 캡처하고, 월간 보고서를 생성하는 Claude Code 스킬.

커맨드

/clockin                              # 출근 기록
/clockin 오늘은 로그인 페이지 작업 예정          # 출근 + 오늘 계획 메모

/clockout                             # 퇴근 → 일간 요약 자동 생성
/clockout 코드리뷰 2건, 프론트 미팅 참석   # 퇴근 + 코드 외 업무 메모

/recap                              # 전달 월간 보고서 생성
/recap 2025-02                      # 특정 월 지정
/recap 이번달                        # 이번 달 (진행중)
/recap 2025-01 2025-03              # 1월~3월 범위
/recap q1                           # 1분기 (1~3월)
/recap 상반기                        # 상반기 (1~6월)
/recap --template=~/t.md            # 커스텀 양식

어떻게 동작하는가

/clockin (08:30)
  → Git HEAD 스냅샷 저장
  → 세션 마커 설정

  ... 하루 동안 터미널 여러 개 열고 닫으며 작업 ...
  (세션마다 JSONL이 자동으로 디스크에 쌓임)

/clockout (17:30)
  → Session JSONL 자동 수집 (오늘 모든 세션)
  → Git diff 수집 (clockin HEAD vs 현재 HEAD)
  → Auto Memory 변경분 수집
  → MR/Branch 정보 수집
  → + 사용자 수동 메모 (코드 외 업무)
  → Claude가 일간 요약 생성
  → 로컬 .md / Notion / Obsidian / Confluence 저장

/recap (매월 초)
  → 30일치 일간 요약 로드
  → 서비스별 태스크 종합
  → 사용자가 보고할 항목 선택
  → 4열 테이블 보고서 생성 (목표/핵심결과/잘한점/보완계획)
  → 내보내기

Claude Code의 세션 간 컨텍스트 유지 메커니즘

이 스킬이 "터미널을 여러 번 열고 닫아도 컨텍스트가 유지된다"고 말할 수 있는 이유는, Claude Code가 3겹의 영속 데이터를 디스크에 남기기 때문이다.

1. Auto Memory (공식, v2.1.59+)

• 위치: ~/.claude/projects/<project>/memory/
• 내용: Claude가 스스로 중요하다고 판단한 것을 자동 저장. 빌드 명령, 디버깅 인사이트, 아키텍처 노트, 코드 스타일 선호 등.
• 특징: 세션 시작 시 자동 로드. /memory로 확인/토글 가능.

2. Session Memory (공식, Pro/Max)

• 위치: ~/.claude/projects/<hash>/<session-id>/session-memory/summary.md
• 내용: 세션 중 ~10,000토큰마다 자동으로 요약 생성. 다음 세션 시작 시 관련 과거 세션 요약을 자동 주입.
• 특징: "Recalled X memories" / "Wrote X memories" 메시지로 확인. ctrl+o로 내용 조회.
• 주의: 과거 세션을 "참고 자료"로 취급하며, 지시사항으로 따르지는 않음.

3. Session JSONL 트랜스크립트 (비공식, 안정적)

• 위치: ~/.claude/projects/<hash>/<session-id>.jsonl
• 내용: 모든 대화의 라인별 트랜스크립트. 메시지, 도구 사용, 파일 편집 전부 기록.
• 특징: claude --resume 또는 claude -c로 이전 세션 이어가기 가능.
• 이 스킬에서의 역할: /clockout이 이 JSONL을 파싱하여 오늘 하루의 모든 세션 컨텍스트를 복원함. 가장 핵심적인 데이터 소스.

결론: 세션이 끝나도 대화 데이터는 디스크에 남아있다. /clockout은 이 데이터를 읽어서 일간 요약을 만들기 때문에, 터미널을 몇 번 열고 닫든 상관없다.

로컬 파일 저장 — 용량 문제 없음

일간 요약은 텍스트 파일(2~3KB/일)이라 용량 부담이 거의 없다.

| 기간 | 파일 수 | 용량 | | ----- | -------- | ------ | | 1개월 | ~22개 | ~60KB | | 1년 | ~260개 | ~720KB | | 5년 | ~1,300개 | ~3.5MB |

5년을 써도 사진 한 장보다 작다.

자동 파일 정리 정책

파일 수가 쌓이는 것은 자동 정리로 관리한다. /clockin 실행 시 백그라운드로 정리.

• Hot (0~2개월): 개별 .md 파일 원본 보관. /recap가 직접 읽는 대상.
• Archive (3개월+): 월별 1개 archive.md로 병합. 30개 파일 → 1개 (~5KB).
• Cold (1년+): 외부 백업이 있으면 로컬 삭제 가능. 없으면 그대로 유지 (부담 없음).

# config에서 정책 설정
file_management:
  archive_after_months: 2 # 2개월 지난 일간 요약 자동 archive
  delete_archive_after_months: 0 # 0 = 삭제 안 함
  keep_monthly_reports: true # 최종 보고서는 항상 보관

개선 여지

• 현재는 단순 시간 기반 archive. 향후 "중요도 기반 보관" (커밋 많은 날은 상세 보관, 적은 날은 요약만) 가능.
• Git LFS 스타일의 로컬/원격 분리 — 최근 N개월은 로컬, 나머지는 Notion/Confluence에서 온디맨드 로드.
• archive 포맷을 SQLite로 변경하면 날짜 범위 검색이 빨라짐.

보안

이 스킬은 Git 히스토리, Claude 세션 대화 등 민감할 수 있는 데이터를 다루기 때문에 다층적 보안 필터링을 적용한다.

절대 수집하지 않는 것

• 시크릿/크리덴셜: API 키, 토큰, 비밀번호, 인증서, 개인키 등
• 환경 변수 파일: .env, .env.local, .env.production 등의 내용
• 인증서/키 파일: *.pem, *.key, *.p12 등의 내용
• 개인정보(PII): 주민등록번호, 카드번호 등
• 인프라 정보: 내부 IP, DB 접속 문자열, 서버 호스트명

수집 단계별 필터링

| 단계 | 필터링 내용 | | -------------- | ------------------------------------------------------------------------ | | Git diff | 커밋 메시지만 수집, 코드 diff 전문 X. .env* 관련 커밋은 마스킹 | | Session JSONL | 코드 블록 제거, 시크릿 포함 메시지 스킵, Bash 명령어 중 민감 명령 마스킹 | | 일간 요약 저장 | 파일 경로를 레포 기준 상대경로로 변환, 홈 디렉토리 절대경로 제거 | | 외부 전송 | 전송 전 최종 스캔, 내부 IP/도메인 마스킹, 사용자 확인 요청 | | 로컬 저장 | 파일 권한 chmod 600 (소유자만 읽기) |

collect_sessions.py의 내장 필터

스크립트에 정규식 기반 필터가 내장되어 있다:

• contains_secret(text) — 시크릿 패턴 감지
• sanitize_text(text) — 민감 정보 마스킹, 코드 블록 제거
• sanitize_filepath(path) — 민감 파일 마스킹, 절대경로→상대경로 변환
• is_sensitive_file(path) — .env, .pem 등 민감 파일 판별

주의사항

• 필터링은 최선의 노력(best-effort) 방식이다. 모든 민감 정보를 100% 잡아내지 못할 수 있다.
• 외부(Notion/Confluence 등)로 전송하기 전에 사용자가 직접 한 번 더 확인하는 것을 권장한다.
• 회사의 보안 정책에 따라 외부 전송 자체를 비활성화할 수 있다 (daily_storage.notion.enabled: false 등).

설치 및 초기 설정

1. 스킬 설치

curl -fsSL https://raw.githubusercontent.com/ioslife/my-claude-skill/main/install.sh | bash

2. 초기 설정 (최초 1회)

설치 후 Claude Code에서 /clockin을 처음 실행하면 아래 3단계 셋업이 자동으로 시작된다. 설정 파일(~/.claude/work-tracker-config.yaml)이 이미 있으면 셋업은 건너뛴다.

[1/3] 레포지토리 선택

레포지토리가 모여 있는 상위 폴더 경로를 입력해주세요.
(예: ~/projects, ~/repos, ~/workspace)
>

경로를 입력하면 해당 폴더 안의 Git 레포를 자동으로 스캔해서 목록으로 보여준다.

다음 레포지토리를 발견했습니다. 추적할 레포를 선택해주세요.
(번호를 쉼표로 구분, 예: 1,3 / 'all'로 전체 선택)

  1. my-service-a
  2. my-service-b
  3. infra-scripts

> 선택:

선택한 레포마다 보고서에 표시될 서비스 이름을 입력한다. Enter를 누르면 폴더명 그대로 사용한다.

[2/3] 로컬 저장 위치

일간 요약 .md 파일을 어디에 저장할지 선택한다.

일간 요약을 저장할 위치를 선택해주세요.

  1. ~/.claude/work-logs/  (기본값, 권장)
  2. 직접 입력

> 선택 (Enter = 1번):

[3/3] 기본 출퇴근 시간

출퇴근을 깜빡했을 때 사용할 기본 시간을 설정한다. Enter를 누르면 기본값이 적용된다.

기본 출근 시간 (Enter = 08:30):
>

기본 퇴근 시간 (Enter = 17:30):
>

세션 데이터나 Git 커밋으로 시간을 추정할 수 없을 때 이 값이 사용된다.

[4/4] 외부 자동 전송 (선택)

/clockout 시 일간 요약을 자동으로 보낼 외부 서비스를 선택한다. 로컬 저장은 항상 기본으로 포함되며, 외부 전송은 선택 사항이다.

퇴근(clockout) 시 일간 요약을 자동으로 전송할 곳을 선택해주세요.
(번호를 쉼표로 구분해 여러 곳 선택 가능 / Enter = 없음)

  1. Notion        — 지정한 데이터베이스에 페이지로 자동 생성
  2. Obsidian      — 지정한 볼트 폴더에 마크다운 파일로 저장
  3. Confluence    — 지정한 스페이스에 페이지로 자동 생성
  4. 기타          — 저장할 폴더 경로를 직접 지정
  5. 없음          — 로컬만 저장

> 선택:

선택한 서비스에 따라 Database ID, Vault 경로 등 필요한 값을 추가로 입력한다.

셋업 완료

모든 단계가 끝나면 설정 파일이 저장되고 슬래시 커맨드가 자동 등록된다.

✅ 설정이 완료되었습니다!

📂 추적 레포: my-service-a (서비스A), my-service-b (서비스B)
💾 로컬 저장: ~/.claude/work-logs/
⏰ 기본 시간: 출근 08:30 / 퇴근 17:30
📤 자동 전송: Notion (database: xxxx)
   → /clockout 할 때마다 위 경로에 자동으로 업로드됩니다.

슬래시 커맨드가 등록되었습니다. Claude Code를 재시작하면
/clockin, /clockout, /recap이 자동완성 목록에 나타납니다.

설정 변경: 나중에 설정을 바꾸고 싶으면 그냥 말로 하면 된다.

노션 말고 이제 옵시디언으로 쓸거야
레포 하나 더 추가해줘
저장 위치 ~/Dropbox/work-logs 로 바꿔줘

변경 전후를 보여주고 확인을 받은 뒤 ~/.claude/work-tracker-config.yaml을 자동으로 업데이트한다.

내보내기 대상

| 대상 | 일간 요약 | 월간 보고서 | 연동 방식 | | ---------- | --------- | ----------- | --------------------------- | | 로컬 | ✅ (기본) | ✅ | 파일 시스템 직접 쓰기 | | Notion | ✅ | ✅ | Notion MCP 서버 또는 API | | Obsidian | ✅ | ✅ | 볼트 경로에 .md 파일 저장 | | Confluence | ✅ | ✅ | Atlassian MCP 서버 또는 API | | 클립보드 | — | ✅ | 복사만 |

디렉토리 구조

~/.claude/
├── work-tracker-config.yaml          # 설정 파일
└── work-logs/
    ├── today.yaml                    # 오늘의 clockin 상태
    ├── clockin_sessions.txt          # clockin 시점 세션 목록
    ├── 2025/
    │   ├── 01/
    │   │   └── archive.md            # 3개월+ 지난 월은 archive
    │   ├── 02/
    │   │   └── archive.md
    │   └── 03/
    │       ├── 2025-03-01.md         # 개별 일간 요약
    │       ├── 2025-03-02.md
    │       └── ...
    └── reports/                      # 최종 보고서 (항상 보관)
        ├── 2025-01-업무리스트.md
        ├── 2025-01-피드백.md
        └── ...

비개발자 확장

동일한 프레임워크로 직군별 커스터마이징 가능. config의 context_sources만 변경.

| 직군 | 자동 소스 | 수동 소스 | | ----------------- | ----------------------------------- | --------------- | | 프론트엔드 개발자 | Session JSONL, Git, MR, Auto Memory | 미팅, 코드리뷰 | | 기획자/PM | Jira/Linear, Notion, Calendar (MCP) | 이해관계자 미팅 | | 디자이너 | Figma API, Notion (MCP) | 디자인 리뷰 |