Tu primera edición asistida por IA

Para quién es esto

Este tutorial es para Jenks, el único admin 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 a jenksguo.xyz hasta que lo promociones.

Antes de comenzar

Necesitas la CLI jenks (consulta Connect your agent) y tu token de admin. El token vive en el Llavero de macOS como agent-env:JENKSGUO_ADMIN_TOKEN. Cárgalo en tu shell solo para esta sesión:

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

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 a GitHub está configurada. Si la publicación no está configurada, las ediciones aún se pueden validar pero no comprometer.

Paso 2 — lee la entrada actual

jenks admin get xero-developer-evangelist

Esto imprime la fuente sin procesar: frontmatter YAML (title, dates, tags, lenses, metrics, proof) y el cuerpo en Markdown (Overview, What Jenks did, Achievements, Why it matters to employers). Léelo antes de cambiarlo: revisarás el borrador de la IA contra ello.

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 compilación.

Aún no se ha hecho ningún commit.

Paso 4 — revisa el diff

Comprueba, línea por línea:

• Que cada hecho siga coincidiendo con la realidad. 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 marcará las desconocidas).

Si el borrador es incorrecto, ejecuta ai-edit otra vez 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 la propuesta de nuevo y la hace commit en la rama dev.

Paso 6 — observa el pipeline

jenks admin deploys

CI retraduce la entrada modificada a los otros seis idiomas, reconstruye el sitio y despliega la rama dev. Esto suele tardar unos minutos.

Paso 7 — comprueba 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 los motores de búsqueda.

Paso 8 — publica

jenks admin promote

Esto hace merge de dev en main; luego CI despliega jenksguo.xyz.

Lo que aprendiste

• La IA redacta; tú decides: ai-edit nunca hace commit 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 se puede deshacer.

Siguiente: Actualizar contenido con IA cubre cambios en varios archivos y las otras formas de editar.