/bugfix

← Vissza az áttekintéshez

Összefoglaló

Van egy bugod, és nem csak foltozni akarod — ki akarod irtani. Négy ágensből álló pipeline viszi végig: bukó teszt első (kódolvasás nem számít bizonyítéknak — csak a piros teszt), TDD javítás, doksi-frissítés, teljes iterative-review, majd commit. Minden ágens egy alapfeltevésből indul ki: a bug valós és létezik — egyik sem zárhatja azzal, hogy „nincs bug” vagy „nem reprodukálható, lezárva”.

Mikor használd

Bugot jeleztek — felhasználótól, megbukott CI-futásból, bug-riportfájlból, vagy saját megfigyelésből. A /bugfix az egész javítást végigviszi: reprodukálja teszttel, javítja a kódot, átvizsgálja az eredményt, és commitol — anélkül, hogy elvesznél a nyomozásban.

Az argumentum bug-leírás vagy bug-riportfájl elérési útja. Ha olvasható fájlra mutat, a skill beolvassa. Ha szöveg, szó szerint használja. Üres argumentum → először megkérdez.

Meghívás

Szabad szöveges bug-leírás:

/bugfix <leírás>

Bug-riportfájl elérési útja:

/bugfix Documentation/Backlog/bug-xyz.md

A pipeline, sorban:

  1. Reprodukálás — maradandó, elhelyezett bukó tesztet ír, amely emiatt a bug miatt bukik. Kódolvasás nem fogadható el bizonyítékként.
  2. Javítás (TDD) — a legkisebb termelési kód-változtatás, amely zöldre forgatja a tesztet. A reprodukciós tesztet nem szabad módosítani.
  3. Doksi-frissítés — szinkronizálja a törött viselkedést leíró dokumentációt.
  4. Iteratív review — futtatja az /iterative-review-t, amíg nem marad Kritikus, Súlyos vagy Közepes probléma.
  5. Commit — meghívja a /commit-ot. Ha a commit elutasításra kerül (hook, nincs staged változás), a hibaüzenetet szó szerint jelenti — nem próbál megkerülő megoldást.
  6. Report — rögzített formátumú összefoglaló: bug, repro, fix, docs, review, commit.

A lépések sorban futnak. Ha a reprodukálás őszinte erőfeszítés után sem sikerül, a skill leáll és jelenti — soha nem folytatja a javítást reprodukálás nélkül.

1. példa — Szabad szöveges bug (szemléltető példa)

Bemenet:

/bugfix a számlaösszeg .5 centnél lefelé kerekít felfelé helyett

Kimenet / Eredmény:

## 🐛 Bugfix: számlaösszeg .5 centnél lefelé kerekít

**Bug**      ROUND_HALF_DOWN alkalmazva a `billing/invoice.py:calculate_total`-ban
**Repro**    tests/billing/test_invoice.py::test_half_cent_rounding — failed, now passes
**Fix**      Decimal kerekítési mód átváltva ROUND_HALF_UP-ra (`billing/invoice.py`)
**Docs**     none affected
**Review**   2 issues fixed (0/1/1), 0 remaining
**Commit**   a3f91bc — 2 files

2. példa — Bug-riportfájl (szemléltető példa)

Bemenet:

/bugfix Documentation/Backlog/bug-bulk-users-200-reszleges-hiba.md

Kimenet / Eredmény:

## 🐛 Bugfix: POST /users/bulk részleges hibánál 200-at ad vissza

**Bug**      HTTP 200 kerül visszaküldésre, ha egyes sorok validációja hibás (`routes/users.py:bulk_create`)
**Repro**    tests/routes/test_users_bulk.py::test_partial_failure_returns_207 — failed, now passes
**Fix**      státuszkód mostantól 207 Multi-Status, ha legalább egy sor hibás (`routes/users.py`)
**Docs**     API referencia frissítve: docs/api/users.md — státuszkódok táblázata
**Review**   1 issue fixed (0/0/1), 0 remaining
**Commit**   d7c04e1 — 3 files

Kapcsolódó eszközök