Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

L-Ewwel Kompitu ta' Codex Tiegħek

Lezzjoni 4 / 20 Aġġornat 3 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Neddi l-Ewwel Kompitu Tiegħek
  2. Minn Codex Cloud
  3. Mill-IDE
  4. Mill-CLI
  5. Anatomija ta’ Riżultat ta’ Codex
  6. Kif Tikteb Istruzzjonijiet Tajbin
  7. Punti Ewlenin

Aġġornat fit-3 ta’ Novembru, 2026 abbażi tar-referenza tal-kmandi ta’ Codex (CLI 0.166.0): l-għażliet --show-diff u --apply ma jeżistux. Lokalment, Codex jimmodifika l-fajls direttament fis-sandbox tiegħu; irrevedi l-bidliet bl-użu ta’ /diff jew git diff. Il-kmand tal-estensjoni “Codex: New Task” ġie sostitwit minn Codex: Open Codex Sidebar. Sorsi: Developer commands · Codex IDE extension.

Neddi l-Ewwel Kompitu Tiegħek

Il-kont tiegħek huwa kkonfigurat, GitHub huwa konness, u AGENTS.md huwa fil-post: wasal iż-żmien biex tara l-aġent fl-azzjoni. Hawnhekk hemm regola bażika għal kull livell ta’ ħila—ibda b’kompitu fejn diġà taf it-tweġiba korretta. Ma titgħalimx ħafna tara lil Codex isolvi problema li ma tistax tevalwa, iżda titgħallem ammont enormi billi tosservah jaħdem fuq territorju familjari.

Minn Codex Cloud

Fuq il-web jew fl-app tad-desktop, agħżel Work in › Cloud, agħżel l-ambjent ippubblikat għar-repożitorju tiegħek (Lezzjoni 2), u ikteb il-kompitu tiegħek fil-kamp tal-input. Xi ħaġa deliberatament modesta taħdem perfettament.

Task: "Add a .gitignore file suitable for a Node.js/TypeScript 
       project if one doesn't already exist."

Din il-formulazzjoni tinkludi kundizzjoni—“jekk wieħed diġà ma jeżistix”—li hija preċiżament dak li jagħmilha interessanti biex tiġi osservata. F’Codex Cloud, il-kompitu jiġi eżegwit fl-ambjent li ppubblikajt għal dan ir-repożitorju: Codex jiċċekkja jekk .gitignore jeżistix, jivverifika li jkopri Node.js u TypeScript jekk ikun hemm, joħloq jew jaġġorna l-fajl skont il-ħtieġa, u mbagħad juri r-riżultat bħala diff. Il-log tal-eżekuzzjoni jinxtered f’ħin reali: hawnhekk hija fejn se tara jekk l-aġentx irrispettax il-kundizzjoni jew jekk ħassarx il-fajl eżistenti tiegħek.

Mill-IDE

Iftaħ il-proġett tiegħek f’VS Code (jew Cursor, Windsurf) u neddi lil Codex permezz tal-ikona tiegħu jew il-Paletta tal-Kmandi:

Ctrl+Shift+P → "Codex: Open Codex Sidebar"

Imbagħad ifformula talba li tisfrutta l-kuntest lokali billi tsemmi l-fajl speċifiku:

"Add email validation to the contact form 
 in src/components/ContactForm.tsx"

L-estensjoni turi sommarju u l-linji mmodifikati maġenb il-kodiċi; iżżomm il-bidliet li trid u titlob segwiti fl-istess konversazzjoni. Id-dokumentazzjoni tirrakkomanda li toħloq checkpoint ta’ Git qabel u wara l-kompitu sabiex tkun tista’ terġa’ lura jekk ikun meħtieġ.

Mill-CLI

# Navigate to the project directory
cd my-project

# Start a session with an initial instruction
codex "Add a README.md with the project description, installation instructions, and available commands"

