codex-rollout-extract-skill은(는) 무엇을 하나요?
Codex JSONL 롤아웃 파일에서 컨텍스트를 추출하고 구조화된 인수인계 보고서를 생성하여, 인계받은 에이전트가 신속히 작업 상태를 복원할 수 있도록 합니다.
개요
이 스킬은 Codex 도구(예: Claude Code, Cursor, Codex CLI)의 롤아웃 과정에서 생성된 JSONL 파일을 분석합니다. JSONL 파일에는 각 단계별 대화, 명령, 파일 변경 사항, 에러 로그 등이 기록되어 있습니다. 스킬은 이러한 데이터를 파싱하여 인수인계에 필요한 핵심 정보만 추출합니다.
사용 방법
- JSONL 파일 준비: Codex 세션에서 생성된 롤아웃 JSONL 파일을 준비합니다.
- 스킬 실행: 다음 명령어로 스킬을 실행합니다.
codex-rollout-extract-skill <path-to-rollout.jsonl> - 보고서 확인: 생성된 마크다운 보고서에서 추출된 컨텍스트를 확인합니다.
보고서 구조
보고서는 다음과 같은 섹션으로 구성됩니다:
- 작업 요약: 전체 작업의 목적과 범위 개요
- 진행 상황: 완료된 단계와 현재 진행 중인 작업
- 파일 변경 사항: 추가, 수정, 삭제된 파일 목록 및 변경 내용
- 미해결 이슈: 해결되지 않은 문제, 에러, 주의사항
- 결정 사항: 작업 중 내려진 주요 결정 및 근거
- 다음 단계: 인수인계 후 수행해야 할 작업 제안
지원 플랫폼
- Claude Code
- Cursor
- Codex CLI
- 기타 Codex 호환 도구
의존성
jq(JSON 처리에 필요)- 최신 버전의 Codex CLI 도구
예제
codex-rollout-extract-skill ./rollouts/session-2025-03-15.jsonl
출력 예시:
# 작업 요약
백엔드 API 리팩토링 작업 (진행률 60%)
## 진행 상황
- [x] 데이터베이스 스키마 설계 완료
- [x] 기본 CRUD 엔드포인트 구현
- [ ] 인증 미들웨어 통합 중
- [ ] 테스트 코드 작성 필요
## 파일 변경 사항
- `src/models/user.ts`: 새 파일 추가
- `src/routes/api.ts`: 수정 (라우트 추가)
- `src/middleware/auth.ts`: 수정 (JWT 검증 로직)
## 미해결 이슈
- 인증 토큰 만료 시 자동 갱신 로직 미구현
- 유닛 테스트 커버리지 40%
## 결정 사항
- JWT 토큰 유효시간 24시간으로 설정
- 비밀번호 해싱에 bcrypt 사용
## 다음 단계
1. 인증 미들웨어 통합 완료
2. API 엔드포인트 테스트 코드 작성
3. 코드 리뷰 요청
참고 사항
- JSONL 파일이 없을 경우 오류 메시지가 출력됩니다.
- 보고서는 표준 출력(stdout)으로 출력되며, 파일로 리다이렉트하여 저장할 수 있습니다.
- 대용량 JSONL 파일 처리 시 메모리 사용량에 주의하세요.