你的第一次 AI 協助編輯

適用對象

本教學適用於本網站唯一的管理者 Jenks。你將要求網站的模型為某一則經歷條目擬稿、審閱差異、將其套用到 dev 分支、檢查預覽，然後發佈。只有在你推送之後，內容才會到達 jenksguo.xyz。

開始之前

你需要 jenks CLI（見 Connect your agent）以及你的管理員權杖。此權杖儲存在 macOS 鑰匙圈中，名稱為 agent-env:JENKSGUO_ADMIN_TOKEN。僅將其載入本次 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

網站的模型會重寫檔案並回傳三項內容：

• 「擬議內容」（proposed content），
• 與目前檔案的「差異」（diff），
• 由與建置相同綱要執行的「驗證問題」（validation problems）（若有）。

此時尚未提交任何變更。

步驟 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.xyz。

你學到了什麼

• AI 起稿、你作主：ai-edit 未加上 --apply 絕不提交。
• 相同的驗證器保護 CLI、REST API、MCP 與 /admin 主控台。
• 翻譯會自動跟進，git 歷史保留每個版本，因此任何變更都能復原。

下一步：Update content with AI 涵蓋多檔案變更與其他編輯方式。