Skip to main content
Jenks Guo

Dokumentaro / how to

Ĝisdatigu enhavon per AI

Por Jenks — ŝanĝu retejan enhavon per la admin konzolo, CLI, REST API aŭ admin MCP, kun validigo, pluraj dosieroj per unu komito kaj dev-antaŭrigardoj.

Kvar enirejoj, unu aro da reguloj

Ĉiuj admin-eldonoj pasas tra la sama admin API. Homoj ensalutas al la konzolo per Google (Cloudflare Access); agentoj kaj skriptoj uzas servĵetonon, kiun vi kreas en la konzolo — vidu Donu al AI-agento aliron. Elektu kio plej taŭgas al la momento:

Interfaco Plej taŭga por
Console at https://admin.jenksguo.xyz/admin Mana redaktado: vida redaktilo kun formularaj kampoj, amaskomunikila biblioteko, diferenco de viaj ŝanĝoj kaj antaŭrigardo
CLI jenks admin … Rapidaj redaktoj el terminalo aŭ skripto
Admin MCP (/mcp/admin aŭ jenks mcp --admin) Permesi al AI-agento, ekzemple Claude Code, fari la laboron
REST /api/admin/* Viaj propraj aŭtomatigoj

Ĉiu skribo estas validigita kontraŭ la enhava skemo kaj enkomitita al git. CI poste reretras ŝanĝitajn enskribojn en ĉiujn lingvojn, rekonstrui kaj deplojigi. Por verki alian lingvon mem — tradukon aŭ la interfacan tekston — vidu Redaktu la retejon en iu ajn lingvo.

Ŝargi la ĵetonon

Uzu agentan ĵetonon (jgx_agt_…) kun la amplekso content, plus publish se ĝi rajtas skribi rekte al la viva retejo:

export JENKSGUO_ADMIN_TOKEN=jgx_agt_…   # from your Keychain or password manager
jenks admin whoami                      # shows the token's name, scopes and expiry

Legu antaŭ ol vi skribas

jenks admin schema                         # fields, tags, lenses, writable paths
jenks admin ls content/corpus/experiences  # files and their sha
jenks admin get linktree-partner-solutions-lead

Validigu, poste skribu

Redaktu la dosieron loke, validigu ĝin, poste enkomitu ĝin:

jenks admin get linktree-partner-solutions-lead > linktree.md
# …edit linktree.md…
jenks admin validate content/corpus/experiences/linktree-partner-solutions-lead.md linktree.md
jenks admin put content/corpus/experiences/linktree-partner-solutions-lead.md linktree.md \
  -m "Linktree: add developer portal launch detail" --branch dev

Skribo kiu malsukcesas validigon estas rifuzita, do malbona redakto neniam povos rompi la konstruprocezon.

Lasu la AI skizi ĝin

jenks admin ai-edit tooronga-toastmasters "correct the period to 2019 — 2021" --branch dev
jenks admin ai-edit tooronga-toastmasters "correct the period to 2019 — 2021" --branch dev --apply

La unua alvoko redonas la proponon, diferencon kaj eventualajn validigproblemojn. La dua ĝin komitas.

Ŝanĝu plurajn dosierojn en unu komito

Uzu admin_commit_changes (MCP) aŭ jenks admin commit kun JSON-dosiero:

{
  "changes": [
    { "path": "content/corpus/community/murrumbeena-school-council.md", "content": "---\n…" },
    { "path": "content/corpus/capabilities.md", "content": "…" }
  ]
}
jenks admin commit changes.json -m "School council: confirm dates" --branch dev

Por forigi dosieron, uzu { "path": "…", "delete": true }.

Peti agenton fari tion

Kun la admin MCP-servilo konektita, instrukciu la agenton klare, ekzemple:

Legu la skemon. Ĝisdatigu la enskribon Virginia Park Childcare tiel ke la periodo estu 2019 — 2024. Validigu ĝin, enkomitu al dev kun klara mesaĝo, poste montru al mi la deploja staton.

Bone konduta agento vokos admin_schema, admin_read_file, admin_validate, admin_write_file kaj admin_deploy_status, en tiu ordo.

Reguloj indaj je observado

  • Uzu dev por ĉio nebagatela, kontrolu https://dev.jenksguo.xyz, poste promociu. Vidu Antaŭrigardi kaj promocii.
  • Nur faktoj. Enhavo nutras la Ask Jenks asistanton, kiu traktas ĝin kiel veron. Ne lasu AI aldoni nombrojn, titolojn aŭ asertojn, kiujn vi ne povas subteni.
  • Neniam metu sekretojn en enhavon — neniuj ĵetonoj, telefonnumeroj, hejmaj adresoj aŭ referencaj detaloj. Ĉio sub content/ estas publika.
  • Skribu en la angla. Tradukojn en la aliajn ses lingvojn generas CI; la glosaro en content/corpus/i18n/glossary.json fiksas titolojn kaj lens-nomojn.
  • Malfari estas je unu komito for. Git-historio konservas ĉiun version.

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