Codex Closeout Archive (종료 기록 보관)
이 스킬은 사용자가 명시적으로 Codex 대화를 종료, 보관, 수확 또는 보존하도록 요청할 때 사용합니다. 대화를 경량 프로세스 자산으로 변환한 후 대화를 보관합니다.
사용자의 명시적인 종료 요청이 자산화 결정입니다. 이 스킬이 호출된 후에는 해당 스레드가 보존 가치가 있는지 다시 논의하지 마십시오. 모든 종료는 간결한 프로세스 자산을 생성합니다.
이 스킬이 존재하는 이유
Codex 스레드에는 종종 실제 작업(의도 변경, 사용자 수정, 증거 경로, 파일 변경, 외부 소스 확인, 최종 결정)이 포함됩니다. 스레드가 앱에만 보관되면 다음 대화에서 결정이 변경된 이유를 알 수 없습니다.
이 스킬은 전체 대화록을 복사하지 않고 재사용 가능한 기록을 보존합니다. 다음을 보호합니다:
- 작업 증적: 향후 작업에서 원래 세션, 파일 및 증거를 찾을 수 있습니다.
- 결정 연속성: 주요 전환점과 수정 사항이 스레드 간에 유지됩니다.
- 낮은 마찰 종료: 모든 종료가 하나의 유용한 결과물을 생성하며, 큰 보관 시스템이 필요하지 않습니다.
대화가 조용해졌거나 에이전트가 깔끔한 마무리를 원한다는 이유로 이 스킬을 사용하지 마십시오. 사용자가 종료, 보관, 수확 또는 보존을 요청하는 경우에만 사용하십시오.
필수 사항
- 이 스킬이 사용될 때마다 프로세스 자산을 생성합니다.
- 기본적으로 관련 프로젝트 폴더를 사용합니다.
- 타임라인을 간결하게 유지합니다(보통 5-12개의 주요 전환점).
- 주요 전환점, 사용자 수정 사항, 결정 사항, 출력 파일 및 증거 경로를 보존합니다.
- 전체 원시 대화록, 전체 Slack 또는 DM 내용, 자격 증명 또는 민감한 내보내기 데이터를 자산에 붙여넣지 마십시오.
- 원본 Codex 세션 파일을 삭제, 이동 또는 다시 작성하지 마십시오.
- 자산이 작성되고 확인된 후, 사용자가 스레드를 종료하지 않고 자산을 준비하도록 요청하지 않는 한 현재 대화를 보관합니다.
작업 흐름
1. 대상 폴더 결정
현재 프로젝트를 나타내는 가장 작은 기존 폴더를 선택합니다.
다음 순서로 선호합니다:
- 사용자가 명시적으로 지정한 프로젝트 폴더.
- 스레드가 리포지토리별인 경우 리포지토리 또는 작업 공간 루트.
- 로컬
AGENTS.md, 작업 공간 지침 또는 사용자의 운영 체제에서 요구하는 지속적인 프로젝트, 영역 또는 작업 폴더. - 더 좁은 프로젝트 폴더가 명확하지 않은 경우 현재 작업 디렉터리.
여러 개의 그럴듯한 프로젝트 폴더가 있고 잘못된 폴더에 쓰면 정리 작업이 발생할 경우에만 간결한 질문을 한 번 합니다.
사용자 환경에 지속적인 기록 시스템이 있는 경우, 쓰기 전에 가장 가까운 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 스레드를 종료하고 추적 가능한 프로세스 자산을 생성해 주세요."
- "이 대화를 보관하고 주요 결정 사항과 증거 경로를 보존해 주세요."
- "이 스레드를 간결한 프로세스 자산으로 종료해 주세요."
- "종료를 실행하고 출력 경로와 세션 증거를 프로젝트 폴더에 남겨 주세요."