使用 AI 更新內容

四種入口，一套規則

所有管理端編輯都透過同一個管理 API，並以你的個人權杖保護（Keychain 中的 agent-env:JENKSGUO_ADMIN_TOKEN）。依情況選擇最合適的介面：

介面	最適合
Console at https://jenksguo.xyz/admin	以即時預覽手動瀏覽與編輯
CLI jenks admin …	從終端機或腳本快速編輯
Admin MCP (/mcp/admin or jenks mcp --admin)	讓 AI 代理（如 Claude Code）代為處理
REST /api/admin/*	自行建立自動化流程

每一次寫入都會依內容綱要驗證並提交至 git。CI 隨後會將變更的項目重新翻譯為所有語言、重建並部署。

載入權杖

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

寫入前先讀取

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）或搭配 JSON 檔的 jenks admin commit：

{
  "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，再推升。參見 Preview and promote。
• 僅寫事實。內容會提供給 Ask Jenks 助理，且被視為真實。不要讓 AI 加入無法佐證的數字、頭銜或主張。
• 絕不要在內容中放入機密——包含權杖、電話號碼、住家地址或推薦人資料。content/ 底下的一切皆為公開。
• 請以英文撰寫。其餘六種語言由 CI 自動翻譯；content/corpus/i18n/glossary.json 的詞彙表會固定標題與鏡頭名稱。
• 復原僅需一次提交。Git 歷史會保存每個版本。