Mettre à jour le contenu avec l’IA

Quatre voies d’entrée, un seul ensemble de règles

Toutes les modifications d’administration passent par la même API d’administration. Les personnes se connectent à la console avec Google (Cloudflare Access) ; les agents et scripts utilisent un jeton de service que vous créez dans la console — voir Give an AI agent access. Choisissez ce qui convient au moment :

Interface	Idéal pour
Console at https://admin.jenksguo.xyz/admin	Édition manuelle : un éditeur visuel avec des champs de formulaire, une médiathèque, un diff de vos modifications et un aperçu
CLI jenks admin …	Modifications rapides depuis un terminal ou un script
Admin MCP (/mcp/admin or jenks mcp --admin)	Laisser un agent IA tel que Claude Code faire le travail
REST /api/admin/*	Vos propres automatisations

Chaque écriture est validée par rapport au schéma de contenu et commitée dans git. La CI retraduit ensuite les entrées modifiées dans toutes les langues, reconstruit et déploie. Pour écrire vous‑même dans une autre langue — une traduction ou le texte d’interface — voir Edit the site in any language.

Charger le jeton

Utilisez un jeton d’agent (jgx_agt_…) avec la portée content, plus publish s’il peut écrire directement sur le site en production :

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

Lire avant d’écrire

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

Valider, puis écrire

Modifiez le fichier en local, validez‑le, puis effectuez le commit :

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

Une écriture qui échoue à la validation est refusée, donc une mauvaise modification ne peut jamais casser la build.

Laisser l’IA en faire un brouillon

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

Le premier appel renvoie la proposition, un diff et les éventuels problèmes de validation. Le second la commit.

Modifier plusieurs fichiers en un seul commit

Utilisez admin_commit_changes (MCP) ou jenks admin commit avec un fichier JSON :

{
  "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

Pour supprimer un fichier, utilisez { "path": "…", "delete": true }.

Demander à un agent de le faire

Avec le serveur admin MCP connecté, donnez des instructions claires à l’agent, par exemple :

Lisez le schéma. Mettez à jour l’entrée Virginia Park Childcare pour que la période indique 2019 — 2024. Validez‑la, faites un commit sur dev avec un message clair, puis montrez‑moi le statut du déploiement.

Un agent bien conçu appellera admin_schema, admin_read_file, admin_validate, admin_write_file et admin_deploy_status, dans cet ordre.

Règles à respecter

• Utilisez dev pour tout ce qui n’est pas trivial, vérifiez https://dev.jenksguo.xyz, puis promouvez. Voir Preview and promote.
• Des faits, uniquement. Le contenu alimente l’assistant Ask Jenks, qui le considère comme vrai. Ne laissez pas une IA ajouter des chiffres, des titres ou des affirmations que vous ne pouvez pas étayer.
• Ne mettez jamais de secrets dans le contenu — pas de jetons, numéros de téléphone, adresses personnelles ni coordonnées de référents. Tout ce qui se trouve sous content/ est public.
• Écrivez en anglais. Les traductions vers les six autres langues sont générées par la CI ; le glossaire dans content/corpus/i18n/glossary.json fixe les titres et les noms de lentilles.
• L’annulation n’est qu’à un commit. L’historique Git conserve chaque version.