/quick-plan

← Vissza az áttekintéshez

Összefoglaló

Ne merülj bele a kódba anélkül, hogy tudnád, hová tartasz. A /quick-plan egy mérhetőjobban megfogalmazott célt, ellenőrizhető sikerkriériumokat és 4–12 konkrét lépést határoz meg egyetlen inline menetben — mielőtt egyetlen sor kód is születne. Nem ír fájlt, nem hajt végre semmit. Csak terv.

Mikor használd

Akkor érdemes a /quick-plan-t használni, ha egy feladat elég összetett ahhoz, hogy hasznos legyen az előzetes struktúra, de nem szükséges a teljes /plan-maker-kezelés (egy perzisztens tervfájl, amelyet az /implement feldolgoz). Jól jön: egyetlen jól lehatárolt változtatáshoz, refaktoráláshoz, migrációhoz vagy több mozgó részből álló dokumentum-frissítéshez.

Triggerkifejezések (a SKILL.md-ből):

Kimenet formája: egy mérhető cél → 2–6 egyenként ellenőrizhető sikerkritérium → 4–12 konkrét lépés. Csak inline — semmi nem kerül lemezre.

Meghívás

Hívd meg a feladat leírásával:

/quick-plan [feladat leírása]

A kimenet a beszélgetésben marad. Ha utólag teljes tervfájlt szeretnél az /implement számára, inkább a /plan-maker-t használd.

1. példa — Feature feladat

Bemenet:

/quick-plan add rate limiting to the /auth endpoint

Kimenet / Eredmény:

Cél
───
A /auth végponton rate limiting érvényes: 10 kérés/perc IP-nként,
429 visszaadva túllépéskor.

Sikerkritériumok
────────────────
1. pytest tests/test_rate_limit.py átmegy
2. 11 gyors egymás utáni kérés esetén 429-et ad vissza
3. A naplók "rate limit hit" bejegyzést tartalmaznak a blokkolt kérésnél

Lépések
───────
1. Írj bukó tesztet: 11 kérés → 429
2. Telepíts rate-limiting middleware-t (pl. slowapi vagy egyedi Redis-alapú)
3. Kösd be a middleware-t csak a /auth végpontra
4. Állítsd be a határt: 10/perc kliens IP-nként
5. Túllépéskor adj vissza 429-et Retry-After fejléccel
6. Adj hozzá naplóbejegyzést túllépéskor
7. Futtasd a teszteket — ellenőrizd, hogy mind átmegy
8. Commit

2. példa — Migrációs feladat

Bemenet:

/quick-plan migrate tests from unittest to pytest

Kimenet / Eredmény:

Cél
───
Minden tesztfájl pytest-stílusra konvertálva; a pytest nullás hibaszámmal
futtatja a teljes tesztkészletet.

Sikerkritériumok
────────────────
1. A pytest automatikusan megtalálja az összes tesztfájlt (nincs unittest runner)
2. A pytest --tb=short 0-val lép ki
3. unittest.TestCase import már nem szerepel egyetlen fájlban sem

Lépések
───────
1. Leltározd fel az összes tesztfájlt (find . -name "test_*.py")
2. Minden fájlban: cseréld le a class TestX(unittest.TestCase)-t sima függvényekre
3. Cseréld le a self.assertEqual(a, b)-t assert a == b-re (és hasonlókat)
4. Cseréld le a setUp/tearDown metódusokat pytest fixture-ökre
5. Töröld az unittest.main() blokkokat
6. Futtasd a pytest-et — javíts minden felfedezési vagy assertion hibát
7. Commit

Kapcsolódó eszközök