你的第一個 AI 輔助編輯

適用對象

本教學針對本站唯一的管理員 Jenks。你將請求站點的模型為其中一則經歷條目起草修改，檢視差異，將其套用到 dev 分支，檢查預覽，然後發布。只有在你推升之後，變更才會上線。

開始前準備

你需要 jenks CLI（見 連線你的代理），以及一個具備 content 權限範圍的代理 Token。請在主控台 https://admin.jenksguo.xyz/admin → Access 建立（見 賦予 AI 代理存取權），然後只在本次 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

站點的模型會改寫檔案，並回傳三項內容：

• 提議的內容，
• 與當前檔案的差異，
• 依據與建置相同綱要所產生的驗證問題（若有）。

此時尚未有任何提交。

步驟 4 — 審閱差異

逐行檢查：

• 每個事實仍與真實情況相符。AI 不得新增數字、日期或主張。
• 官方職稱未被更動。
• 標籤與 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 歷史保留每個版本，任何變更都能復原。

下一步：使用 AI 更新內容 涵蓋多檔變更與其他編輯方式。