Tavs pirmais Codex uzdevums
Šajā lapā
Atjaunināts 2026. gada 3. novembrī, pamatojoties uz Codex komandu atsauces materiāliem (CLI 0.166.0): opcijas
--show-diffun--applynepastāv. Lokāli Codex modificē failus tieši savā smilškastē; izmaiņas apskati, izmantojot/diffvaigit diff. Paplašinājuma komanda “Codex: New Task” ir aizstāta ar Codex: Open Codex Sidebar. Avoti: Izstrādātāja komandas · Codex IDE paplašinājums.
Palaid savu pirmo uzdevumu
Tavs konts ir iestatīts, GitHub ir pieslēgts un AGENTS.md ir sagatavots: ir laiks redzēt aģentu darbībā. Šeit ir zelta likums jebkura līmeņa lietotājam — sāc ar uzdevumu, kurā jau zini pareizo atbildi. Tu daudz nemācīsies, vērojot, kā Codex risina problēmu, kuru pats nevari novērtēt, taču uzzināsi ārkārtīgi daudz, vērojot, kā tas darbojas tev pazīstamā vidē.
No Codex Cloud
Tīmeklī vai darbvirsmas lietotnē izvēlies Work in › Cloud, atlasi publicēto vidi savam repozitorijam (2. nodarbība) un ievadi savu uzdevumu ievades laukā. Pilnīgi pietiks ar košu apzināti pieticīgu formulējumu.
Task: "Add a .gitignore file suitable for a Node.js/TypeScript
project if one doesn't already exist."
Šis formulējums ietver nosacījumu — “if one doesn’t already exist” (ja tāds vēl neeksistē) —, kas tieši padara novērošanu interesantu. Codex Cloud vidē uzdevums tiek izpildīts tavam repozitorijam publicētajā vidē: Codex pārbauda, vai .gitignore eksistē, pārliecinās, ka tas aptver Node.js un TypeScript (ja tas jau ir), pēc vajadzības izveido vai atjaunina failu un tad parāda rezultātu kā atšķirību (diff). Izpildes žurnāls tiek straumēts reāllaikā: tieši šeit redzēsi, vai aģents ievēroja nosacījumu vai pārrakstīja tavu esošo failu.
No IDE
Atver savu projektu programmā VS Code (vai Cursor, Windsurf) un palaid Codex, noklikšķinot uz tā ikonas vai izmantojot komandu paleti:
Ctrl+Shift+P → "Codex: Open Codex Sidebar"
Pēc tam noformulē pieprasījumu, kas izmanto lokālo kontekstu, norādot konkrēto failu:
"Add email validation to the contact form
in src/components/ContactForm.tsx"
Paplašinājums parāda kopsavilkumu un modificētās rindas blakus kodam; tu saglabā vēlamos labojumus un tajā pašā sarunā vari lūgt papildinājumus. Dokumentācija iesaka pirms un pēc uzdevuma izveidot Git kontrolpunktu, lai vajadzības gadījumā varētu atgriezties iepriekšējā stāvoklī.
No CLI
# Pārvietojies uz projekta direktoriju
cd my-project
# Sāc sesiju ar sākotnēju instrukciju
codex "Add a README.md with the project description, installation instructions, and available commands"
Lokāli Codex modificē failus tieši tavā darba direktorijā, ievērojot smilškastes un apstiprināšanas politikas robežas: tas prasa atļauju pirms darbību veikšanas, kurām tā ir nepieciešama. Lai pirms fiksēšanas (commit) apskatītu izmaiņas, sesijā ieraksti /diff: komanda parāda Git atšķirības, ieskaitot neizsekotos failus. Komanda /review lūdz Codex pārskatīt tavu darba koku. Skriptētai lietošanai codex exec izpilda to pašu uzdevumu bez mijiedarbības (14. nodarbība) — tādā gadījumā Git un tava konveijera ziņā ir izlemt, kas tiek saglabāts.
Codex rezultāta uzbūve
Neatkarīgi no ieejas punkta, pabeigts uzdevums vienmēr atgriež tos pašus četrus elementus. Apskati tos šādā secībā: atšķirības (diff) norāda, kas mainījies, žurnāls skaidro, kāpēc, testi apliecina drošību, bet pieejamās darbības nodod vadību atpakaļ tev.
| Piegādātais elements | Saturs |
|---|---|
| Izmaiņu atšķirības (Change diff) | Katra pievienotā, modificētā vai dzēstā rinda, fails pa failam |
| Izpildes žurnāls (Execution log) | Visi soļi: nolasītie faili, izpildītās komandas, aģenta spriedumi |
| Testu rezultāti (Test results) | Ja testi eksistē, Codex tos izpilda, lai pārliecinātos, ka nekas nav sabojāts |
| Pieejamās darbības (Available actions) | Apstiprināt, modificēt, izveidot PR vai atkārtot ar citām instrukcijām |
Iesācēji bieži vien ignorē izpildes žurnālu, lai gan tieši tas māca, kā pareizi noformulēt uzdevumus. Redzot, kurus failus Codex atvēra pirms lēmuma pieņemšanas, tu atklāj, ko tas meklēja, bet neatrada — bieži vien tā ir konvencija, kurai vajadzēja būt failā AGENTS.md.
Labu instrukciju rakstīšana
Rezultāta kvalitāte ir tieši atkarīga no instrukciju kvalitātes, un atšķirība starp abiem tālāk minētajiem formulējumiem ir daudz lielāka nekā starpība starp diviem modeļiem.
"Improve the code"
"In src/lib/auth.ts, replace manual JWT handling
with the jose library. Keep the same public interface
(signToken, verifyToken). Update the corresponding tests."
Otrā versija strādā, jo tā atbild uz četriem jautājumiem, ko aģents sev tāpat uzdod. Tā norāda iesaistītos failus, ietaupot laiku klīstot un trāpot nepareizā vietā. Tā definē sagaidāmo rezultātu — uzvedību, saskarni, formātu —, lai tas zinātu, kad apstāties. Tā nosaka ierobežojumus, šajā gadījumā saglabājot publisko saskarni, kas novērš situācijas, kad tas “uzlabo” lietas, laužot izsaucošās funkcijas; citur tas varētu būt “nesabojā testus”. Un, ja likmes to attaisno, tā pievieno biznesa kontekstu: norādot “šī ir maksājuma veidlapa, drošība ir kritiska”, tas patiešām maina tā kompromisu izvēli.
Lai to pielāgotu sev, paņem esošu projektu un savieno trīs dažāda rakstura uzdevumus: analīzi bez modificēšanas (“Uzskaiti visus TypeScript failus, kuriem nav saistītu testu”); mērķtiecīgu ģenerēšanu (“Ģenerē vienības testu šim failam”); ierobežota apjoma labojumu (“Novērs ESLint brīdinājumus mapē src/utils/”). Katram no tiem atzīmē, kas tev būtu bijis jānorāda uzreiz: šis nožēlu saraksts ir tavs pirmais AGENTS.md melnraksts.
Galvenās atziņas
- Savus pirmos uzdevumus uzsāc ar vienkāršiem, mērķtiecīgiem pieprasījumiem
- Codex katram uzdevumam nodrošina pilnu izpildes žurnālu
- Rezultāta kvalitāte ir atkarīga no tavu instrukciju precizitātes
- Tev vienmēr paliek kontrole: apstiprini, modificē vai noraidi
- Sāc ar zema riska uzdevumiem, pirms pāriet pie kritiskām izmaiņām