Lokalment, Codex jimmodifika l-fajls direttament fid-direttorju tax-xogħol tiegħek, fil-limiti tas-sandbox u l-politika ta’ approvazzjoni: jitlob permess qabel ma jieħu azzjonijiet li jeħtieġuh. Biex tirrevedi x’inbidel qabel ma tagħmel commit, ikteb /diff fis-sessjoni: il-kmand juri d-diff ta’ Git, inklużi fajls mhux traċċati. /review jitlob lil Codex biex jirrevedi l-arbuxxell tax-xogħol (working tree) tiegħek innifsu. Għal użu skriptjat, codex exec iħaddem l-istess kompitu mingħajr interazzjoni (Lezzjoni 14)—f’dak il-każ, jiddependi fuq Git u l-pipeline tiegħek biex tiddeċiedi x’jinżamm.

Anatomija ta’ Riżultat ta’ Codex

Irrispettivament mill-punt tad-dħul, kompitu kkompletat dejjem jirritorna l-istess erba’ elementi. Irrevidihom f’dan l-ordni: id-diff jgħidlek x’inbidel, il-log jgħidlek għaliex, it-testijiet jgħidulek jekk huwiex sikur, u l-azzjonijiet jerġgħu jagħtuk il-kontroll.

Element IkkonsenjatX’Jinkludi
Change diffKull linja miżjuda, mmodifikata jew imħassra, fajl b’fajl
Execution logIl-passi kollha: fajls moqrija, kmandi mħaddma, raġunament tal-aġent
Test resultsJekk jeżistu t-testijiet, Codex iħaddimhom biex jivverifika li xejn ma nkiser
Available actionsApprova, immodifika, oħloq PR, jew erġa’ ħaddem b’istruzzjonijiet differenti

Il-bidu spiss jinjoraw il-log tal-eżekuzzjoni, madankollu huwa l-element li jgħallmek kif tifformula l-kompiti tiegħek. Billi tara liema fajls fetaħ Codex qabel ma ħa deċiżjoni, tiskopri x’kien qed ifittex iżda ma setax isib—spiss konvenzjoni li kellha tkun f’AGENTS.md.

Kif Tikteb Istruzzjonijiet Tajbin

Il-kwalità tar-riżultat tiddependi direttament fuq il-kwalità tal-istruzzjonijiet, u d-differenza bejn iż-żewġ formulazzjonijiet hawn taħt hija ferm akbar mid-differenza bejn żewġ mudelli.

"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."

It-tieni verżjoni taħdem għax tweġib erba’ mistoqsijiet li l-aġent jistaqsi lilu nnifsu anyway. Tispeċifika l-fajls involuti, u b’hekk tiffrankalih milli jesplora u jimmira l-post żbaljat. Tiddefinixxi r-riżultat mistenni—imġiba, interfaċċa, format—sabiex ikun jaf meta jieqaf. Tistabbilixxi restrizzjonijiet, hawnhekk billi tippreserva l-interfaċċa pubblika, li tipprevjenih milli “jtejjeb” l-affarijiet billi jkisser dawk li qed iseħħu s-sejħiet (callers); f’postijiet oħra dan jista’ jkun “tiksrux it-testijiet”. U meta l-ispejjeż jiġġustifikawh, iżid kuntest tan-negozju: li tispeċifika “din hija formola ta’ ħlas, is-sigurtà hija kritika” verament tbiddel il-kompromessi (trade-offs) tiegħu.

Biex tagħmel dan tiegħek, ħu proġett eżistenti u għaqqad flimkien tliet kompiti ta’ natures differenti: analiżi mingħajr modifika, “Elenska l-fajls TypeScript kollha li ma għandhomx testijiet assoċjati”; ġenerazzjoni mmirata, “Iġġenera test tal-unità għal dan il-fajl”; tiswija b’ambitu limitat, “Issolvi t-twissijiet ta’ ESLint f’src/utils/”. Għal kull wieħed, innota x’kellek tispeċifika mill-bidu: din il-lista ta’ dispjaċiri hija l-ewwel abbozz tiegħek ta’ AGENTS.md.

Punti Ewlenin

  • Neddi l-ewwel kompiti tiegħek b’talbiet semp liċi u mmirati
  • Codex jipprovdi log sħiħ tal-eżekuzzjoni għal kull kompitu
  • Il-kwalità tar-riżultat tiddependi fuq il-preċiżjoni tal-istruzzjonijiet tiegħek
  • Dejjem iżżomm il-kontroll: approva, immodifika, jew irrifjuta
  • Ibda b’kompiti b’riskju baxx qabel ma tgħaddi għal bidliet kritiċi