Poglobljena analiza repozitorija
Na tej strani
Lekcija posodobljena 3. novembra 2026 na podlagi priročnika Codex: „Poglobljeno raziskovanje za GitHub” ni funkcija Codexa. Analiza repozitorija se izvaja s Codexom v načinu samo za branje, medtem ko je poglobljeno raziskovanje funkcija ChatGPT Work, katere razpoložljivost je odvisna od vašega računa in delovnega prostora. Tabela trajanj brez virov iz prejšnje različice je bila odstranjena. Viri: Codex CLI · Neinteraktivni način.
Poglobljena analiza repozitorija
Preden spremenite kodo, jo morate pogosto najprej razumeti: arhitekturo zastarelega projekta, njegove odvisnosti in tehnični dolg. Za to sta na voljo dve orodji. Codex analizira repozitorij od znotraj – bere datoteke, preučuje zgodovino Git in izvaja diagnostične ukaze – ne da bi karkoli spreminjal. Funkcija poglobljeno raziskovanje v ChatGPT Work izvaja preiskave po več virih in dostavi poročilo z navedenimi viri; to je pravo orodje za vprašanja, ki presegajo okvir repozitorija, kot je ocenjevanje zunanje knjižnice.
Analiza brez kakršnih koli sprememb
Standardna naloga Codexa izvrši dejanje: zapis kode, odprava napake ali generiranje testov. Pri analizi od Codexa zahtevajte, da sintetizira brez spreminjanja česarkoli, in mu zagotovite sredstva za upoštevanje te omejitve. Sejo nastavite na način samo za branje (/permissions, način read-only) ali analizo zaženite z codex exec, ki privzeto uporablja peskovnik samo za branje. Ta lahko pregleda na stotine datotek, preuči zgodovino Git in ustvari podrobno poročilo. Ta razlika se takoj odraža v vašem pozivu, ki se mora osredotočati na razumevanje namesto na spreminjanje:
"Analyze the architecture of this project without modifying any files.
How does data flow from the API to the database? What patterns are
used? Where are the fragility points?"
Rezultat ni potrditev (commit), temveč strukturiran dokument, ki vsebuje sklice na ustrezne datoteke in priporočila. Dokument pregledate, o njem razpravljate na tehničnem sestanku in popravite vse, kar je napačno.
Pospešitev tehničnega uvajanja
Ko se razvijalec pridruži ekipi, običajno prvih dva tedna porabi za mentalno rekonstrukcijo zemljevida, ki ga nihče ni nikoli zapisal: kateri storitev kliče kaj, zakaj ima modul ime, ki ne ustreza več njegovi vsebini, ali kje se skriva logika obračunavanja. Codex lahko ta zemljevid nariše namesto njega:
"Analyze this repository and generate an onboarding guide
for a new developer. Cover:
- General architecture and layers
- Naming and structure conventions
- End-to-end flow of a typical request
- The most important files to read first
- Common pitfalls and project-specific quirks"
Nastali dokument služi kot referenca v prvih nekaj tednih in se popravlja, ko ekipa podaja povratne informacije. To dejanje popravljanja ima nepričakovano prednost: razkrije slepe pege, ki jih nihče ni dokumentiral, ker „vsi vedo, kako to deluje”.
Revizija odvisnosti in tehničnega dolga
Druga naravna uporaba je inventarizacija. Koda, stara tri leta, kopiči opuščene knjižnice, funkcionalne dvojčke in mrtve uvoze, ki se jih nihče ne upa izbrisati zaradi pomanjkanja pregleda:
"Analyze all project dependencies (package.json
and lock file). Identify:
- Obsolete packages (last update > 1 year ago)
- Known vulnerabilities
- Duplicate packages (same functionality)
- Unused packages (imported nowhere)
- Packages with incompatible licenses"
Ta analiza križno preveri package.json, zaklenjeno datoteko (lock file) in uvoze, ki so dejansko prisotni v kodi. Za znane ranljivosti in stanje vzdrževanja paketov potrebuje javne podatke, zato morate izrecno dovoliti dostop do omrežja ali uporabiti orodja za revizijo svojega upravitelja paketov (kot je npm audit). Ocena tehničnega dolga sledi isti logiki, z eno dodatno zahtevo – zadnjo vrstico poziva. Brez meril za razvrščanje dobite seznam štiridesetih težav brez ideje, kje začeti.
"Evaluate the technical debt of this project. Analyze:
- Cyclomatic complexity of core modules
- Most frequently modified files (Git hotspots)
- Code duplication patterns
- Unresolved TODOs and FIXMEs
- Test coverage by module
Rank problems by impact and effort to fix."
Vrednost teh analiz leži v razmerju med vloženim časom in doseženimi rezultati: nekaj natančnih navodil nadomesti dneve branja. To izmerite na svojih projektih, namesto da se zanašate na splošne ocene, in vedno pregledajte poročilo: agent se lahko moti, še posebej glede tega, česa repozitorij ne vsebuje.
Ocena zunanjega projekta pred prevzemom
Pri knjižnici odprte kode, ki jo razmišljate o prevzemu, vprašanje presega okvir repozitorija: pogostost izdaj, aktivnost težav in ugled. To je področje funkcije poglobljeno raziskovanje v ChatGPT Work. V namizni aplikaciji preklopite na Work, odprite Plugins in izberite Deep research; na spletu odprite meni + v pogovoru Work. Razpoložljivost je odvisna od vašega računa in delovnega prostora:
"Analyze the repository github.com/org/library.
Evaluate its maturity:
- Release frequency and maintenance
- Documentation quality
- Community activity (issues, PRs)
- Test coverage
- Recommendation: Is it safe to adopt in production?"
To je korak preverjanja, ki ga skoraj vedno preskočimo, ker si ne moremo privoščiti pol dneva zanj, vendar nas njegova odsotnost stane dve leti kasneje: knjižnica se ne vzdržuje več, njen edini vzdrževalec je izginil in ostane vam odvisnost, ki jo morate na hitro prepisati.
Pridobivanje uporabnih poročil
Kakovost poročila je neposredno odvisna od natančnosti poziva. „Kje so šibke točke?” prinese veliko uporabnejši rezultat kot „Analiziraj projekt”, ker prva formulacija vsili kot in hierarhijo. Zahtevajte tudi izrecno obliko – „razvrsti po prioriteti”, „organiziraj po modulu” – da dobite dokument, ki ga lahko hitro pregledate, namesto da bi ga brali od korice do korice. Nato sledite s konkretnimi nalogami Codexa, ki popravijo ugotovljene težave. Takrat analiza preneha biti le še eno poročilo in postane izhodišče za delovni načrt. Končno ta poročila delite s svojo ekipo, saj njihova vrednost raste s številom ljudi, ki se nanje dnevno sklicujejo.
Ključne ugotovitve
- Za analizo repozitorija zaženite Codex v načinu samo za branje (
/permissionsalicodex exec, ki je privzeto samo za branje) - Idealno za uvajanje novih sodelavcev, revizije in oceno tehničnega dolga
- Funkcija poglobljeno raziskovanje v ChatGPT Work je primerna za vprašanja iz več virov, kot je ocenjevanje zunanje knjižnice
- Rezultati se uporabijo za konkretne naloge Codexa za odpravo ugotovljenih težav
- Vsako poročilo pregledajte: agent se lahko moti, še posebej glede manjkajoče vsebine