你的首次 AI 协助编辑

适用对象

本教程适用于站点唯一管理员 Jenks。你将请站点的模型为某一条经历条目起草修改，审阅差异，将其应用到 dev 分支，检查预览，然后再发布。只有当你推广后，修改才会进入线上站点。

开始之前

你需要 jenks CLI（参见 Connect your agent）以及具有 content 范围的 agent token。在控制台 https://admin.jenksguo.xyz/admin → Access 中创建（参见 Give an AI agent access），然后仅为本次 shell 会话加载它：

export JENKSGUO_ADMIN_TOKEN=jgx_agt_…

切勿将该 token 粘贴到聊天、提交或内容文件中。

步骤 1 — 检查你的访问权限

jenks admin whoami

你应能看到该 token 有效，且已配置 GitHub 发布。如果尚未配置发布，编辑仍可被验证，但无法提交。

步骤 2 — 阅读当前条目

jenks admin get xero-developer-evangelist

这会打印原始源码：YAML 头部信息（title、dates、tags、lenses、metrics、proof）和 Markdown 正文（Overview、What Jenks did、Achievements、Why it matters to employers）。在更改前先阅读它 —— 你将据此审阅 AI 的草稿差异。

步骤 3 — 向 AI 请求草稿，目标为 dev

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

站点的模型会重写文件并返回三部分内容：

• 提议的内容，
• 与当前文件的差异（diff），
• 来自与构建相同模式的验证问题（如有）。

此时尚未提交任何内容。

步骤 4 — 审阅差异

逐行检查：

• 每一条事实仍与真实情况一致。AI 不得添加数字、日期或主张。
• 官方职位名称未被更改。
• 标签（tags）与镜头（lenses）仍然有效（验证器会标记未知项）。

如果草稿有误，可使用更清晰的指令重新运行 ai-edit，或自行编辑文件并使用 jenks admin put。

步骤 5 — 将其应用到 dev

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

--apply 会再次验证该提议并将其提交到 dev 分支。

步骤 6 — 关注流水线

jenks admin deploys

CI 会将变更的条目重新翻译为其他六种语言，重建站点并部署 dev 分支。通常需要几分钟。

步骤 7 — 检查预览

打开 https://dev.jenksguo.xyz/career/xero-developer-evangelist 以及一个翻译版本，例如 https://dev.jenksguo.xyz/zh/career/xero-developer-evangelist。开发站点不会被搜索引擎收录。

步骤 8 — 发布

jenks admin promote

这会将 dev 合并到 main；随后 CI 会部署线上站点（jenksguo.pages.dev 和 jenksguo.xyz 会同时更新）。

你学到了什么

• AI 起草，你来决定：ai-edit 在没有 --apply 时绝不会提交。
• 相同的验证器保护 CLI、REST API、MCP 和 /admin 控制台。
• 翻译会自动跟进，git 历史保留每个版本，因此任何更改都可撤销。

下一步：Update content with AI 涵盖多文件更改和其他编辑方式。