Votre première modification assistée par IA

À qui s’adresse ce guide

Ce tutoriel est destiné à Jenks, l’unique administrateur du site. Vous allez demander au modèle du site de rédiger une proposition de modification pour une entrée d’expérience, examiner le diff, l’appliquer sur la branche dev, vérifier l’aperçu puis la publier. Rien n’atteint le site en ligne tant que vous ne le promouvez pas.

Avant de commencer

Vous avez besoin du CLI jenks (voir Connect your agent) et d’un jeton d’agent avec le périmètre content. Créez-en un dans la console à https://admin.jenksguo.xyz/admin → Access (voir Give an AI agent access), puis chargez-le dans votre shell pour cette session uniquement :

export JENKSGUO_ADMIN_TOKEN=jgx_agt_…

Ne collez jamais le jeton dans un chat, un commit ou un fichier de contenu.

Étape 1 — vérifiez votre accès

jenks admin whoami

Vous devriez voir que le jeton est valide et que la publication GitHub est configurée. Si la publication n’est pas configurée, les modifications peuvent toujours être validées mais pas commit.

Étape 2 — lisez l’entrée actuelle

jenks admin get xero-developer-evangelist

Cela affiche la source brute : frontmatter YAML (title, dates, tags, lenses, metrics, proof) et corps Markdown (Overview, What Jenks did, Achievements, Why it matters to employers). Lisez-le avant de le modifier — vous comparerez le brouillon de l’IA avec celui-ci.

Étape 3 — demandez un brouillon à l’IA, sur dev

jenks admin ai-edit xero-developer-evangelist \
  "tighten the summary to under 30 words without changing any facts" \
  --branch dev

Le modèle du site réécrit le fichier et renvoie trois éléments :

• le contenu proposé,
• un diff par rapport au fichier actuel,
• les problèmes de validation, le cas échéant, issus du même schéma que celui utilisé par le build.

Rien n’est encore commit.

Étape 4 — passez en revue le diff

Vérifiez, ligne par ligne :

• Chaque fait correspond toujours à la réalité. L’IA ne doit pas ajouter de chiffres, de dates ou d’affirmations.
• Les intitulés de poste officiels sont inchangés.
• Les tags et les lenses sont toujours valides (le validateur signalera ceux inconnus).

Si le brouillon est incorrect, relancez ai-edit avec une instruction plus claire, ou modifiez vous-même le fichier et utilisez jenks admin put.

Étape 5 — appliquez-le sur dev

jenks admin ai-edit xero-developer-evangelist \
  "tighten the summary to under 30 words without changing any facts" \
  --branch dev --apply

--apply valide à nouveau la proposition et la commit dans la branche dev.

Étape 6 — surveillez le pipeline

jenks admin deploys

La CI retraduit l’entrée modifiée dans les six autres langues, reconstruit le site et déploie la branche dev. Cela prend généralement quelques minutes.

Étape 7 — vérifiez l’aperçu

Ouvrez https://dev.jenksguo.xyz/career/xero-developer-evangelist ainsi qu’une version traduite comme https://dev.jenksguo.xyz/zh/career/xero-developer-evangelist. Le site de dev n’est pas indexé par les moteurs de recherche.

Étape 8 — publiez

jenks admin promote

Cela fusionne dev dans main ; la CI déploie ensuite le site en ligne (jenksguo.pages.dev et jenksguo.xyz se mettent à jour ensemble).

Ce que vous avez appris

• L’IA rédige, vous décidez : ai-edit ne commit jamais sans --apply.
• Le même validateur protège le CLI, l’API REST, MCP et la console /admin.
• Les traductions suivent automatiquement, et l’historique git conserve chaque version, de sorte que toute modification peut être annulée.

Ensuite : Update content with AI couvre les modifications multi-fichiers et les autres moyens d’éditer.