Przejdź do treści
Biblioteka skilli
Programowanie · Pisanie

rb:learn

/rb:learn

Zapisuje lekcje z trwającej pracy, gdy użytkownik poprawia podejście, przy ActiveRecord, Rails, Grape i Sidekiq.

Licencja
MIT
Ostatnia zmiana repozytorium
01.10.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format15 / 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
3
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 01.10.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

Zapisuje lekcje z trwającej pracy, gdy użytkownik poprawia podejście, przy ActiveRecord, Rails, Grape i Sidekiq.

Argumenty

/rb:learn <description of what was fixed>
Oryginalny opis (EN)

Capturing in-flight lessons when the user corrects your approach or teaches a pattern: ActiveRecord, Rails, Grape, Sidekiq mistakes during work. Writes lightweight learning notes.

Jak działa

  1. Usage
  2. Workflow
  3. Output
  4. Iron Laws
  5. Compound vs Learn
  6. References (READ-ONLY — do NOT edit)
Sekcje z nagłówków SKILL.md, w oryginale · 118 linii, 575 słów
Podgląd SKILL.md
---
name: rb:learn
description: "Capturing in-flight lessons when the user corrects your approach or teaches a pattern: ActiveRecord, Rails, Grape, Sidekiq mistakes during work. Writes lightweight learning notes."
argument-hint: <description of what was fixed>
effort: low
disable-model-invocation: true
---

# Learn From the Fix

After fixing a bug or receiving a correction, capture the lesson
to prevent future mistakes.

## Usage

```
/rb:learn Fixed N+1 query in user listing - was missing includes
/rb:learn String vs symbol key mismatch in params handling
/rb:learn Turbo Frame needs data-turbo-frame attribute in tests
```

## Workflow

### Step 1: Identify the Root Cause

Look at recent conversation context or the file/diff the user points at.
Classify the mistake:

- **Knowledge gap**: didn't know the correct API or pattern
- **Wrong assumption**: assumed behavior that doesn't match reality
- **Tooling gap**: lacked a check that would have caught this
- **Process failure**: skipped a step or checked the wrong thing

Extract the root cause, not the symptom. "Missing `includes` on
association" not "query was slow."

### Step 2: Check for Duplicates

Before writing anything, check all existing knowledge stores:

1. Read `${CLAUDE_SKILL_DIR}/references/common-mistakes.md` (shipped
   plugin reference — READ-ONLY, never edit)
2. Grep project `CLAUDE.md` for the pattern keyword
3. Grep `.claude/solutions/` for similar fixes
4. Check auto-memory for similar lessons

If already documented, tell the user and stop. Do not duplicate.

### Step 3: Decide Destination

**CRITICAL: NEVER edit plugin files.** Files under
`~/.claude/plugins/` are cached and get overwritten on updates.
Always write to project or memory locations.

| Scope | Destination | When to use |
|-------|-------------|-------------|
| This project only | Project `CLAUDE.md` | Convention or rule for this codebase |
| Cross-project | Auto-memory | General Ruby/Rails lesson that applies everywhere |
| Complex fix | `.claude/solutions/` via `/rb:compound` | Multi-step debugging story |
| Safety-critical | Iron Law suggestion | Suggest to user, never auto-add |

**Auto-memory requires consent.** Before writing to
`~/.claude/projects/{hash}/memory/`, ask the user: "This lesson applies
beyond this project. Save to auto-memory for future sessions?"

### Step 4: Write the Lesson

**For project CLAUDE.md** — append a concise rule:

```
## Lessons Learned

N. **[SHORT RULE]** — Do NOT [bad pattern]. Instead [good pattern].
   Why: [root cause in one sentence]
```

**For auto-memory** — write a memory file following the memory system
format with type `feedback` and a clear rule + why + how-to-apply.

**For `.claude/solutions/`** — hand off to `/rb:compound` with context.

### Step 5: Suggest Future Detection

Optionally suggest what would have caught this earlier:

- A hook check (e.g., "add N+1 detection to post-edit hooks")
- A linter rule (e.g., "StandardRB custom cop for this pattern")
- A test pattern (e.g., "add factory trait for this edge case")
- An Iron Law addition (only if safety-critical and universal)

## Output

After capturing, confirm:

```
Lesson captured in [destination]

Pattern: Do NOT [bad] — instead [good]
Category: [ActiveRecord/Rails/Grape/Sidekiq/Testing/Security/etc]
Root cause type: [knowledge gap/wrong assumption/tooling gap/process failure]
```

## Iron Laws

1. NEVER edit shipped plugin files — cached, overwritten on updates
2. DO NOT duplicate existing lessons — always check all 4 stores first
3. Capture root cause, not symptom
4. Keep lessons concise — one rule per lesson
5. Ask user before writing to auto-memory — cross-project scope needs consent

## Compound vs Learn

- **Learn**: Extract a concise, generalizable rule or pattern
- **Compound** (`/rb:compound`): Capture a specific problem/solution story

Use both: Learn for the rule, Compound for the detailed case.

## References (READ-ONLY — do NOT edit)

- `${CLAUDE_SKILL_DIR}/references/common-mistakes.md` — Common Ruby/Rails
  mistakes reference. Consult when checking for duplicates. Ships with
  the plugin — NEVER modify.
- `${CLAUDE_SKILL_DIR}/references/learn-workflow.md` — Detailed workflow
  with destination examples and edge cases
Pliki w paczce (3)
  • SKILL.md 4 KB
  • references/common-mistakes.md 4 KB
  • references/learn-workflow.md 4 KB

Wersje

W bazie nie ma innych skilli o nazwie rb:learn.

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

  • 100intent-detection
    Kieruje pracę w Ruby, Rails, Grape, Sidekiq, ActiveRecord, Sequel i Hotwire do właściwego polecenia /rb: przed jej wykonaniem, jako bramka, która nigdy nie blokuje.
  • 100testing
    Pisze testy Ruby, Rails, Grape i Sidekiq: specyfikacje żądań, fabryki i zapobieganie niestabilności, bez uruchamiania testów.
  • 100rails
    Wspiera tworzenie aplikacji Ruby on Rails: ActiveRecord, architektura MVC, migracje, zadania w tle z Sidekiq lub SolidQueue oraz Hotwire.
  • 81rails-ai:models
    Projektuje modele Rails: wzorce ActiveRecord, walidacje, callbacki, zakresy, asocjacje i obiekty zapytań.
  • 90rails
    Prowadzi wywiady specyfikacyjne i sprawdza wdrożenie projektów Rails względem listy kontrolnej: ActiveRecord, ActiveJob, migracje i testy żądań.
  • 100rails
    Dostarcza konwencje i dobre praktyki pisania oraz przeglądu kodu w Ruby on Rails: ActiveRecord, ActiveJob, migracje, concerns i request specs.

Uwagi i zgłoszenia

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