Skip to main content
Jenks Guo

Dokumentaro / tutorials

Via unua AI-asistata redakto

Por Jenks — fari unuan enhav-ŝanĝon kun AI-helpo, antaŭrigardi ĝin ĉe dev.jenksguo.xyz kaj antaŭenigi ĝin al la viva retejo.

Por kiu ĉi tio estas

Ĉi tiu lernilo estas por Jenks, la sola administranto de la retejo. Vi petos la modelon de la retejo skizi ŝanĝon al unu sperto-ero, revizios la diff-on, apliki ĝin al la branĉo dev, kontrolos la antaŭrigardon kaj poste publikigos ĝin. Nenio atingas la vivan retejon ĝis vi ĝin antaŭenigas.

Antaŭ ol vi komencas

Vi bezonas la jenks CLI (vidu Connect your agent) kaj agent-ĵetonon kun la content amplekso. Kreu unu en la konzolo ĉe https://admin.jenksguo.xyz/admin → Access (vidu Give an AI agent access), poste ŝargu ĝin en vian ŝelon nur por ĉi tiu seanco:

export JENKSGUO_ADMIN_TOKEN=jgx_agt_…

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

Paŝo 1 — kontrolu vian aliron

jenks admin whoami

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

Paŝo 2 — legu la nunan eniron

jenks admin get xero-developer-evangelist

Tio presas la krudan fonton: YAML-frontmatter (titolo, datoj, etikedoj, lensoj, metrikoj, pruvo) kaj la Markdown-korpon (Superrigardo, Kion faris Jenks, Atingoj, Kial tio gravas por dungantoj). Legu ĝin antaŭ ol vi ŝanĝas ĝin — vi revizios la skizon de la AI kompare al ĝ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 kompare al la nuna dosiero,
  • validigajn problemojn, se ekzistas, el la sama skemo, kiun la konstruo uzas.

Ankoraŭ nenio estas commitita.

Paŝo 4 — reviziu la diff-on

Kontrolu, linio post linio:

  • Ĉiu fakto ankoraŭ kongruas kun la vero. La AI ne rajtas aldoni nombrojn, datojn aŭ asertojn.
  • Oficialaj labortitoloj 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 commitas ĝin al la branĉo dev.

Paŝo 6 — observu la dukton

jenks admin deploys

CI retradukas la ŝanĝitan eniron al la ses aliaj lingvoj, rekonstruas 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 indeksita de serĉiloj.

Paŝo 8 — publikigu

jenks admin promote

Tio kunfandas dev en main; CI poste deplojas la vivan retejon (jenksguo.pages.dev kaj jenksguo.xyz ĝisdatigas kune).

Kion vi lernis

  • AI skizas, vi decidas: ai-edit neniam commitas 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: Ĝisdatigi enhavon per AI traktas plurdosierajn ŝanĝojn kaj la aliajn manierojn redakti.

.mdĈi tiu paĝo estas tradukita kun helpo de AI; oficialaj titoloj restas en la angla.