Johdanto

Mikä on PRECC?

PRECC (Ennakoiva virheenkorjaus Claude Codelle) on Rust-työkalu, joka sieppaa Claude Coden bash-komennot virallisen PreToolUse-hook-mekanismin kautta. Se korjaa virheet ennen kuin ne tapahtuvat, säästää tokeneita ja poistaa uudelleenyrityssilmukat.

Ilmainen yhteisön käyttäjille.

Ongelma

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

• Väärän hakemiston virheet – cargo build -komennon ajaminen ylähakemistossa, jossa ei ole Cargo.toml-tiedostoa, ja uusiminen virheen lukemisen jälkeen.
• Uudelleenyrityssilmukat – Epäonnistunut komento tuottaa runsaan tulosteen, Claude lukee sen, päättelee siitä ja yrittää uudelleen. Jokainen kierros polttaa satoja tokeneita.
• Runsas 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

Tunnistaa mahdollisuudet liittää GDB segfaultien ja kaatumisten syvempään virheenkorjaukseen tarjoten jäsennellyn debug-tiedon raakojen core dumpien sijaan.

Istuntolouhinta

Louhii Claude Code -istuntolokeja virhe-korjaus-pareiksi. Kun sama virhe toistuu, PRECC tietää jo korjauksen ja soveltaa sitä automaattisesti.

Automaatiotaidot

Sisäänrakennettujen ja louhittujen taitojen kirjasto, joka sovittaa komentokuvioita ja kirjoittaa ne uudelleen. Taidot määritellään TOML-tiedostoina tai SQLite-riveinä, jolloin niitä on helppo tarkastella, muokata ja jakaa.

Miten se toimii (30 sekunnin versio)

1. Claude Code on aikeissa ajaa bash-komennon.
2. PreToolUse-hook lähettää komennon precc-hook-ohjelmalle JSON-muodossa stdin:n kautta.
3. precc-hook ajaa komennon putken läpi (taidot, hakemistokorjaus, pakkaus) alle 3 millisekunnissa.
4. Korjattu komento palautetaan JSON-muodossa stdoutin kautta.
5. Claude Code suorittaa korjatun komennon alkuperäisen sijaan.

Triviaalit virheet kootaan yhteen; uudelleenkirjoituksen syy kulkee hookin vastauksessa, joten jokainen korjaus on tarkastettavissa — ei hiljainen.

Turvallisuusraja

PRECC kirjoittaa uudelleen vain, kun semanttinen vastaavuus on todistettavasti säilynyt tai käyttäjän vahvistettavissa. Tuhoavia komentoja (rm, git push --force, git reset --hard) ei koskaan kirjoiteta uudelleen, vaikka taito vastaisi. Jokaisen muutoksen on oltava rajattu — uudelleenkirjoitetun komennon on sisällettävä alkuperäisen komennon ydintokenit. Rajaamattomat uudelleenkirjoitukset palautetaan automaattisesti. Jokainen sovellettu uudelleenkirjoitus kirjataan ja näytetään, jotta voit tarkastaa, poistaa käytöstä tai kumota sen.

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

Nykyinen versio –:

Measured Savings (Ground Truth)

Säästöt versioittain

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