L-Ewwel Kompitu ta' Codex Tiegħek
F'din il-paġna
Aġġornat fit-3 ta’ Novembru, 2026 abbażi tar-referenza tal-kmandi ta’ Codex (CLI 0.166.0): l-għażliet
--show-diffu--applyma jeżistux. Lokalment, Codex jimmodifika l-fajls direttament fis-sandbox tiegħu; irrevedi l-bidliet bl-użu ta’/diffjewgit 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 Ikkonsenjat | X’Jinkludi |
|---|---|
| Change diff | Kull linja miżjuda, mmodifikata jew imħassra, fajl b’fajl |
| Execution log | Il-passi kollha: fajls moqrija, kmandi mħaddma, raġunament tal-aġent |
| Test results | Jekk jeżistu t-testijiet, Codex iħaddimhom biex jivverifika li xejn ma nkiser |
| Available actions | Approva, 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