Bevezetés

Mi a PRECC?

PRECC (Prediktív hibakorrektor Claude Code-hoz) egy Rust eszköz, amely a hivatalos PreToolUse hook mechanizmuson keresztül elfogja a Claude Code bash parancsait. A hibákat még a bekövetkezésük előtt javítja, tokeneket takarít meg és kiküszöböli az újrapróbálkozási hurkokat.

Ingyenes közösségi felhasználóknak.

A probléma

A Claude Code jelentős mennyiségű tokent pazarol megelőzhető hibákra:

• Rossz könyvtár hibák – cargo build futtatása Cargo.toml nélküli szülőkönyvtárban, majd újrapróbálkozás a hiba elolvasása után.
• Újrapróbálkozási hurkok – Egy sikertelen parancs bőséges kimenetet produkál, a Claude elolvassa, érvel róla és újrapróbálkozik. Minden ciklus több száz tokent emészt fel.
• Bőséges kimenet – Az olyan parancsok, mint a find vagy ls -R ezreket sornyi kimenetet produkálnak, amelyeket a Claude-nak fel kell dolgoznia.

A négy pillér

Kontextus javítás (cd-prepend)

Észleli, ha parancsok mint a cargo build vagy npm test rossz könyvtárban futnak, és cd /helyes/útvonal && előtagot ad a végrehajtás előtt.

GDB hibakeresés

Felismeri a lehetőségeket a GDB csatlakoztatására a segfaultok és összeomlások mélyebb hibakereséséhez, strukturált hibakeresési információkat biztosítva nyers core dumpok helyett.

Munkamenet-bányászat

A Claude Code munkamenet-naplókat bányássza hiba-javítás párokért. Amikor ugyanaz a hiba megismétlődik, a PRECC már ismeri a javítást és automatikusan alkalmazza.

Automatizálási készségek

Beépített és bányászott készségek könyvtára, amelyek illeszkednek a parancsmintákhoz és átírják azokat. A készségek TOML fájlokként vagy SQLite sorokként vannak definiálva, így könnyen ellenőrizhetők, szerkeszthetők és megoszthatók.

Hogyan működik (30 másodperces verzió)

1. A Claude Code készül futtatni egy bash parancsot.
2. A PreToolUse hook elküldi a parancsot a precc-hook számára JSON-ként a stdin-en.
3. A precc-hook 3 ezredmásodperc alatt futtatja a parancsot a folyamaton keresztül (készségek, könyvtár-korrekció, tömörítés).
4. A javított parancs JSON-ként visszakerül a stdout-on.
5. A Claude Code az eredeti helyett a javított parancsot futtatja.

A triviális hibák összevonódnak; az átírás indoka a hook válaszában utazik, így minden javítás auditálható — nem csendes.

Biztonsági határ

A PRECC csak akkor ír át, ha a szemantikai ekvivalencia bizonyíthatóan megmarad vagy a felhasználó által ellenőrizhető. A destruktív parancsok (rm, git push --force, git reset --hard) soha nem kerülnek átírásra, még ha egy készség is illeszkedik. Minden mutációnak korlátosnak kell lennie — az átírt parancsnak tartalmaznia kell az eredeti parancs lényegi tokenjeit. A korlátlan átírásokat a rendszer automatikusan visszavonja. Minden alkalmazott átírás naplózásra és megjelenítésre kerül, így auditálhatja, letilthatja vagy visszavonhatja.

Adaptív tömörítés

Ha egy parancs a tömörítés után sikertelen, a PRECC automatikusan kihagyja a tömörítést a következő próbálkozásnál, hogy Claude megkapja a teljes tömörítetlen kimenetet a hibakereséshez.

Élő használati statisztikák

Jelenlegi verzió –:

Measured Savings (Ground Truth)

Megtakarítás verziónként

Ezek a számok automatikusan frissülnek anonimizált telemetriából.

Linkek

• GitHub: https://github.com/peria-ai/precc-cc
• Weboldal: https://peria.ai
• Dokumentáció: https://precc.cc