Tu primera edición asistida por IA

Para quién es esto

Este tutorial es para Jenks, el único administrador del sitio. Le pedirás al modelo del sitio que redacte un cambio en una entrada de experiencia, revisarás el diff, lo aplicarás a la rama dev, comprobarás la vista previa y luego lo publicarás. Nada llega al sitio en vivo hasta que lo promociones.

Antes de empezar

Necesitas la CLI jenks (consulta Connect your agent) y un token de agente con el alcance content. Créalo en la consola en https://admin.jenksguo.xyz/admin → Access (consulta Give an AI agent access), luego cárgalo en tu shell solo para esta sesión:

export JENKSGUO_ADMIN_TOKEN=jgx_agt_…

Nunca pegues el token en un chat, un commit o un archivo de contenido.

Paso 1 — verifica tu acceso

jenks admin whoami

Deberías ver que el token es válido y que la publicación en GitHub está configurada. Si la publicación no está configurada, las ediciones pueden validarse pero no confirmarse.

Paso 2 — lee la entrada actual

jenks admin get xero-developer-evangelist

Esto imprime la fuente en bruto: frontmatter YAML (title, dates, tags, lenses, metrics, proof) y el cuerpo en Markdown (Overview, What Jenks did, Achievements, Why it matters to employers). Lée-lo antes de cambiarlo: revisarás el borrador de la IA frente a él.

Paso 3 — pídele a la IA un borrador, en dev

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

El modelo del sitio reescribe el archivo y devuelve tres cosas:

• el contenido propuesto,
• un diff respecto al archivo actual,
• problemas de validación, si los hay, del mismo esquema que usa la build.

Aún no se ha confirmado nada.

Paso 4 — revisa el diff

Comprueba, línea por línea:

• Cada hecho sigue coincidiendo con la verdad. La IA no debe añadir números, fechas ni afirmaciones.
• Los títulos oficiales de los puestos no han cambiado.
• Las tags y lenses siguen siendo válidas (el validador señalará las desconocidas).

Si el borrador es incorrecto, ejecuta ai-edit de nuevo con una instrucción más clara, o edita el archivo tú mismo y usa jenks admin put.

Paso 5 — aplícalo a dev

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

--apply valida de nuevo la propuesta y la confirma en la rama dev.

Paso 6 — observa el pipeline

jenks admin deploys

CI retraduce la entrada cambiada a los otros seis idiomas, reconstruye el sitio e implementa la rama dev. Esto suele tardar unos minutos.

Paso 7 — verifica la vista previa

Abre https://dev.jenksguo.xyz/career/xero-developer-evangelist y una versión traducida como https://dev.jenksguo.xyz/zh/career/xero-developer-evangelist. El sitio de dev no está indexado por motores de búsqueda.

Paso 8 — publica

jenks admin promote

Esto fusiona dev en main; luego CI implementa el sitio en vivo (jenksguo.pages.dev y jenksguo.xyz se actualizan a la vez).

Lo que aprendiste

• La IA redacta, tú decides: ai-edit nunca confirma sin --apply.
• El mismo validador protege la CLI, la REST API, MCP y la consola /admin.
• Las traducciones siguen automáticamente, y el historial de git conserva cada versión, por lo que cualquier cambio puede revertirse.

Siguiente: Update content with AI cubre cambios en múltiples archivos y otras formas de editar.