ChenJinCloud/codex-closeout-archive

Codex Closeout Archive

Verwenden Sie dieses Skill, wenn der Benutzer explizit darum bittet, eine Codex-Konversation zu schließen, zu archivieren, zu beenden, zu ernten oder zu bewahren. Es wandelt die Konversation in ein leichtgewichtiges Prozess-Artefakt um und archiviert die Konversation anschließend.

Die explizite Aufforderung des Benutzers ist die Entscheidung zur Asset-Erstellung. Hinterfragen Sie nicht erneut, ob der Thread die Bewahrung verdient, sobald dieses Skill aufgerufen wurde. Jeder Abschluss erzeugt ein prägnantes Prozess-Artefakt.

Warum dieses Skill existiert

Codex-Threads enthalten oft die eigentliche Arbeit: Absichtswechsel, Benutzerkorrekturen, Evidenzpfade, Dateiänderungen, Überprüfungen externer Quellen und endgültige Entscheidungen. Wird der Thread nur in der App archiviert, kann die nächste Konversation verlieren, warum Entscheidungen geändert wurden.

Dieses Skill bewahrt den wiederverwendbaren Pfad, ohne das gesamte Transkript zu kopieren. Es schützt:

• Nachvollziehbarkeit: Zukünftige Arbeiten können die ursprüngliche Sitzung, Dateien und Belege finden.
• Entscheidungskontinuität: Wichtige Wendungen und Korrekturen überleben Thread-Grenzen.
• Reibungsfreier Abschluss: Jedes Ende erzeugt ein nützliches Artefakt, kein großes Archivsystem.

Verwenden Sie dieses Skill nicht nur, weil eine Konversation ruhig geworden ist oder ein Agent einen sauberen Abschluss wünscht. Verwenden Sie es, wenn Abschluss, Archivierung, Ernte oder Bewahrung der vom Benutzer angeforderte nächste Zustand ist.

Unverhandelbar

• Erstellen Sie bei jeder Verwendung dieses Skills ein Prozess-Artefakt.
• Verwenden Sie standardmäßig den zugehörigen Projektordner.
• Halten Sie die Zeitleiste kurz: in der Regel 5–12 wichtige Wendungen.
• Bewahren Sie wichtige Wendungen, Benutzerkorrekturen, Entscheidungen, Ausgabedateien und Evidenzpfade auf.
• Fügen Sie keine vollständigen Roh-Transkripte, vollständigen Slack- oder DM-Inhalt, Zugangsdaten oder sensible Exporte in das Artefakt ein.
• Löschen, verschieben oder überschreiben Sie keine originalen Codex-Sitzungsdateien.
• Nachdem das Artefakt geschrieben und verifiziert wurde, archivieren Sie die aktuelle Konversation, es sei denn, der Benutzer bittet darum, das Artefakt vorzubereiten, ohne den Thread zu beenden.

Arbeitsablauf

1. Ziel ermitteln

Wählen Sie den kleinsten vorhandenen Ordner, der das aktuelle Projekt repräsentiert.

Bevorzugen Sie in dieser Reihenfolge:

1. Ein vom Benutzer explizit benannter Projektordner.
2. Das Repo- oder Arbeitsbereichs-Root, falls der Thread repo-spezifisch ist.
3. Ein dauerhafter Projekt-, Bereichs- oder Operationsordner, der von der lokalen AGENTS.md, Arbeitsbereichsanweisungen oder dem Betriebssystem des Benutzers gefordert wird.
4. Das aktuelle Arbeitsverzeichnis, wenn kein engerer Projektordner offensichtlich ist.

Stellen Sie nur eine prägnante Frage, wenn mehrere plausible Projektordner existieren und das Schreiben in den falschen Aufräumarbeiten verursachen würde.

Wenn die Umgebung des Benutzers ein dauerhaftes Aufzeichnungssystem hat, folgen Sie vor dem Schreiben dessen nächstgelegener AGENTS.md oder gleichwertigen Projektanweisungen.

Verwenden Sie einen Dateinamen wie:

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

Wenn kein Thema-Slug offensichtlich ist, verwenden Sie:

codex-closeout__YYYY-MM-DD.md

2. Evidenz lokalisieren

Zeichnen Sie Evidenzpfade auf, bevor Sie das Artefakt schreiben.

Suchen Sie nach:

• Aktuellem Arbeitsbereichspfad.
• Aktuellem oder archiviertem Codex-Sitzungs-JSONL-Pfad.
• Thread-ID aus dem session_meta-Payload des JSONL, falls verfügbar.
• Dateien, die während der Konversation erstellt, bearbeitet, verschoben oder verifiziert wurden.
• Externe Systeme, die gelesen oder beschrieben wurden, mit Links oder Abfragenamen, sofern die Aufbewahrung sicher ist.

