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.
- Autor
- biliboss ↗
- Repozytorium
- skills ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 09.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 8
- Skrypty
- 5
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 09.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 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
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
- Steps
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
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · biliboss/skills | 100 | MIT |
| jongio/skills | 100 | MIT |
| stefanoskarakasis/product-marketing-skills | 100 | MIT |
| bartolli/kmd | 100 | MIT |
| gethamster/plugin | 100 | MIT |
| cookys/autopilot | 100 | MIT |
| rizukirr/vibekit | 100 | MIT |
| rjmurillo/ai-agents | 100 | MIT |
| rjmurillo/ai-agents | 100 | MIT |
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.