Sügav hoidla analüüs
Sellel lehel
Tund uuendatud 3. novembril 2026 vastavalt Codexi käsiraamatule: „Deep Research for GitHub“ ei ole Codexi funktsioon. Hoidla analüüsi teostab Codex kirjutuskaitstud režiimis, samas kui sügav uurimine on ChatGPT Worki funktsioon, mille kättesaadavus sõltub sinu kontost ja tööruumist. Eelmise versiooni allikata võrdlustabel kestuste kohta on eemaldatud. Allikad: Codex CLI · Mitteinteraktiivne režiim.
Sügav hoidla analüüs
Enne koodi muutmist pead sa selle sageli esmalt mõistma: pärandprojekti arhitektuuri, selle sõltuvusi ja tehnilist võlga. Selleks sobivad kaks tööriista. Codex analüüsib hoidlat seestpoolt – see loeb faile, uurib Giti ajalugu ja käivitab diagnostikakäskude –, tegemata seejuures mingeid muudatusi. ChatGPT Worki sügav uurimine viib läbi uurimisi mitmest allikast ja esitab viidetega raporti; see on õige tööriist küsimuste jaoks, mis lähevad kaugemale hoidlast, näiteks välise teegi hindamisel.
Analüüsi ilma midagi muutmata
Tavaline Codexi ülesanne täidab tegevuse: koodi kirjutamine, vea parandamine või testide genereerimine. Analüüsimisel palu Codexil sünteesida ilma midagi muutmata ja anna talle vahendid sellest piirangust kinnipidamiseks. Määra seanss kirjutuskaitstuks (/permissions, režiim read-only) või käivita analüüs käsuga codex exec, mis vaikimisi kasutab kirjutuskaitstud liivakasti. See saab skannida sadu faile, uurida Giti ajalugu ja koostada üksikasjaliku raporti. See erinevus kajastub kohe sinu vihjes, mis peaks keskenduma mõistmisele, mitte muutmisele:
"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?"
Tulemuseks ei ole commit, vaid struktureeritud dokument, mis sisaldab viiteid asjakohastele failidele ja soovitusi. Sa vaatad selle üle, arutad seda tehnilisel koosolekul ja parandad kohad, kus see eksib.
Kiirenda tehnilist sisseelamist
Kui arendaja liitub meeskonnaga, kulutab ta tavaliselt oma esimesed kaks nädalat vaimselt kaardi rekonstrueerimisele, mida keegi pole kunagi kirja pannud: milline teenus helistab millele, miks on moodulil nimi, mis ei vasta enam selle sisule, või kus peitub arveldusloogika. Codex saab selle kaardi tema jaoks joonistada:
"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"
Saadud dokument toimib esimestel nädalatel võrdlusmaterjalina ja seda parandatakse, kui meeskond annab tagasisidet. Sellel parandustegevusel on ootamatu kõrvalmõju: see paljastab pimedad kohad, mida keegi ei viitsinud dokumenteerida, sest „kõik teavad, kuidas see töötab“.
Auditeeri sõltuvusi ja tehnilist võlga
Teine loomulik kasutusjuhtum on inventuur. Kolmeaastane koodibaas kogub mahajäetud teeke, funktsionaalseid dublikaate ja surnud imporditavaid mooduleid, mida keegi ei julge ülevaate puudumise tõttu kustutada:
"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"
See analüüs ristviitab package.json-i, lukufaili ja koodis tegelikult olevaid importimisi. Teadaolevate haavatavuste ja pakettide hooldusstaatuse jaoks on vaja avalikke andmeid, seega pead sa sõnaselgelt lubama võrguühenduse või kasutama oma paketihalduri auditeerimistööriistu (nagu npm audit). Tehnilise võla hindamine järgib sama loogikat, ühe lisatingimusega – vihje viimane rida. Ilma sortimiskriteeriumideta saab nimekirja neljakümnest probleemist, aimamata, kust alustada.
"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."
Nende analüüside väärtus seisneb investeeritud aja ja saadud tulemuste suhtes: mõned täpsed juhised asendavad päevade pikkust lugemist. Mõõda seda oma projektidel, mitte ära tugine üldistele hinnangutele, ja vaata raport alati üle: agent võib eksida, eriti selle osas, mida hoidlas ei ole.
Hinda välist projekti enne kasutuselevõttu
Avatud lähtekoodiga teegi puhul, mida kaalud kasutusele võtta, ulatub küsimus kaugemale hoidlast: avaldamise sagedus, probleemide aktiivsus ja maine. See on ChatGPT Worki sügava uurimise valdkond. Töölauarakenduses lülitu režiimile Work, ava Plugins ja vali Deep research; veebis ava töövestluses menüü +. Kättesaadavus sõltub sinu kontost ja tööruumist:
"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?"
See on kontrollietapp, mille me peaaegu alati vahele jätame, sest meil pole poolt päeva selleks aega, ometi maksab selle puudumine meile kaks aastat hiljem: teeki enam ei hooldata, selle ainus hooldaja on kadunud ja sa oled jäänud sõltuvusega, mille pead kiirustades ümber kirjutama.
Hangi teostatavaid raporteid
Raporti kvaliteet sõltub otseselt vihje täpsusest. „Kus on nõrkusekohad?“ annab palju kasulikuma tulemuse kui „Analüüsi projekti“, sest esimene sõnastus seab nurga ja sunnib looma hierarhiat. Küsi ka selget vormingut – „järjesta prioriteedi järgi“, „korralda moodulite kaupa“ –, et saada dokument, mida saad skannida, mitte kaanest kaaneni lugeda. Seejärel jälita seda konkreetsete Codexi ülesannetega, mis parandavad tuvastatud probleeme. Sel hetkel lakkab analüüs olemast lihtsalt järjekordne raport ja saab tööplaani lähtepunktiks. Lõpuks jaga neid raporteid oma meeskonnaga, sest nende väärtus kasvab koos inimeste arvuga, kes neile iga päev viitavad.
Peamised punktid
- Hoidla analüüsimiseks käivita Codex kirjutuskaitstud režiimis (
/permissionsvõicodex exec, mis on vaikimisi kirjutuskaitstud) - Ideaalne sisseelamiseks, audititeks ja tehnilise võla hindamiseks
- ChatGPT Worki sügav uurimine sobib mitmeallikaliste küsimuste jaoks, nagu välise teegi hindamine
- Tulemused toidavad konkreetseid Codexi ülesandeid tuvastatud probleemide lahendamiseks
- Vaata iga raport üle: agent võib eksida, eriti puuduva sisu osas