Die Sitzungsdatei befindet sich üblicherweise unter:

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

Unter Windows wird ~ meist in das Benutzerprofilverzeichnis aufgelöst.

Wenn die aktive Sitzung noch nicht auf der Festplatte sichtbar ist, schreiben Sie dies explizit:

Codex session evidence: current live thread; JSONL not located at closeout time.

Optionaler Helfer:

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

Verwenden Sie den Helfer nur, um ein rohes Ereignisinventar zu erhalten. Kuratieren Sie die endgültige Zeitleiste selbst.

3. Das Prozess-Artefakt schreiben

Verwenden Sie diese Struktur:

# <Titel> Codex Process Asset

Archiviert am: YYYY-MM-DD
Archivierungszeit: YYYY-MM-DD HH:mm+TZ
Arbeitsbereich: `<absoluter Pfad>`
Lokales Projekt: `<absoluter Pfad>`
Codex-Sitzungs-Evidenz: `<absoluter Pfad oder Hinweis auf Live-Thread>`
Thread-ID: `<ID oder unbekannt>`

## 1. Asset-Typ

Diese Datei ist ein Prozess-Artefakt. Es bewahrt die wichtigste Entwicklung der Codex-Konversation, nicht das vollständige Roh-Transkript.

## 2. Warum dies bewahrt wurde

- <warum der Abschluss wichtig ist>
- <was ein zukünftiger Leser aus diesem Artefakt gewinnen soll>

## 3. Kurze Zeitleiste

| Zeit | Ereignis | Bedeutung |
| --- | --- | --- |
| <Zeit> | <wichtige Wende> | <warum es wichtig war> |

## 4. Ausgaben und Evidenz

| Typ | Pfad / Link | Hinweise |
| --- | --- | --- |

## 5. Entscheidungen und Korrekturen

- <endgültige Entscheidung>
- <wichtige Benutzerkorrektur>
- <geklärte Grenze>

## 6. Offene Folgemaßnahmen

- <Punkt oder „Keine aufgezeichnet“>

## 7. Grenzen

- Rohe private Nachrichten, Zugangsdaten und vollständiger Codex-JSONL-Inhalt wurden nicht kopiert.
- Originale Sitzungsdateien wurden nicht verändert.

## 8. Abruf-Tags

- <Tag>

Halten Sie den Text knapp. Das Artefakt sollte in ein bis zwei Minuten lesbar sein.

4. Nahegelegene Indizes aktualisieren

Aktualisieren Sie die kleinste nahegelegene Entdeckungsoberfläche, sofern vorhanden:

• README.md oder index.md im Projektordner, falls dieser eine Artefakt-Tabelle oder Quellenkarte enthält.
• CHANGELOG.md im Projektordner, falls vorhanden.
• Jedes lokale Laufprotokoll oder Projektindex, der von AGENTS.md oder einer gleichwertigen Arbeitsbereichsrichtlinie gefordert wird.

Erstellen Sie keinen neuen Ordner nur für Abschlüsse, es sei denn, es existiert kein sinnvoller Projektordner.

5. Verifizieren

Überprüfen Sie vor dem Abschluss:

• Bestätigen Sie, dass das Prozess-Artefakt am vorgesehenen Pfad existiert.
• Durchsuchen Sie das Artefakt nach dem Sitzungs-Evidenzpfad oder dem Live-Thread-Hinweis.
• Bestätigen Sie, dass jede Index- oder Changelog-Aktualisierung das neue Artefakt erwähnt.
• Listen Sie die geänderten Dateien auf.

6. Abschließende Antwort und Archivierung

Antworten Sie kurz mit:

• Pfad des Prozess-Artefakts.
• Aktualisierte Index- oder Changelog-Dateien.
• Status des Evidenzpfads.
• Offene Folgemaßnahmen.

Archivieren Sie dann die aktuelle Konversation. Geben Sie in Codex Desktop die Archivierungsanweisung als letzte Zeile aus:

::archive{reason="Closeout process asset created and conversation archived"}

Überspringen Sie die Archivierungsanweisung nur, wenn der Benutzer darum bittet, einen Abschluss vorzubereiten, ohne den Thread zu beenden.

Beispiele

Verwenden Sie dieses Skill für Aufforderungen wie:

• „Beenden Sie diesen Codex-Thread und erstellen Sie ein nachvollziehbares Prozess-Artefakt.“
• „Archivieren Sie diese Konversation unter Bewahrung der wichtigsten Entscheidungen und Evidenzpfade.“
• „Schließen Sie diesen Thread mit einem prägnanten Prozess-Artefakt ab.“
• „Führen Sie den Abschluss durch und hinterlassen Sie den Ausgabepfad und die Sitzungs-Evidenz im Projektordner.“