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

comprehension-gate

/comprehension-gate

Sprawdza, czy użytkownik rozumie zmianę zbudowaną przez agenta, zanim ją zaakceptuje, po testach i przy przekazaniu pracy.

Repozytorium
agent-pace ↗
Licencja
MIT
Ostatnia zmiana repozytorium
10.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
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

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

Sprawdza, czy użytkownik rozumie zmianę zbudowaną przez agenta, zanim ją zaakceptuje, po testach i przy przekazaniu pracy.

Wyzwalacze z opisu

walk me through itdo I actually understand thisexplain what changed
Oryginalny opis (EN)

Use when an agent-built feature must be understood by the user before they accept it - while writing acceptance criteria, after tests pass, and at handoff (it pairs with spec- or PRD-driven workflows that keep acceptance criteria in a coverage-contract.json). Also use when the user says "walk me through it", "do I actually understand this", "explain what changed", or approves a large change within seconds.

Jak działa

  1. 0. No coverage-contract.json yet (existing projects)
  2. 1. Tag each acceptance criterion
  3. 2. Write a walkthrough per core criterion (after the tests pass)
  4. 3. Explain-back before reading (at handoff)
  5. 4. Run the gate
Sekcje z nagłówków SKILL.md, w oryginale · 45 linii, 365 słów
Podgląd SKILL.md
---
name: comprehension-gate
description: Use when an agent-built feature must be understood by the user before they accept it - while writing acceptance criteria, after tests pass, and at handoff (it pairs with spec- or PRD-driven workflows that keep acceptance criteria in a coverage-contract.json). Also use when the user says "walk me through it", "do I actually understand this", "explain what changed", or approves a large change within seconds.
---

# Comprehension gate

The user accepts a core change only after they can explain it. Throwaway work skips the gate. The script is `scripts/pace.py`, two folders above this skill's base directory.

## 0. No coverage-contract.json yet (existing projects)
For a change in an existing codebase, write a small `coverage-contract.json` next to the change's spec or task file, with one item per acceptance criterion of this change only:
```json
{"acceptance": [{"id": "AC-01", "tier": "core"}, {"id": "AC-02", "tier": "throwaway"}]}
```
If a spec-driven tool already numbers the requirements (for example `REQ-3` or a task id), reuse those ids. Never cover the whole legacy codebase: only what this change touches.

## 1. Tag each acceptance criterion
In `coverage-contract.json`, add `"tier": "core"` or `"tier": "throwaway"` to every item in `acceptance[]` (each item needs an `id`, for example `AC-03`).
- **Core:** data model, personal-data flows, core business logic, auth, payments, and anything a `pace.toml` claim touches.
- **Throwaway:** copy, layout, prototype-only scaffolding.
- An untagged item counts as core. Ask the user about the borderline ones in a single question that lists them.

## 2. Write a walkthrough per core criterion (after the tests pass)
Write `walkthroughs/<AC-id>.md` next to the contract, in 150 words or fewer:
```markdown
# AC-03: <title>
## What the user does
1. ... 2. ... 3. ...
## What changed in the code
- path/to/file: one line each
## What could go wrong
The riskiest assumption, in one sentence.
## How we know
Test name and evidence path.
## Explain-back
```
Leave `## Explain-back` empty.

## 3. Explain-back before reading (at handoff)
Before the user opens a walkthrough, ask once per core criterion:
"In one or two sentences: what does AC-03 do now, and what could go wrong?"
- Record the user's words **verbatim** under `## Explain-back`, with the date. Never write or paraphrase it yourself.
- Compare the answer to the walkthrough. List at most 3 gaps.
- If there is a gap on a core criterion, walk through only that part, then ask again.

## 4. Run the gate
`python3 <base>/../../scripts/pace.py gate --contract <path>/coverage-contract.json`
Each core criterion prints `no walkthrough`, `awaiting explain-back` or `explained`. Call the work ready for review only on exit 0.

Wersje

W bazie nie ma innych skilli o nazwie comprehension-gate.

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

  • 100acceptance-check
    Sprawdza kryteria akceptacji z PRD wobec kodu bez pełnego cyklu implementacji, przy weryfikacji PR lub zewnętrznego wkładu.
  • 100wdym
    Rozszyfrowuje dla nadzorującego użytkownika wyniki pracy agenta w sesji: wnioski, surowe logi, diffy, stack trace'y, wyniki zapytań i raporty subagentów, opierając się na dowodach z sesji.
  • 100acceptance-criteria-creator
    Prawdopodobnie tworzy kryteria akceptacji w ramach zestawu przepływów pracy dla przedsiębiorstw.
  • 82ykwim
    Potwierdza, że rozumie prośbę, zanim zacznie pracę, gdy użytkownik pyta, czy wszystko jest jasne.
  • 100comprehension-report
    Generuje narracje o architekturze i raporty zgodności z wymaganiami z diffów, dzienników decyzji i kontekstu zgłoszeń, do opisów pull requestów i sprawdzania spełnienia kryteriów akceptacji.
  • 100prompt-comprehension
    Sprawdza na liście modeli, czy brzmienie promptu jest czytane tak samo, za pomocą pytań wielokrotnego wyboru, a potem dostraja treść.

Uwagi i zgłoszenia

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