Community라이팅 & 에디팅github.com

Codex 종료 및 기록 보관

Codex 대화를 추적 가능한 프로세스 자산으로 전환하여 보관하는 스킬입니다.

Codex 종료 및 기록 보관란 무엇인가요?

이 스킬은 사용자가 명시적으로 Codex 대화의 종료, 보관, 수확 또는 보존을 요청할 때 활성화됩니다. 대화 내용을 경량 프로세스 자산으로 변환한 후 대화를 보관합니다. 주요 기능으로는 작업 증적(Traceability), 의사 결정 연속성, 그리고 낮은 마찰의 종료 절차를 제공합니다. 전체 대화 기록을 복사하는 대신 핵심 전환점, 사용자 수정 사항, 결정 사항, 출력 파일 및 증거 경로만 보존하여 재사용 가능한 기록을 남깁니다. 이 스킬은 Codex Desktop, Cursor, Windsurf, Claude Code, GitHub Copilot 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, 사용자의 명시적인 종료 요청이 없으면 사용하지 않아야 합니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add ChenJinCloud/codex-closeout-archive

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Codex Closeout Archive (종료 기록 보관)

이 스킬은 사용자가 명시적으로 Codex 대화를 종료, 보관, 수확 또는 보존하도록 요청할 때 사용합니다. 대화를 경량 프로세스 자산으로 변환한 후 대화를 보관합니다.

사용자의 명시적인 종료 요청이 자산화 결정입니다. 이 스킬이 호출된 후에는 해당 스레드가 보존 가치가 있는지 다시 논의하지 마십시오. 모든 종료는 간결한 프로세스 자산을 생성합니다.

이 스킬이 존재하는 이유

Codex 스레드에는 종종 실제 작업(의도 변경, 사용자 수정, 증거 경로, 파일 변경, 외부 소스 확인, 최종 결정)이 포함됩니다. 스레드가 앱에만 보관되면 다음 대화에서 결정이 변경된 이유를 알 수 없습니다.

이 스킬은 전체 대화록을 복사하지 않고 재사용 가능한 기록을 보존합니다. 다음을 보호합니다:

  • 작업 증적: 향후 작업에서 원래 세션, 파일 및 증거를 찾을 수 있습니다.
  • 결정 연속성: 주요 전환점과 수정 사항이 스레드 간에 유지됩니다.
  • 낮은 마찰 종료: 모든 종료가 하나의 유용한 결과물을 생성하며, 큰 보관 시스템이 필요하지 않습니다.

대화가 조용해졌거나 에이전트가 깔끔한 마무리를 원한다는 이유로 이 스킬을 사용하지 마십시오. 사용자가 종료, 보관, 수확 또는 보존을 요청하는 경우에만 사용하십시오.

필수 사항

  • 이 스킬이 사용될 때마다 프로세스 자산을 생성합니다.
  • 기본적으로 관련 프로젝트 폴더를 사용합니다.
  • 타임라인을 간결하게 유지합니다(보통 5-12개의 주요 전환점).
  • 주요 전환점, 사용자 수정 사항, 결정 사항, 출력 파일 및 증거 경로를 보존합니다.
  • 전체 원시 대화록, 전체 Slack 또는 DM 내용, 자격 증명 또는 민감한 내보내기 데이터를 자산에 붙여넣지 마십시오.
  • 원본 Codex 세션 파일을 삭제, 이동 또는 다시 작성하지 마십시오.
  • 자산이 작성되고 확인된 후, 사용자가 스레드를 종료하지 않고 자산을 준비하도록 요청하지 않는 한 현재 대화를 보관합니다.

작업 흐름

1. 대상 폴더 결정

현재 프로젝트를 나타내는 가장 작은 기존 폴더를 선택합니다.

다음 순서로 선호합니다:

  1. 사용자가 명시적으로 지정한 프로젝트 폴더.
  2. 스레드가 리포지토리별인 경우 리포지토리 또는 작업 공간 루트.
  3. 로컬 AGENTS.md, 작업 공간 지침 또는 사용자의 운영 체제에서 요구하는 지속적인 프로젝트, 영역 또는 작업 폴더.
  4. 더 좁은 프로젝트 폴더가 명확하지 않은 경우 현재 작업 디렉터리.

여러 개의 그럴듯한 프로젝트 폴더가 있고 잘못된 폴더에 쓰면 정리 작업이 발생할 경우에만 간결한 질문을 한 번 합니다.

사용자 환경에 지속적인 기록 시스템이 있는 경우, 쓰기 전에 가장 가까운 AGENTS.md 또는 동등한 프로젝트 지침을 따릅니다.

다음과 같은 파일 이름을 사용합니다:

<topic-slug>__codex-process-asset__YYYY-MM-DD.md

주제 슬러그가 명확하지 않은 경우 다음을 사용합니다:

codex-closeout__YYYY-MM-DD.md

2. 증거 찾기

