Ĝisdatigu enhavon per AI

Kvar manieroj enen, unu aro da reguloj

Ĉiuj administraj redaktoj trapasas la saman administran API, protektatan de via persona ĵetono (agent-env:JENKSGUO_ADMIN_TOKEN en la Keychain). Elektu tion, kio plej taŭgas nun:

Interfaco	Plej taŭga por
Konzolo ĉe https://jenksguo.xyz/admin	Foliumi kaj permane redakti kun viva antaŭrigardo
CLI jenks admin …	Rapidaj redaktoj el terminalo aŭ skripto
Admin MCP (/mcp/admin aŭ jenks mcp --admin)	Lasi ke AI-agento kiel Claude Code faru la laboron
REST /api/admin/*	Viaj propraj aŭtomatigoj

Ĉiu skribo estas validigita kontraŭ la enhavskemo kaj komitita al git. CI poste retradukas ŝanĝitajn erojn al ĉiuj lingvoj, rekonstruas kaj deplojas.

Ŝargi la ĵetonon

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

Legu antaŭ ol skribi

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 komitu ĝ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 povas rompi la konstruon.

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 voko redonas la proponon, diff kaj ajnajn validigajn problemojn. La dua komitas ĝin.

Ŝ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 administra MCP-servilo konektita, instrukciu la agenton simple, ekzemple:

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

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

Reguloj kiuj valoras konservi

• Uzu dev por io ajn nebagatela, kontrolu https://dev.jenksguo.xyz, poste antaŭenigu. Vidu Antaŭrigardu kaj antaŭenigu.
• Nur faktojn. Enhavo nutras la asistanton Ask Jenks, kiu traktas ĝin kiel veran. 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 al la ses aliaj lingvoj generas CI; la glosaro en content/corpus/i18n/glossary.json fiksas titolojn kaj lens-nomojn.
• Malfari estas je unu komito. La historio de git konservas ĉiun version.