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-editneniam commitas sen--apply. - La sama validigilo protektas la CLI, la REST API, MCP kaj la
/adminkonzolon. - 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.