使用 AI 更新內容

四種入口，同一套規則

所有管理端編輯都會經過同一個管理 API。人員透過 Google（Cloudflare Access）登入主控台；代理與指令碼則使用你在主控台建立的服務權杖——請參閱 為 AI 代理授權。依情境選擇適合的介面：

介面	最適用於
Console at https://admin.jenksguo.xyz/admin	手動編輯：具有表單欄位、媒體庫、變更差異與預覽的視覺化編輯器
CLI jenks admin …	從終端機或指令碼快速編輯
Admin MCP (/mcp/admin or jenks mcp --admin)	讓 AI 代理（例如 Claude Code）代勞
REST /api/admin/*	你自有的自動化流程

每次寫入都會依內容綱要驗證並提交至 git。CI 會將變更條目重新翻譯為所有語言，然後重建與部署。若你要自行以其他語言撰寫——無論是翻譯或介面文字——請見以任意語言編輯網站。

載入權杖

使用具有 content 權限範圍的代理權杖（jgx_agt_…），若可直接寫入正式站，請另外加入 publish：

export JENKSGUO_ADMIN_TOKEN=jgx_agt_…   # from your Keychain or password manager
jenks admin whoami                      # shows the token's name, scopes and expiry

寫入前先讀取

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

先驗證，再寫入

在本機編輯檔案、驗證，然後提交：

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

未通過驗證的寫入會被拒絕，因此錯誤的編輯不會破壞建置。

讓 AI 起草內容

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

第一次呼叫會回傳提案、差異與任何驗證問題；第二次則會提交變更。

在一次提交中變更多個檔案

使用 admin_commit_changes（MCP）或 jenks admin commit 搭配一個 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

若要移除檔案，使用 { "path": "…", "delete": true }。

請代理執行

連線到管理 MCP 伺服器後，清楚指示代理，例如：

讀取綱要。更新 Virginia Park Childcare 條目，將期間改為 2019 — 2024。驗證後， 以清楚的訊息提交到 dev，接著給我部署狀態。

表現良好的代理會依序呼叫 admin_schema、admin_read_file、admin_validate、 admin_write_file 和 admin_deploy_status。

值得遵守的規則

• 使用 dev 處理任何非瑣碎變更，檢查 https://dev.jenksguo.xyz 後再升推。請見 預覽與升推。
• 僅寫事實。內容會供 Ask Jenks 助理使用，並被視為真實。請勿讓 AI 加入你無法佐證的數字、頭銜或主張。
• 絕對不要在內容中放入機密——例如權杖、電話號碼、住家地址或推薦人資料。 content/ 底下的一切都是公開的。
• 請以英文撰寫。其餘六種語言的翻譯由 CI 產生；content/corpus/i18n/glossary.json 中的用語表固定標題與 lens 名稱。
• 還原只差一次提交。Git 歷史會保留每個版本。