你的第一个 AI 辅助编辑

适用人群

本教程适用于 Jenks（本站唯一管理员）。你将让站点的模型为某一条经历条目起草修改，查看差异，对其应用到 dev 分支，检查预览，然后发布上线。在你提升之前，任何内容都不会进入 jenksguo.xyz。

开始之前

你需要 jenks CLI（参见 Connect your agent）以及你的管理员令牌。该令牌以 agent-env:JENKSGUO_ADMIN_TOKEN 保存在 macOS 钥匙串中。仅为本次会话将其加载到你的 shell：

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

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

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

jenks admin whoami

你应能看到令牌有效，且已配置 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 — 审阅 diff

逐行检查：

• 每个事实仍与真实情况一致。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.xyz。

你学到了什么

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

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