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, protegida por tu token personal (agent-env:JENKSGUO_ADMIN_TOKEN en el Llavero). Elige lo que mejor se ajuste al momento:

Interfaz	Ideal para
Consola en https://jenksguo.xyz/admin	Navegar y editar a mano con vista previa en vivo
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 vuelve a traducir las entradas cambiadas a todos los idiomas, recompila y despliega.

Carga el token

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

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 falla la validación es rechazada, de modo que una mala edición 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 confirma.

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ídala, haz commit a dev con un mensaje claro y luego 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 vale la pena mantener

• Usa dev para cualquier cosa no trivial, revisa https://dev.jenksguo.xyz y luego promueve. Consulta Preview and promote.
• Solo hechos. El contenido alimenta al asistente Ask Jenks, que lo trata como verdadero. No dejes que una IA agregue cifras, títulos o afirmaciones que no puedas respaldar.
• Nunca pongas secretos en el contenido: nada de tokens, números de teléfono, domicilios ni datos de referencias. Todo 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 todas las versiones.