Votre première modification assistée par IA

À qui s’adresse ce guide

Ce tutoriel est destiné à Jenks, l’unique administrateur du site. Vous demanderez au modèle du site de rédiger un brouillon de modification d’une expérience, passerez en revue le diff, l’appliquerez sur la branche dev, vérifierez l’aperçu, puis le publierez. Rien n’atteint jenksguo.xyz tant que vous ne le promouvez pas.

Avant de commencer

Vous avez besoin du CLI jenks (voir Connect your agent) et de votre jeton admin. Le jeton est stocké dans le trousseau macOS sous agent-env:JENKSGUO_ADMIN_TOKEN. Chargez-le dans votre shell pour cette session uniquement :

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

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

Étape 1 — vérifier vos 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 enregistrées par commit.

Étape 2 — lire l’entrée actuelle

jenks admin get xero-developer-evangelist

Cela affiche la source brute : le frontmatter YAML (title, dates, tags, lenses, metrics, proof) et le corps Markdown (Aperçu, Ce que Jenks a fait, Réalisations, Pourquoi cela compte pour les employeurs). Lisez-le avant de le modifier — vous comparerez le brouillon de l’IA avec ce contenu.

Étape 3 — demander 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 validé.

Étape 4 — examiner le diff

Vérifiez, ligne par ligne :

• Chaque fait correspond toujours à la réalité. L’IA ne doit pas ajouter de nombres, de dates ou d’affirmations.
• Les intitulés de poste officiels sont inchangés.
• Les tags et 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 — l’appliquer à 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 sur la branche dev.

Étape 6 — surveiller le pipeline

jenks admin deploys

Le 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érifier l’aperçu

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

Étape 8 — publier

jenks admin promote

Cela fusionne dev dans main ; le CI déploie ensuite jenksguo.xyz.

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, la REST API, 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 : Mettre à jour du contenu avec l’IA couvre les modifications multi-fichiers et les autres façons d’éditer.