Via unua AI-helpata redakto

Por kiu ĉi tio estas

Tiu ĉi lernilo estas por Jenks, la sola administranto de la retejo. Vi petos la modelon de la retejo verki skizon de ŝanĝo al unu spert-eniro, revizios la diff-on, aplikos ĝin al la branĉo dev, kontrolos la antaŭrigardon kaj poste publikigos ĝin. Nenio atingas jenksguo.xyz ĝis vi promocias ĝin.

Antaŭ ol vi komencas

Vi bezonas la jenks CLI (vidu Connect your agent) kaj vian administraĵetonon. La ĵetono loĝas en la macOS Keychain kiel agent-env:JENKSGUO_ADMIN_TOKEN. Ŝargu ĝin en vian ŝelon nur por ĉi tiu seanco:

export JENKSGUO_ADMIN_TOKEN="$(security find-generic-password -s agent-env:JENKSGUO_ADMIN_TOKEN -w)"

Neniam algluu la ĵetonon en babilejon, commit aŭ enhav-dosieron.

Paŝo 1 — kontrolu vian aliron

jenks admin whoami

Vi devus vidi, ke la ĵetono validas kaj ke GitHub-eldonado estas agordita. Se eldonado ne estas agordita, redaktoj ankoraŭ povas esti validigitaj sed ne committed.

Paŝo 2 — legu la nunan eniron

jenks admin get xero-developer-evangelist

Tio elpresas la krudan fonton: YAML-frontmaterion (titolo, datoj, etikedoj, lensoj, metrikoj, pruvoj) kaj la Markdown-korpon (Superrigardo, Kion Jenks faris, Atingoj, Kial tio gravas por dungantoj). Legu ĝin antaŭ ol vi ŝanĝas ĝin — vi revizios la skizon de la AI kompare kun ĝi.

Paŝo 3 — petu de la AI skizon, en dev

jenks admin ai-edit xero-developer-evangelist \
  "tighten the summary to under 30 words without changing any facts" \
  --branch dev

La modelo de la retejo reverkas la dosieron kaj redonas tri aferojn:

• la proponitan enhavon,
• diff kontraŭ la aktuala dosiero,
• validigajn problemojn, se iuj, el la sama skemo kiun la konstruado uzas.

Ankoraŭ nenio estas committed.

Paŝo 4 — reviziu la diff-on

Kontrolu, linion post linio:

• Ĉiu fakto ankoraŭ kongruas kun la vero. La AI ne devas aldoni nombrojn, datojn aŭ asertojn.
• Oficialaj labor-titoloj restas neŝanĝitaj.
• Etikedoj kaj lensoj ankoraŭ estas validaj (la validigilo markos nekonatajn).

Se la skizo estas malĝusta, rulu ai-edit denove kun pli klara instrukcio, aŭ redaktu la dosieron mem kaj uzu jenks admin put.

Paŝo 5 — apliku ĝin al dev

jenks admin ai-edit xero-developer-evangelist \
  "tighten the summary to under 30 words without changing any facts" \
  --branch dev --apply

--apply validigas la proponon denove kaj faras commit al la branĉo dev.

Paŝo 6 — observu la dukton

jenks admin deploys

CI retradukas la ŝanĝitan eniron en la ses aliajn lingvojn, rekonstrui la retejon kaj deplojas la branĉon dev. Tio kutime daŭras kelkajn minutojn.

Paŝo 7 — kontrolu la antaŭrigardon

Malfermu https://dev.jenksguo.xyz/career/xero-developer-evangelist kaj tradukitan version kiel https://dev.jenksguo.xyz/zh/career/xero-developer-evangelist. La dev-retejo ne estas indeksata de serĉiloj.

Paŝo 8 — publikigu

jenks admin promote

Tio kunfandas dev en main; CI poste deplojas jenksguo.xyz.

Kion vi lernis

• AI skizas, vi decidas: ai-edit neniam faras commit sen --apply.
• La sama validigilo protektas la CLI, la REST API, MCP kaj la /admin konzolon.
• Tradukoj sekvas aŭtomate, kaj git-historio konservas ĉiun version, do ajna ŝanĝo povas esti malfarita.

Sekve: Update content with AI traktas plurdosierajn ŝanĝojn kaj la aliajn manierojn redakti.