OpenParable
Skip to content
← Back to skills

Devlog

Productivity
devlog

Devlog is an Agent Skill for productivity published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Record development work logs to _devlog/YYYY-MM-DD.md. 작업 로그 기록, 명령어/결정사항/다음 단계 포함. Use with /devlog, /devlog [title], or /devlog --summary.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/data/devlog/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/devlog, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

/devlog - 작업 로그 기록

개발 작업 내용을 devlog 파일에 기록합니다. Git 커밋 여부와 관계없이 작업 내용을 남길 수 있습니다.

실행 방법

  1. 현재 상태 파악

    • Git 사용 가능 여부 확인 (git rev-parse --git-dir 2>/dev/null)
    • Git 있으면: git status --short 결과 참고
    • Git 없으면: 수동 입력 모드
  2. 사용자에게 질문 (필요시)

    • "어떤 작업을 하셨나요?" (자유 형식)
    • 또는 이전 대화 컨텍스트에서 작업 내용 요약
  3. devlog 파일 생성/업데이트

    • 프로젝트 루트: Git repo면 git rev-parse --show-toplevel, 아니면 $PWD
    • 경로: {project-root}/_devlog/YYYY-MM-DD.md
    • _devlog 폴더가 없으면 생성
    • 같은 날짜 파일이 있으면 해당 파일에 append (하루 한 파일)
    • 순번 결정: 파일 내 마지막 ## N. 헤더를 찾아 N+1 사용

로그 형식

## N. 작업 제목

### 작업 내용
- 수행한 작업 요약

### 실행한 명령어
```bash
# 주요 명령어 (나중에 복붙 가능하도록)
docker-compose up -d
curl -X POST ...

확인 결과

항목상태
빌드 성공✅
테스트 통과✅
API 응답 확인✅

주요 결정사항

  • 왜 이렇게 했는지

생성/변경된 파일

  • path/to/file.md

다음 단계

  • TODO 1
  • TODO 2


## 상세 수준 가이드

**포함할 것:**
- 주요 명령어 (나중에 따라할 수 있도록)
- 핵심 결과 (테이블 형태로 간결하게)
- 결정 사항과 이유
- 다음 단계

**생략할 것:**
- 전체 출력 로그 (너무 길면)
- 시행착오 과정 (최종 성공한 것만)
- 자명한 내용

## 순번 규칙

- 시간 대신 순번 사용: `## 1.`, `## 2.`, `## 3.` ...
- 같은 날 여러 작업 시 순번 증가
- 다음 날은 다시 1번부터

## 사용 예시

```bash
# 대화형으로 로그 작성
/devlog

# 제목과 함께 바로 작성
/devlog Docker 환경 구축 완료

# 현재 세션 작업 전체 요약
/devlog --summary

자동 요약 모드 (--summary)

/devlog --summary 실행 시 현재 세션의 작업을 자동으로 요약:

  1. 작업 내용 자동 추출

    • 대화에서 수행한 작업 식별
    • 파일 생성/수정 내역 수집
    • 주요 결정사항 추출
  2. 실행한 명령어 수집

    • Bash 도구로 실행한 명령어 목록화
    • 재현 가능한 형태로 정리
  3. 결과 요약

    • 성공/실패 여부
    • 확인된 동작
  4. 사용자 확인 후 저장

    • 요약 내용 미리보기 제공
    • 수정 요청 가능
    • 확인 후 파일에 저장