Przejdź do treści
Biblioteka skilli
AI i agenci · Pisanie

codex-activity-report

/codex-activity-report

Tworzy z artefaktów aktywności Codex (logi .codex, pliki rollout JSONL, historia, logi SQLite) znormalizowaną oś czasu UTC i raport Markdown w katalogu reports/.

Repozytorium
skills ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
14.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
6
Skrypty
1
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 14.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co sprawdzić przed instalacją
  • 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/generate_codex_activity_report.py

Co robi i kiedy

Tworzy z artefaktów aktywności Codex (logi .codex, pliki rollout JSONL, historia, logi SQLite) znormalizowaną oś czasu UTC i raport Markdown w katalogu reports/.

Oryginalny opis (EN)

Generate a normalized UTC timeline and evidence-based narrative from Codex activity artifacts. Use when Codex needs to turn `.codex` logs, rollout JSONL files, archived session bundles, history files, SQLite logs, or planner state into Markdown reporting under `reports/`, especially for after-action reporting, operator handoff, chronology reconstruction, or evidence-backed engagement summaries.

Jak działa

  1. Overview
  2. Workflow
  3. Command
  4. Output Rules
  5. Sources
Sekcje z nagłówków SKILL.md, w oryginale · 62 linii, 367 słów
Podgląd SKILL.md
---
name: codex-activity-report
description: Generate a normalized UTC timeline and evidence-based narrative from Codex activity artifacts. Use when Codex needs to turn `.codex` logs, rollout JSONL files, archived session bundles, history files, SQLite logs, or planner state into Markdown reporting under `reports/`, especially for after-action reporting, operator handoff, chronology reconstruction, or evidence-backed engagement summaries.
metadata:
  author: "GhostWorks"
---

# Codex Activity Report

## Overview

Generate two Markdown reports from the local Codex evidence trail: a normalized timeline and a narrative chronology. Use the bundled generator to preserve exact UTC timestamps, exact operator prompts, and exact command strings while keeping the output readable.

## Workflow

1. Resolve the target repository root. Default to the current repository when it contains `.codex/`.
2. Run the bundled generator script and let it write into `reports/`.
3. Review the generated Markdown only for obvious formatting issues or user-requested voice changes. Do not rewrite timestamps, prompts, or commands.
4. Keep both outputs in UTC.

## Command

Run the generator from the repository root or pass `--repo-root` explicitly:

```bash
python3 plugins/codex-observability/skills/codex-activity-report/scripts/generate_codex_activity_report.py
```

Useful flags:

- `--repo-root /absolute/path/to/repo`
- `--codex-home /absolute/path/to/.codex`
- `--output-dir /absolute/path/to/repo/reports`
- `--timeline-name custom-timeline.md`
- `--narrative-name custom-narrative.md`
- `--session-id <session-id>`
- `--focus-pattern 'app-server-experiments|codex-app-server-client'`
- `--no-archives`

Use `--focus-pattern` when you want a report for one workstream inside a larger `.codex` history. The generator seeds sessions from matching events and then keeps the full session chronology so the resulting timeline does not lose nearby actions that used generic commands.

## Output Rules

- Write the reports to `reports/` unless the operator asks for a different output directory.
- Generate a normalized timeline:
  - keep prompts, approvals, patches, warnings, errors, and saved state artifacts discrete;
  - group repetitive read-only inspection commands and empty PTY polls.
- Generate a narrative chronology:
  - keep the tone evidence-based and in active voice;
  - use `the operator`, `Codex`, or `the Codex harness` as the actor names;
  - use `On <Month Day, Year> at HH:MM:SS UTC, ...` for the first event of a day;
  - use `At HH:MM:SS UTC, ...` for later same-day events.
- Quote user prompts and exact commands verbatim when the artifacts contain them.
- Preserve UTC in both files even when the source artifact also exposes local filesystem metadata.

## Sources

The generator already knows how to parse the primary Codex artifacts in this repository class:

- rollout JSONL files under `.codex/sessions/`
- archived rollout JSONL files inside `.codex/sessions/**/*.zip`
- `.codex/history.jsonl`
- `.codex/log/codex-tui.log`
- `.codex/logs*.sqlite`
- planner and agent artifacts under `.codex/state/`

Read `references/log-sources.md` only when you need the exact precedence and normalization details.
Pliki w paczce (6)
  • SKILL.md 3 KB
  • agents/openai.yaml 1 KB
  • assets/icon.png 2 KB
  • assets/icon.svg 1 KB
  • references/log-sources.md 2 KB
  • scripts/generate_codex_activity_report.py 62 KB

Wersje

W bazie nie ma innych skilli o nazwie codex-activity-report.

Migawka bazy z 13.11.2026 · wersja paczki fc7ddf9cf236 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100analyzing-codex-sessions
    Analizuje surowe logi sesji Codex CLI: parsuje pliki rollout JSONL, bada zachowanie subagentów Codex, wyciąga metryki wątków i debuguje, dlaczego agent zawiódł.
  • 100codex-session-manager
    Zarządza lokalnymi transkrypcjami sesji Codex: wyświetla sesje, eksportuje je do uporządkowanego Markdown, przegląda archiwa i streszcza historię wywołań narzędzi.
  • 82codex-handoff
    Przekazuje bieżącą pracę do nowego zadania w Codex.
  • 100codex-plan-files
    Prowadzi plany pracy Codex jako pliki Markdown w jednym folderze z automatycznie generowanym indeksem.
  • 100codex-thread-reader
    Lokalizuje i czyta wątek Codex po linku, identyfikatorze lub ścieżce rollout we wszystkich lokalnych katalogach CODEX_HOME, buduje oś czasu długiego wątku oraz przeszukuje i eksportuje rozmowy.
  • 100keep-codex-fast
    Diagnozuje rozrost lokalnego stanu Codex Desktop lub CLI i podpowiada bezpieczne sposoby odzyskania szybkości: sesje, archiwa historii, logi, worktrees i stara konfiguracja.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.