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
devpor ĉio nebagatela, kontroluhttps://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.jsonfiksas 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.