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

reflect

/reflect

Zapisuje ustrukturyzowaną refleksję agenta dla pakietu celu, zgodną ze schematem i sprawdzaną lintem, na etapie zamknięcia celu.

Repozytorium
beep-effect ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
27.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
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 27.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 robi i kiedy

Zapisuje ustrukturyzowaną refleksję agenta dla pakietu celu, zgodną ze schematem i sprawdzaną lintem, na etapie zamknięcia celu.

Oryginalny opis (EN)

Write a structured agent reflection for a goal packet. Trigger on: a goal's P3 Close phase, the user invoking `/reflect <goal-slug>`, or when you notice a TODO worth codifying. Produces a schema-valid `goals/<slug>/history/reflections/<YYYY-MM-DD>-<agent>.md` enforced by `bun run beep lint reflection-artifacts`.

Jak działa

  1. When to run
  2. How to write one
  3. Verify
  4. Related skills
Sekcje z nagłówków SKILL.md, w oryginale · 56 linii, 321 słów
Podgląd SKILL.md
---
name: reflect
description: >
  Write a structured agent reflection for a goal packet. Trigger on: a goal's P3
  Close phase, the user invoking `/reflect <goal-slug>`, or when you notice a TODO
  worth codifying. Produces a schema-valid
  `goals/<slug>/history/reflections/<YYYY-MM-DD>-<agent>.md` enforced by
  `bun run beep lint reflection-artifacts`.
metadata:
  version: "0.1.0"
  status: active
---

# Reflect

Use this skill to capture a durable, **information-rich** reflection on a goal
packet's execution. Reflections compound into reusable knowledge; the research
(`goals/agent-reflection-loop/research/reflection-frontier-report.md`) shows that
specific, structured reflections grounded in real tooling/CI signals far
outperform terse free-text advice.

## When to run

- **Automatic (P3 Close):** the agent closing a goal packet writes one before
  flipping `ops/manifest.json` `initiative.status` to `completed-retained` /
  `complete`. Packets with `reflectionRequired: true` are gated — a missing or
  invalid reflection blocks closeout.
- **On demand:** `/reflect <goal-slug>` — reflect on any packet now.
- **TODO codification:** when you spot something that should become a standard,
  skill, lint rule, or issue, capture it as a `codification-todo` finding.

## How to write one

1. Resolve the goal slug. Read the packet's `SPEC.md`, `PLAN.md`, `README.md`,
   `history/`, and the real execution evidence (PRs, CI runs, review threads,
   commits). Ground claims in that evidence — not unaided self-critique.
2. Copy `goals/_template/history/reflections/_TEMPLATE.md` to
   `goals/<slug>/history/reflections/<YYYY-MM-DD>-<agent>.md` (today's date;
   `<agent>` lowercase, e.g. `claude`, `codex`).
3. Fill the YAML frontmatter — it is the machine-validated block
   (`ReflectionFrontmatter`):
   - `goal`, `agent`, `date` (`YYYY-MM-DD`)
   - `trigger`: `closeout` | `on-demand` | `todo-codify`
   - `confidence` (overall): `high` | `medium` | `low`
   - `findings[]`: each `{ category, confidence, instruction, explanation }`
     where `category` ∈ `tooling-friction` | `implementation-improvement` |
     `goal-critique` | `prompt-critique` | `codification-todo`. Make `instruction`
     concrete (what to change) and `explanation` evidence-backed (why).
   - `todos[]`: items worth codifying.
4. Fill the body rubric: **Summary**, **Tooling experience** (worked / didn't /
   frustrating / wished existed), **Implementation improvement opportunities**,
   **Goal & prompt critique** (would you revise the GOAL/prompt to be clearer,
   easier, more efficient?), **TODOs worth codifying**, and **Lessons**
   (confidence-tiered: HIGH critical / MEDIUM best-practice / LOW consideration).
5. Update packet `README.md` (latest evidence) and `ops/manifest.json` status.

## Verify

```sh
bun run beep lint reflection-artifacts   # blocking_findings=0
git diff --check -- goals/<slug>
```

## Related skills

- `yeet` — commit/push/PR after the reflection is written.
- `quality-review-fix-loop` — late-initiative closure + reviewer/fixer loop.

Wersje

RepozytoriumWynikLicencja
Ta strona · kriegcloud/beep-effect100Apache-2.0
iliaal/ai-skills100MIT
chhoumann/t3-pstack100MIT
chmonitor/chmonitor100GPL-3.0
backnotprop/pstack100MIT
guangshinhaha/shinstack100MIT
unsady/den100Apache-2.0
akdevsaha-dev/factory-skills100MIT
coletebou/dx100MIT

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

Pobrania w ostatnich 30 dniach: 1 · ranking

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

Podobne skille

  • 100session-reflect
    W tle przegląda historię rozmów i zapisuje preferencje użytkownika oraz jego poprawki w pliku USER.md.
  • 100research-reflection
    Ocenia zakończone zadanie badawcze, zapisuje wnioski na przyszłość i przywołuje wcześniejsze refleksje przed rozpoczęciem nowej pracy.
  • 95guild-reflect
    Analizuje zakończony przebieg zadania i proponuje poprawy umiejętności, brakujących specjalistów, kontekstu i nierozwiązanych uwag.
  • 90m-goal
    Prowadzi długą pracę do celu: plik celu, punkty kontrolne, zasady zatrzymania i obowiązkowe podsumowanie na koniec.
  • 100weekly-reflection
    Prowadzi krótką refleksję tygodnia: co dodawało energii, co ją zabierało i jedna zmiana na kolejny tydzień, gdy chodzi o to, jak praca się czuła, a nie co zostało zrobione.
  • 100reflection-coach
    Analizuje zapis niedawnej pracy innego agenta i proponuje najmniejszą trwałą zmianę instrukcji, skilla lub opisu narzędzia, poprzedzoną dowodami.

Uwagi i zgłoszenia

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