Johdanto

Mikä on PRECC?

PRECC (Ennakoiva virheenkorjaus Claude Codelle) on Rust-työkalu, joka kaappaa Claude Coden bash-komennot virallisen PreToolUse hook -mekanismin kautta. Se korjaa virheet ennen niiden tapahtumista, säästäen tokeneita ja eliminoiden uudelleenyrityssilmukat.

Ilmainen yhteisön käyttäjille.

Ongelma

Claude Code tuhlaa merkittävästi tokeneita estettävissä oleviin virheisiin:

• Väärä-hakemisto-virheet – cargo build suoritetaan ylähakemistossa jossa ei ole Cargo.toml-tiedostoa, sitten uudelleenyritys virheen lukemisen jälkeen.
• Uudelleenyrityssilmukat – Epäonnistunut komento tuottaa monisanaista tulostetta, Claude lukee sen, päättelee ja yrittää uudelleen. Jokainen sykli kuluttaa satoja tokeneita.
• Monisanainen tuloste – Komennot kuten find tai ls -R tulostavat tuhansia rivejä, jotka Clauden on käsiteltävä.

Neljä pilaria

Kontekstikorjaus (cd-prepend)

Havaitsee, kun komennot kuten cargo build tai npm test suoritetaan väärässä hakemistossa ja lisää cd /correct/path && ennen suoritusta.

GDB-virheenkorjaus

Havaitsee mahdollisuudet liittää GDB syvempään segfault- ja kaatumisvirheenkorjaukseen, tarjoten rakenteellista debug-tietoa raakojen core dump -tiedostojen sijaan.

Istuntojen analysointi

Analysoi Claude Coden istuntolokeja virhe-korjaus-parien löytämiseksi. Kun sama virhe toistuu, PRECC tietää jo korjauksen ja soveltaa sen automaattisesti.

Automaatiotaidot

Kirjasto sisäänrakennettuja ja opittuja taitoja, jotka vastaavat komentomalleja ja kirjoittavat ne uudelleen. Taidot määritellään TOML-tiedostoina tai SQLite-riveinä, mikä tekee niistä helppoja tarkastella, muokata ja jakaa.

Miten se toimii (30 sekunnin versio)

1. Claude Code aikoo suorittaa bash-komennon.
2. PreToolUse hook lähettää komennon precc-hook:lle JSONina stdiniin.
3. precc-hook ajaa komennon pipelinen läpi (taidot, hakemistokorjaus, pakkaus) alle 3 millisekunnissa.
4. Korjattu komento palautetaan JSONina stdoutiin.
5. Claude Code suorittaa korjatun komennon.

Claude ei koskaan näe virhettä. Nolla hukkaan mennyttä tokenia.

Mukautuva pakkaus

Jos komento epäonnistuu pakkauksen jälkeen, PRECC ohittaa pakkauksen automaattisesti uudelleenyrityksessä, jotta Claude saa täyden pakkaamattoman tulosteen virheenkorjausta varten.

Reaaliaikaiset käyttötilastot

Luvut ovat arvioita. Jokainen estetty virhe välttää täyden uudelleenyrityssyklin: virhetuloste, mallin päättely ja uudelleenyrityskomento. Nämä luvut päivittyvät automaattisesti anonymisoidusta telemetriasta.

Linkit

• GitHub: https://github.com/peria-ai/precc-cc
• Verkkosivusto: https://peria.ai
• Dokumentaatio: https://precc.cc