Hĺbková analýza repozitára
Na tejto strane
Lekcia aktualizovaná 3. novembra 2026 na základe manuálu Codex: „Hĺbkový výskum pre GitHub“ nie je funkciou Codexu. Analýza repozitára sa vykonáva s Codexom v režime len na čítanie, zatiaľ čo hĺbkový výskum je funkciou ChatGPT Work, ktorej dostupnosť závisí od vášho účtu a pracovného priestoru. Nesprávna porovnávacia tabuľka trvania z predchádzajúcej verzie, ktorá nemala zdroj, bola odstránená. Zdroje: Codex CLI · Neinteraktívny režim.
Hĺbková analýza repozitára
Pred úpravou kódu ho často potrebuješ najprv pochopiť: architektúru staršieho projektu, jeho závislosti a technický dlh. Na tento účel slúžia dva nástroje. Codex analyzuje repozitár zvnútra – číta súbory, skúma históriu Gitu a spúšťa diagnostické príkazy – bez toho, aby vykonal akékoľvek zmeny. Funkcia hĺbkový výskum v ChatGPT Work vykonáva vyšetrovania naprieč viacerými zdrojmi a poskytuje report so zdrojmi; je to správny nástroj pre otázky, ktoré presahujú rámec repozitára, ako je napríklad hodnotenie externej knižnice.
Analýza bez akýchkoľvek úprav
Štandardná úloha Codexu vykonáva akciu: písanie kódu, opravu chyby alebo generovanie testov. Pri analýze požiadaj Codex, aby syntetizoval informácie bez akýchkoľvek úprav, a daj mu prostriedky, ako sa tejto podmienky držať. Nastav reláciu do režimu len na čítanie (/permissions, režim read-only) alebo spusti analýzu pomocou codex exec, ktorý štandardne používa sandbox len na čítanie. Dokáže naskenovať stovky súborov, preskúmať históriu Gitu a vytvoriť podrobný report. Tento rozdiel sa okamžite prejaví v tvojom prompte, ktorý by sa mal zamerať na pochopenie, nie na úpravu:
"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?"
Výsledkom nie je commit, ale štruktúrovaný dokument obsahujúci odkazy na relevantné súbory a odporúčania. Ten si preštuduješ, prediskutuješ na technickej porade a opravíš tam, kde je chybný.
Urýchlenie technického zaškolenia
Keď sa k tímu pripojí nový vývojár, zvyčajne strávi prvé dva týždne mentálnou rekonštrukciou mapy, ktorú si nikto nikdy nezapisoval: ktorá služba volá čo, prečo má modul názov, ktorý už nezodpovedá jeho obsahu, alebo kde sa skrýva logika fakturácie. Codex mu túto mapu dokáže nakresliť:
"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"
Výsledný dokument slúži ako referencia počas prvých niekoľkých týždňov a upravuje sa podľa spätnej väzby od tímu. Toto cvičenie opráv má neočakávaný benefit: odhaľuje slepé miesta, ktoré sa nikto neobťažoval zdokumentovať, pretože „všetci vedia, ako to funguje“.
Audit závislostí a technického dlhu
Druhým prirodzeným prípadom použitia je inventarizácia. Kódová základňa stará tri roky hromadí opustené knižnice, funkčné duplikáty a mŕtve importy, ktoré sa nikto neodváži odstrániť kvôli nedostatku prehľadu:
"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"
Táto analýza krížovo odkazuje package.json, lock file a importy, ktoré sa skutočne nachádzajú v kóde. Pre známe zraniteľnosti a stav údržby balíkov potrebuje verejné údaje, takže musíš explicitne povoliť prístup k sieti alebo použiť auditovacie nástroje svojho správcu balíkov (ako je npm audit). Hodnotenie technického dlhu nasleduje rovnakú logiku s jednou dodatočnou požiadavkou – posledný riadok promptu. Bez kritérií na triedenie dostaneš zoznam štyridsiatich problémov bez tušenia, kde začať.
"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."
Hodnota týchto analýz spočíva v pomere medzi investovaným časom a získanými výsledkami: niekoľko presných inštrukcií nahradí dni čítania. Over si to na vlastných projektoch namiesto spoliehania sa na všeobecné odhady a vždy si report preštuduj: agent sa môže mýliť, najmä pokiaľ ide o to, čo repozitár neobsahuje.
Vyhodnotenie externého projektu pred adopciou
Pri open-source knižnici, ktorú zvažuješ adoptovať, otázka presahuje rámec repozitára: frekvencia vydaní, aktivita v issue trackeri a povesť. Toto je doména funkcie hĺbkový výskum v ChatGPT Work. V desktopovej aplikácii prepnite na Work, otvorte Plugins a vyberte Deep research; na webe otvorte menu + v konverzácii Work. Dostupnosť závisí od vášho účtu a pracovného priestoru:
"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?"
Toto je overovací krok, ktorý takmer vždy vynecháme, pretože si nemôžeme dovoliť stráviť pol dňa jeho vykonaním, no jeho absencia nás o dva roky stojí draho: knižnica sa už neudržiava, jej jediný správca zmizol a zostane vám závislosť, ktorú musíte v zhone prepísať.
Získanie použiteľných reportov
Kvalita reportu priamo závisí od presnosti promptu. „Kde sú body nestability?“ prináša oveľa užitočnejší výsledok než „Analyzuj projekt“, pretože prvá formulácia určuje uhol pohľadu a vynucuje hierarchiu. Požaduj tiež explicitný formát – „zoradiť podľa priority“, „organizovať podľa modulu“ – aby si získal dokument, ktorý sa dá rýchlo prejsť, namiesto toho, aby si ho musel čítať od začiatku do konca. Následne pokračuj konkrétnymi úlohami Codexu, ktoré opravia identifikované problémy. V tomto bode sa analýza prestáva byť len ďalším reportom a stáva sa východiskovým bodom pre pracovný plán. Nakoniec tieto reporty zdieľaj so svojím tímom, keďže ich hodnota rastie s počtom ľudí, ktorí sa na ne denne odvolávajú.
Kľúčové poznatky
- Na analýzu repozitára spusti Codex v režime len na čítanie (
/permissionsalebocodex exec, ktorý je štandardne len na čítanie) - Ideálne na zaškolenie, audity a hodnotenie technického dlhu
- Hĺbkový výskum v ChatGPT Work sa hodí na otázky zahŕňajúce viacero zdrojov, ako je hodnotenie externej knižnice
- Výsledky slúžia ako vstup pre konkrétne úlohy Codexu na opravu identifikovaných problémov
- Každý report si preštuduj: agent sa môže mýliť, najmä pokiaľ ide o chýbajúci obsah