Actualizar contenido con IA

Cuatro vías de entrada, un solo conjunto de reglas

Todas las ediciones de administración pasan por la misma API de administración. Las personas inician sesión en la consola con Google (Cloudflare Access); los agentes y scripts usan un token de servicio que creas en la consola — consulta Give an AI agent access. Elige lo que encaje en el momento:

Interfaz	Ideal para
Consola en https://admin.jenksguo.xyz/admin	Edición manual: un editor visual con campos de formulario, una biblioteca multimedia, un diff de tus cambios y una vista previa
CLI jenks admin …	Ediciones rápidas desde una terminal o un script
Admin MCP (/mcp/admin o jenks mcp --admin)	Dejar que un agente de IA como Claude Code haga el trabajo
REST /api/admin/*	Tus propias automatizaciones

Cada escritura se valida contra el esquema de contenido y se hace commit a git. Luego, CI retraduce las entradas cambiadas a todos los idiomas, recompila y despliega. Para escribir tú mismo en otro idioma — una traducción o el texto de la interfaz — consulta Edit the site in any language.

Cargar el token

Usa un token de agente (jgx_agt_…) con el alcance content, más publish si puede escribir directamente en el sitio en vivo:

export JENKSGUO_ADMIN_TOKEN=jgx_agt_…   # from your Keychain or password manager
jenks admin whoami                      # shows the token's name, scopes and expiry

Lee antes de escribir

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

Valida y luego escribe

Edita el archivo localmente, valídalo y luego haz commit:

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

Una escritura que falle la validación se rechaza, así que una edición incorrecta nunca puede romper la build.

Deja que la IA lo redacte

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

La primera llamada devuelve la propuesta, un diff y cualquier problema de validación. La segunda la hace commit.

Cambia varios archivos en un solo commit

Usa admin_commit_changes (MCP) o jenks admin commit con un archivo 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

Para eliminar un archivo, usa { "path": "…", "delete": true }.

Pedirle a un agente que lo haga

Con el servidor de Admin MCP conectado, instruye al agente claramente, por ejemplo:

Lee el esquema. Actualiza la entrada de Virginia Park Childcare para que el período diga 2019 — 2024. Valídalo, haz commit a dev con un mensaje claro y después muéstrame el estado del despliegue.

Un agente bien comportado llamará a admin_schema, admin_read_file, admin_validate, admin_write_file y admin_deploy_status, en ese orden.

Reglas que conviene mantener

• Usa dev para cualquier cosa no trivial, revisa https://dev.jenksguo.xyz y luego promociona. Consulta Preview and promote.
• Solo hechos. El contenido alimenta al asistente Ask Jenks, que lo trata como verdadero. No dejes que una IA agregue números, títulos o afirmaciones que no puedas respaldar.
• Nunca pongas secretos en el contenido — nada de tokens, números de teléfono, direcciones particulares ni datos de referentes. Todo lo que está bajo content/ es público.
• Escribe en inglés. Las traducciones a los otros seis idiomas las genera CI; el glosario en content/corpus/i18n/glossary.json fija encabezados y nombres de lentes.
• Deshacer está a un commit de distancia. El historial de git conserva cada versión.