Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Do Chéad Tasc Codex

Ceacht 4 as 20 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Do Chéad Tasc a Thosú
  2. Ó Codex Cloud
  3. Ón IDE
  4. Ón CLI
  5. Anatamaíocht Toradh Codex
  6. Treoracha Maithe a Scríobh
  7. Príomhphointí

Nuashonraithe an 3 Samhain, 2026 bunaithe ar thagairt ordú Codex (CLI 0.166.0): níl na roghanna --show-diff agus --apply ann. Go logánta, déanann Codex athruithe ar chomhaid go díreach laistigh dá ghaineamhlann; déan iniúchadh ar na hathruithe trí úsáid a bhaint as /diff nó git diff. Tá an t-ordú leathanaigh “Codex: New Task” curtha in ionad Codex: Open Codex Sidebar. Foinse: Orduithe forbróra · Leathnú IDE Codex.

Do Chéad Tasc a Thosú

Tá do chuntas socraithe, tá GitHub nasctha, agus tá AGENTS.md ina áit: tá sé in am an gníomhaire a fheiceáil i mbun gníomhaíochta. Seo riail ghinearálta do gach leibhéal scile—tosaigh le tasc a bhfuil an freagra ceart ar eolas agat cheana féin. Ní fhoghlaimfidh tú mórán ag breathnú ar Codex fadhb a réiteach nach féidir leatsa a mheas, ach foghlaimfidh tú go leor trína fheiceáil ag obair ar thalamh atá eolach duit.

Ó Codex Cloud

Ar an ngréasán nó san aip deisce, roghnaigh Work in › Cloud, roghnaigh an timpeallacht fhoilsithe do d’fhostóir (Ceacht 2), agus clóscríobh do thasc isteach sa réimse ionchuir. Oibreoidh rud atá beagnach simplí go foirfe.

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

Cuimsíonn an frásaíocht seo coinníoll—“if one doesn’t already exist”—agus is é sin go díreach a dhéanann suimiúil é a bheith á fheiceáil. I Codex Cloud, ritheann an tasc sa timpeallacht a d’fhoilsigh tú don fhostóir seo: seiceálann Codex an bhfuil .gitignore ann, fíoraíonn sé an gcumhdaíonn sé Node.js agus TypeScript má tá, cruthaíonn nó nuashonraíonn sé an comhad de réir mar is gá, agus taispeánann sé an toradh duit mar dhifríocht. Sreabhann an log feidhmithe i bhfíor-am: seo an áit a fheicfidh tú an raibh meas ag an ngníomhaire ar an gcoinníoll nó an ndearna sé do chomhad atá ann cheana a fhorscríobh.

Ón IDE

Oscail do thionscadal in VS Code (nó Cursor, Windsurf) agus seol Codex trína dheilbhín nó tríd an bPailéad Ordaithe:

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

Ansin, déan iarratas a fhoirmliú a úsáideann comhthéacs logánta trí ainmniú an chomhaid shonraigh:

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

Taispeánann an leathnú achoimre agus na línte modhnaithe taobh le taobh an chóid; coinníonn tú na hathruithe atá uait agus iarrann tú leanúint laistigh den chomhrá céanna. Molann an doiciméadú seicphointe Git a chruthú roimh agus tar éis an tasc ionas gur féidir leat dul ar ais má tá gá leis.

Ón 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"

Go logánta, déanann Codex athruithe ar chomhaid go díreach i do chomhadlann oibre, laistigh de theorainneacha an ghaineamhlainn agus na polasaí formheasa: iarrann sé cead sula ndéanann sé gníomhartha a éilíonn é. Chun iniúchadh a dhéanamh ar an méid a d’athraigh sula ndéanann tú tiomantú, clóscríobh /diff sa seisiún: taispeánann an t-ordú an difríocht Git, comhaid gan rian san áireamh. Iarrann /review ar Codex do chrann oibre féin a athbhreithniú. Chun úsáid scriptithe, ritheann codex exec an tasc céanna gan idirghníomhaíocht (Ceacht 14)—sa chás sin, is faoi Git agus do phíblíne atá sé a chinneadh cad a choinnítear.

Anatamaíocht Toradh Codex

Beag beann ar an bpointe iontrála, filleann tasc críochnaithe na ceithre ghné chéanna i gcónaí. Déan iniúchadh orthu san ord seo: deir an difríocht cad a d’athraigh, deir an log cén fáth, deir na tástálacha an bhfuil sé sábháilte, agus tugann na gníomhartha an smacht ar ais duit.

Gné a SeachadadhCad atá ann
Difríocht athraitheGach líne a cuireadh leis, a modhnaíodh, nó a scriosadh, comhad ar chomhad
Log feidhmitheGach céim: comhaid léite, orduithe rite, réasúnaíocht an ghníomhaire
Torthaí tástálaMá tá tástálacha ann, ritheann Codex iad chun a fhíorú nach bhfuil aon rud briste
Gníomhartha atá ar fáilFormheas, modhnú, PR a chruthú, nó athrith le treoracha difriúla

Is minic a dhéanann tosaitheoirí neamhaird ar an log feidhmithe, ach is é an ghné é a mhúineann duit conas do chuid tascanna a fhoirmliú. Trí fheiceáil cé na comhaid a d’oscail Codex sula ndearna sé cinneadh, faigheann tú amach cad a bhí á lorg aige ach nár aimsigh sé—go minic coinbhinsiún a ba chóir a bheith in AGENTS.md.

Treoracha Maithe a Scríobh

Braitheann cáilíocht an toraidh go díreach ar cháilíocht na dtreoracha, agus tá an bhearna idir an dá fhoirmliú thíos i bhfad níos mó ná an bhearna idir dhá mhúnla.

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

Oibríonn an dara leagan toisc go bhfreagraíonn sé ceithre cheist a chuireann an gníomhaire air féin ar aon nós. Sonraíonn sé na comhaid atá i gceist, rud a shábhálann ó bheith ag iniúchadh agus díriú ar an áit mhícheart. Sainíonn sé an toradh atá ag teastáil—iompar, comhéadan, formáid—ionas go bhfuil a fhios aige cathain le stop. Socraíonn sé srianta, anseo ag caomhnú an chomhéadain phoiblí, rud a choscann air rudaí a “fheabhsú” trí ghlaonna a bhriseadh; in áit eile d’fhéadfadh sé seo a bheith “ná bris tástálacha”. Agus nuair a fhíréanaíonn an staid é, cuireann sé comhthéacs gnó leis: má shonraíonn tú “is foirm íocaíochta í seo, tá an tslándáil ríthábhachtach” athraíonn sé a chuid malartuithe go fírinneach.

Chun é seo a dhéanamh leatsa, tóg tionscadal atá ann cheana agus slabhraigh trí thasc de chineálacha éagsúla le chéile: anailís gan modhnú, “List all TypeScript files that lack associated tests”; giniúint spriocdhírithe, “Generate a unit test for this file”; socruithe teoranta-scóip, “Fix ESLint warnings in src/utils/”. Do gach ceann, tabhair faoi deara cad ba chóir duit a shonrú ar dtús: is é an liosta aiféala seo do chéad dréacht de AGENTS.md.

Príomhphointí

  • Seol do chéad tascanna le hiarratais simplí, spriocdhírithe
  • Soláthraíonn Codex log feidhmithe iomlán do gach tasc
  • Braitheann cáilíocht an toraidhe ar chruinneas do threoracha
  • Coinníonn tú smacht i gcónaí: formheas, modhnú, nó diúltaigh
  • Tosaigh le tascanna íseal-riosca sula mbogann tú chuig athruithe criticiúla