Przejdź do treści
Biblioteka skilli
AI i agenci · Przegląd i audyt

retro

/retro

Robi przegląd sesji po fakcie: znajduje poprawki właściciela, przeróbki i obejścia, proponuje reguły dla skilli i wprowadza wybrane zmiany w jednym PR.

Repozytorium
skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
09.11.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
8
Skrypty
5
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

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

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

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

Skrypty: scripts/dev_console_project.py, scripts/retro.py, scripts/retro.sh, scripts/retro_draft.py, scripts/test_retro.py

Co robi i kiedy

Robi przegląd sesji po fakcie: znajduje poprawki właściciela, przeróbki i obejścia, proponuje reguły dla skilli i wprowadza wybrane zmiany w jednym PR.

Wyzwalacze z opisu

retrofaz a retroo que aprendemoslições da sessão
Oryginalny opis (EN)

Use when the owner says "retro", "/retro", "faz a retro", "o que aprendemos" or "lições da sessão". An after-action review of the session; it finds the owner's corrections, rework and workarounds, proposes them as rules for the skills they belong to, asks him to pick, and applies the accepted ones in one PR. Differs from skill-smith (how to write a skill; retro uses it to apply) and from postmortem (one error, read from NATS events).

Jak działa

  1. Steps
Sekcje z nagłówków SKILL.md, w oryginale · 50 linii, 524 słów
Podgląd SKILL.md
---
name: retro
description: >-
  Use when the owner says "retro", "/retro", "faz a retro", "o que aprendemos" or "lições da sessão". An
  after-action review of the session; it finds the owner's corrections, rework and workarounds, proposes them as
  rules for the skills they belong to, asks him to pick, and applies the accepted ones in one PR. Differs from
  skill-smith (how to write a skill; retro uses it to apply) and from postmortem (one error, read from NATS events).
metadata:
  version: 0.1.1
---

# retro

The owner-facing text (the ask, the report) is in Portuguese (Brazil). The journal is global,
`~/.local/share/retro/events.jsonl` (override `RETRO_DIR`); the only writer is `scripts/retro.py`
(stdlib, run through `scripts/retro.sh`). Sources and the reasoning: [references/prior-art.md](references/prior-art.md).

```
scripts/retro.sh  emit <event> '{"text": "...", ...}' [--lesson <id>] --actor <who>
scripts/retro.sh  lessons [--status S]
scripts/retro.sh  rejected-rules
scripts/retro.sh  scan <session.jsonl> [--max N]
```

## Steps

1. **Start.** `emit retro.started '{"text": "<scope>"}' --actor <you>`.
2. **Find the lessons.** Read the conversation in context. If it was compacted, or the owner asks for older
   sessions, run `scan` on `~/.claude/projects/<dir>/<session>.jsonl` (Claude Code deletes sessions after ~30 days:
   run `/retro` early) and read the surrounding messages of each hit. Signals, strongest first: an explicit marker
   ("sempre", "a partir de agora", "lembra"); a direct correction; rework (he asked again or undid the result); a
   tool error followed by a workaround that worked; a loaded skill proven wrong; an approach he explicitly praised
   (never infer approval from silence).
3. **Drop what must not be captured:** environment failures (missing binary, credential; capture the fix in a setup
   skill instead), negative claims about tools ("X is broken"), transient errors, one-off narration, unresolved
   failures. A one-off request is not a standing rule unless he marked it general.
4. **Shape each lesson** (at most 3 to 5 per retro):
   - **Home:** the skill that was in play, else an umbrella skill, else a `references/<topic>.md`, a new skill only
     at class level. A fact about the repo goes to its `.wiki/`, never both places.
   - **Rule:** one imperative sentence plus one clause of why; no date, PR or narrative in the text that lands.
   - **Evidence:** the owner's quote (it lives in the event, not in the skill).
   - **Kind:** `skill_gap` (the skill lacked it) or `alignment_gap` (ambiguous instruction).
   - **Dedupe:** read the skill and its `references/`; `new`, `reinforce` (edit the existing sentence) or
     `already_covered` (drop it). Run `rejected-rules`: a rule rejected twice is not proposed again.
   - **Confidence:** `explicit` > `repeated` > `inferred`; inferred ones go only under a "talvez" group.
   `emit lesson.proposed '{"text": "...", "skill": "...", "rule": "...", "why": "...", "quote": "...", "kind": "...", "dedupe": "...", "confidence": "..."}' --lesson <id>`.
5. **Ask.** One multi-select with the harness's ask tool (Hermes `clarify` with `multi_select`, Claude Code
   `AskUserQuestion` with `multiSelect`); each choice reads `skill · regra`. Then `emit lesson.accepted` or
   `lesson.rejected '{"text": "...", "reason": "duplicada|errada|específica demais"}'` for each.
6. **Apply** the accepted ones with skill-smith: read the file before writing, fix the sentence in place, one lesson
   one rule, bump `metadata.version`, add a CHANGELOG entry. Work in a worktree
   (`wt switch -c retro/<date> --base origin/main --no-cd`), one PR for the whole retro. After the merge,
   `emit lesson.applied '{"text": "...", "pr": "<url>"}' --lesson <id>` and `wt remove`. Never delete a skill. If the
   skill is locked, return the suggested change in the report.
7. **Recurrence.** When a later retro finds the same correction for a skill that already has the rule, the rule is
   badly written or badly placed: `emit lesson.recurred` and propose a reinforcement (rewrite it or move it up),
   never a second copy.

Finish with a short report in Portuguese: lessons applied, rejected, and what stayed too fuzzy to encode.
Pliki w paczce (8)
  • CHANGELOG.md 1 KB
  • SKILL.md 4 KB
  • references/prior-art.md 14 KB
  • scripts/dev_console_project.py 1 KB
  • scripts/retro.py 10 KB
  • scripts/retro.sh 1 KB
  • scripts/retro_draft.py 1 KB
  • scripts/test_retro.py 3 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · biliboss/skills100MIT
jongio/skills100MIT
stefanoskarakasis/product-marketing-skills100MIT
bartolli/kmd100MIT
gethamster/plugin100MIT
cookys/autopilot100MIT
rizukirr/vibekit100MIT
rjmurillo/ai-agents100MIT
rjmurillo/ai-agents100MIT

Migawka bazy z 13.11.2026 · wersja paczki c632d53c1959 (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

  • 100trace
    Pokazuje, dlaczego ostatnia odpowiedź powstała w danym kształcie i które zasoby właściciela na nią wpłynęły.
  • 95retro-session
    Analizuje transkrypcję sesji agenta AI pod kątem ukrytych błędów, powtórzeń i korekt, ocenia koszt i proponuje trwałą poprawkę.
  • 100tune
    Prowadzi retrospektywę jednej sesji kodowania i proponuje zmiany w środowisku agenta, jak hooki, kontrole i dostęp do narzędzi, zapisując każdą jako propozycję ax.
  • 100ai-retro-brief
    Syntetyzuje dziennik retro sesji AI: powtarzające się tarcia w pracy z AI, wzorce między sesjami i przygotowanie retrospektywy zespołu, na podstawie wpisów z ai-session-retro.
  • 100run-retro
    Prowadzi retrospektywę z artefaktów: co poszło dobrze, co przeszkadzało i co spróbować, a potem zamienia to w reguły i zmiany skilli.
  • 100ai-session-retro
    Przeprowadza retrospektywę sesji pracy z AI i zapisuje jej log pod koniec dużej lub wieloetapowej sesji, także dla sesji z transkryptu.

Uwagi i zgłoszenia

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