자산을 작성하기 전에 증거 경로를 기록합니다.

다음을 찾습니다:

  • 현재 작업 공간 경로.
  • 현재 또는 보관된 Codex 세션 JSONL 경로.
  • 사용 가능한 경우 JSONL session_meta 페이로드의 스레드 ID.
  • 대화 중 생성, 편집, 이동 또는 확인된 파일.
  • 읽거나 쓴 외부 시스템(안전하게 보존할 수 있는 경우 링크 또는 쿼리 이름 포함).

세션 파일은 일반적으로 다음 경로에 있습니다:

~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl
~/.codex/archived_sessions/rollout-*.jsonl

Windows에서 ~는 일반적으로 사용자 프로필 디렉터리로 확인됩니다.

현재 라이브 세션이 아직 디스크에 표시되지 않은 경우 명시적으로 작성합니다:

Codex 세션 증거: 현재 라이브 스레드; 종료 시점에 JSONL을 찾을 수 없음.

선택적 도우미:

python scripts/extract_session_events.py --latest
python scripts/extract_session_events.py --session "/path/to/rollout.jsonl"

도우미는 원시 이벤트 목록을 가져오는 데만 사용합니다. 최종 타임라인은 직접 선별합니다.

3. 프로세스 자산 작성

다음 구조를 사용합니다:

# <제목> Codex 프로세스 자산

보관 날짜: YYYY-MM-DD
보관 시간: YYYY-MM-DD HH:mm+TZ
작업 공간: `<절대 경로>`
로컬 프로젝트: `<절대 경로>`
Codex 세션 증거: `<절대 경로 또는 라이브 스레드 참고>`
스레드 ID: `<ID 또는 알 수 없음>`

## 1. 자산 유형

이 파일은 프로세스 자산입니다. 전체 원시 대화록이 아닌 Codex 대화의 주요 진화 과정을 보존합니다.

## 2. 보존 이유

- <종료가 중요한 이유>
- <향후 독자가 이 자산에서 얻어야 할 내용>

## 3. 간결한 타임라인

| 시간 | 이벤트 | 의미 |
| --- | --- | --- |
| <시간> | <주요 전환점> | <중요한 이유> |

## 4. 출력 및 증거

| 유형 | 경로 / 링크 | 비고 |
| --- | --- | --- |

## 5. 결정 및 수정 사항

- <최종 결정>
- <중요한 사용자 수정>
- <명확해진 경계>

## 6. 미해결 후속 조치

- <항목 또는 "기록 없음">

## 7. 경계

- 원시 개인 메시지, 자격 증명 및 전체 Codex JSONL 내용은 복사되지 않았습니다.
- 원본 세션 파일은 그대로 두었습니다.

## 8. 검색 태그

- <태그>

문장을 간결하게 유지합니다. 자산은 1-2분 내에 다시 읽을 수 있어야 합니다.

4. 주변 색인 업데이트

가장 가까운 작은 검색 표면이 존재하는 경우 업데이트합니다:

  • 프로젝트 폴더의 README.md 또는 index.md(아티팩트 테이블 또는 소스 맵이 있는 경우).
  • 프로젝트 폴더의 CHANGELOG.md(있는 경우).
  • AGENTS.md 또는 동등한 작업 공간 정책에서 요구하는 모든 로컬 실행 원장 또는 프로젝트 색인.

합리적인 프로젝트 폴더가 없는 경우에만 종료 전용 새 폴더를 만들지 마십시오.

5. 확인

마무리하기 전에:

  • 프로세스 자산이 의도한 경로에 존재하는지 확인합니다.
  • 자산에서 세션 증거 경로 또는 라이브 스레드 참고를 검색합니다.
  • 색인 또는 변경 로그 업데이트가 새 자산을 언급하는지 확인합니다.
  • 변경된 파일을 나열합니다.

6. 최종 응답 및 보관

다음과 함께 간결하게 응답합니다:

  • 프로세스 자산 경로.
  • 업데이트된 색인 또는 변경 로그 파일.
  • 증거 경로 상태.
  • 미해결된 후속 조치.

그런 다음 현재 대화를 보관합니다. Codex Desktop에서 보관 지시문을 마지막 줄로 내보냅니다:

::archive{reason="종료 프로세스 자산이 생성되고 대화가 보관되었습니다"}

사용자가 스레드를 종료하지 않고 종료를 준비하도록 요청하는 경우에만 보관 지시문을 건너뜁니다.

예시

다음과 같은 프롬프트에 이 스킬을 사용합니다:

  • "이 Codex 스레드를 종료하고 추적 가능한 프로세스 자산을 생성해 주세요."
  • "이 대화를 보관하고 주요 결정 사항과 증거 경로를 보존해 주세요."
  • "이 스레드를 간결한 프로세스 자산으로 종료해 주세요."
  • "종료를 실행하고 출력 경로와 세션 증거를 프로젝트 폴더에 남겨 주세요."

관련 스킬