Mettre à jour le contenu avec l’IA

Quatre voies d’accès, un seul ensemble de règles

Toutes les modifications d’admin passent par la même API d’admin, protégée par votre jeton personnel (agent-env:JENKSGUO_ADMIN_TOKEN dans le trousseau). Choisissez ce qui convient au moment :

Interface	Idéal pour
Console sur https://jenksguo.xyz/admin	Parcourir et éditer à la main avec un aperçu en direct
CLI jenks admin …	Modifications rapides depuis un terminal ou un script
Admin MCP (/mcp/admin ou jenks mcp --admin)	Confier le travail à un agent IA tel que Claude Code
REST /api/admin/*	Vos propres automatisations

Chaque écriture est validée par le 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.

Charger le jeton

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

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 committez-le :

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 ; une mauvaise édition ne peut donc jamais casser la build.

Laisser l’IA rédiger le 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 committe.

Modifier plusieurs fichiers dans 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 MCP d’admin 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, committez sur dev avec un message clair, puis montrez-moi le statut du déploiement.

Un agent bien élevé 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 Prévisualiser et promouvoir.
• Des faits uniquement. Le contenu alimente l’assistant Ask Jenks, qui le traite 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.
• Écrire en anglais. Les traductions dans six autres langues sont générées par la CI ; le glossaire dans content/corpus/i18n/glossary.json fige les titres et les noms de lentilles.
• Annuler n’est qu’à un commit. L’historique git conserve chaque version.