Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Tavs pirmais Codex uzdevums

Nodarbība 4 no 20 Atjaunota 2026. gada 3. novembris Programmētājs
Šajā lapā
  1. Palaid savu pirmo uzdevumu
  2. No Codex Cloud
  3. No IDE
  4. No CLI
  5. Codex rezultāta uzbūve
  6. Labu instrukciju rakstīšana
  7. Galvenās atziņas

Atjaunināts 2026. gada 3. novembrī, pamatojoties uz Codex komandu atsauces materiāliem (CLI 0.166.0): opcijas --show-diff un --apply nepastāv. Lokāli Codex modificē failus tieši savā smilškastē; izmaiņas apskati, izmantojot /diff vai git 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 elementsSaturs
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